oci_set_action

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

oci_set_action — 작업 이름을 설정합니다.


설명

oci_set_action(resource $connection, string $action): bool

Oracle 추적에 대한 작업 이름을 설정합니다.

액션 이름은 PHP에서 데이터베이스로의 다음 '왕복'이 발생할 때(일반적으로 SQL 문이 실행될 때) 데이터베이스에 등록됩니다.

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


매개변수

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

반환 값

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


Examples

예제 #1 작업 설정

                  
<?php

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

// Record the action
oci_set_action($c, 'Friend Lookup');

// 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 actions
// being performed:

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

노트

메모:Oracle 버전 요구 사항

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

성능

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

주의

Round-trip Gotcha

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


기타