oci_set_client_info
(PHP 5 >= 5.3.2, PHP 7, PHP 8, PECL OCI8 >= 1.4.0)
oci_set_client_info — 클라이언트 정보를 설정합니다.
설명
oci_set_client_info(resource $connection, string $client_info): bool
Oracle 추적을 위한 클라이언트 정보를 설정합니다.
클라이언트 정보는 PHP에서 데이터베이스로 다음 '왕복'이 발생할 때(일반적으로 SQL 문이 실행될 때) 데이터베이스에 등록됩니다.
이후에 V$SESSION과 같은 데이터베이스 관리 보기에서 클라이언트 정보를 쿼리할 수 있습니다.
값은 영구 연결을 통해 유지될 수 있습니다.
매개변수
connection- oci_connect(), oci_pconnect() 또는 oci_new_connect()가 반환하는 Oracle 연결 식별자입니다.
client_info- 사용자가 최대 64바이트 길이의 문자열을 선택했습니다.
반환 값
성공하면 true를, 실패하면 false를 반환합니다.
Examples
예제 #1 클라이언트 정보 설정
<?php
$c = oci_connect('hr', 'welcome', 'localhost/XE');
// Record the client information
oci_set_client_info($c, 'My Application Version 2');
// 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 client
// information:
sqlplus system/welcome
SQL> select client_info 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_action() - 작업 이름을 설정합니다.
- oci_set_client_identifier() - 클라이언트 식별자를 설정합니다.
- oci_set_db_operation() - 데이터베이스 작업을 설정합니다.