oci_set_client_identifier
(PHP 5.3.2, PECL OCI8 >= 1.4.0)
oci_set_client_identifier — Sets the client identifier
説明
Sets the client identifier used by various database components to identify lightweight application users who authenticate as the same database user.
The client identifier is registered with the database when the next 'roundtrip' from PHP to the database occurs, typically when a SQL statement is executed.
The identifier can subsequently be queried from database administration views such as V$SESSION. It can be used with DBMS_MONITOR.CLIENT_ID_TRACE_ENABLE for tracing. It can be used for auditing.
The value may be retained across persistent connections.
パラメータ
- connection
-
oci_connect()、oci_pconnect() あるいは oci_new_connect() が返す Oracle 接続 ID。
- client_identifier
-
User chosen string up to 64 bytes long.
返り値
成功した場合に TRUE を、失敗した場合に FALSE を返します。
例
例1 Setting the client identifier to the application user
...
<?php
session_start();
$un = my_validate_session($_SESSION['username']);
$c = oci_connect('myschema', 'welcome', 'localhost/XE');
oci_set_client_identifier($c, $un);
$s = oci_parse($c, 'select mydata from mytable');
?>
...
注意
データベースとのやりとりに関するメモ
OCI8 関数の中には、データベースとのやりとりを伴わないものもあります。 たとえば、結果のキャッシングが有効になっている場合、 クエリを実行してもデータベースとのやりとりを行わない可能性があります。
参考
- oci_set_module_name() - Sets the module name
- oci_set_action() - Sets the action name
- oci_set_client_info() - Sets the client information
oci_set_client_identifier
