« oci\_set\_editionoci\_set\_prefetch\_lob »PHP ManualOCI8 Функції

oci_set_module_name

(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, наприклад коли запускається SQL вираз.

Ім'я може бути витягнуте з адміністративних уявлень бази даних, таких як V$SESSION. Воно може використовуватися для трасування та моніторингу також, як V$SQLAREAandDBMS_MONITOR.SERV_MOD_ACT_STAT_ENABLE

Значення можна встановлювати через постійні з'єднання.

Список параметрів

connection

Ідентифікатор з'єднання Oracle, що повертається oci_connect() oci_pconnect(), илиoci_new_connect()

name

Заданий користувачем рядок string довжиною до 48 байт.

Значення, що повертаються

Повертає true у разі успішного виконання або **false**в случае возникновения ошибки.

Приклади

Приклад #1 Встановлення імені модуля

Loading...
// Пока скрипт выполняется, администратор может увидеть, какие модули
// используются:

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

Примітки

Зауваження Вимога до версії Oracle

Ця функція доступна, якщо PHP злінковано з бібліотеками Oracle Database починаючи з версії 10g і вище.

Підказка

Продуктивність

У старих версіях OCI8 або бази даних Oracle можна було встановити інформацію про клієнта за допомогою пакета DBMS_APPLICATION_INFO. Для цієї мети ефективніше використання функції oci_set_client_info()

Застереження

Порада щодо повного сканування таблиці (roundtrip)

Деякі, але не всі функції OCI8 викликають повне сканування таблиці (roundtrip). Повне сканування таблиць немає для тих запитів, у яких включено кешування результатів у базі даних.

Дивіться також