oci_set_module_name

Oracle OCI8 함수

(PHP 5 >= 5.3.2, PHP 7, PHP 8, PECL OCI8 >= 1.4.0)

oci_set_module_name — 모듈 이름을 설정합니다.


설명

oci_set_module_name(resource $connection, string $name): bool

Oracle 추적을 위한 모듈 이름을 설정합니다.

모듈 이름은 PHP에서 데이터베이스로의 다음 'round-trip'이 발생할 때(일반적으로 SQL 문이 실행될 때) 데이터베이스에 등록됩니다.

이후에 V$SESSION과 같은 데이터베이스 관리 보기에서 이름을 쿼리할 수 있습니다. V$SQLAREA 및 DBMS_MONITOR.SERV_MOD_ACT_STAT_ENABLE과 같은 추적 및 모니터링에 사용할 수 있습니다.

값은 영구 연결을 통해 유지될 수 있습니다.


매개변수
connection
oci_connect(), oci_pconnect() 또는 oci_new_connect()가 반환하는 Oracle 연결 식별자입니다.
name
사용자가 최대 48바이트 길이의 문자열을 선택했습니다.

반환 값

성공하면 true를, 실패하면 false를 반환합니다.


Examples

예제 #1 모듈 이름 설정

                  
<?php

$c = oci_connect('hr', 'welcome', 'localhost/XE');

// Record the module
oci_set_module_name($c, 'Home Page');

// Code that causes a round-trip, for example a query:
$s = oci_parse($c, 'select * from dual');
oci_execute($s);
oci_fetch_all($s, $res);

sleep(30);
?>
                    
                  
// While the script is running, the administrator can see the
// modules in use:

sqlplus system/welcome
SQL> select module from v$session;

노트

메모: Oracle 버전 요구 사항

이 함수는 PHP가 버전 10g부터 Oracle Database 라이브러리와 연결되어 있을 때 사용할 수 있습니다.

팁

Performance

이전 버전의 OCI8 또는 Oracle Database에서는 Oracle DBMS_APPLICATION_INFO 패키지를 사용하여 클라이언트 정보를 설정할 수 있습니다. 이것은 oci_set_client_info()를 사용하는 것보다 덜 효율적입니다.

주 의

Round-trip Gotcha

모든 OCI8 기능이 아닌 일부 기능이 왕복을 유발합니다. 결과 캐싱이 활성화된 경우 쿼리와 함께 데이터베이스에 대한 왕복이 발생하지 않을 수 있습니다.


기타

PHP

웹학교

참조