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$SQLAREA
및 DBMS_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 기능이 아닌 일부 기능이 왕복을 유발합니다. 결과 캐싱이 활성화된 경우 쿼리와 함께 데이터베이스에 대한 왕복이 발생하지 않을 수 있습니다.
기타
- oci_set_module_name() - 모듈 이름을 설정합니다
- oci_set_client_info() - 클라이언트 정보를 설정합니다
- oci_set_client_identifier() - 클라이언트 식별자를 설정합니다.
- oci_set_db_operation() - 데이터베이스 작업을 설정합니다.