db2_get_option

(PECL ibm_db2 >= 1.6.0)

db2_get_option — Встановлює параметр для ресурсу оператора або ресурсу з'єднання.

Опис

db2_get_option(resource $resource, string $option): string|false

Виймає значення вказаного параметра для ресурсу оператора або з'єднання.

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

resource

Допустимий ресурс оператора, що повертається db2_prepare() або допустимий ресурс з'єднання, що повертається db2_connect() або db2_pconnect()

option

Допустимий оператор або варіанти підключення. Наступні нові параметри доступні в ibm_DB2 версії 1.6.0. Вони надають корисну інформацію для відстеження, яку можна встановити під час виконання за допомогою db2_get_option()

Зауваження :

Попередні версії ibm_db2 не підтримують нові параметри.

Коли встановлюється значення кожної опції, деякі сервери можуть обробляти всю надану довжину і можуть усікати значення.

Щоб забезпечити правильне перетворення даних, зазначених у кожній опції, під час передачі в хост-систему, використовуйте лише символи від A до Z, від 0 до 9, знак підкреслення (_) або точку (.).

userid

SQL_ATTR_INFO_USERID - Вказівник на символьний рядок із завершальним нулем, що використовується для ідентифікації ID користувача клієнта, що надсилається на сервер бази даних хоста під час використання DB2 Connect.

Зауваження :

Сервери DB2 для z/OS та OS/390 підтримують довжину до 16 символів. Ідентифікатор користувача не слід плутати з ідентифікатором користувача для аутентифікації, він використовується тільки для цілей ідентифікації і не використовується для авторизації.

acctstr

SQL_ATTR_INFO_ACCTSTR - Вказівник на символьний рядок із завершальним нулем, що використовується для ідентифікації облікового рядка клієнта, що надсилається на сервер бази даних хоста під час використання DB2 Connect.

Зауваження :

Сервери DB2 для z/OS та OS/390 підтримують довжину до 200 символів.

applname

SQL_ATTR_INFO_APPLNAME - Вказівник на символьний рядок із завершальним нулем, що використовується для ідентифікації імені клієнтської програми, що надсилається на сервер бази даних хоста під час використання DB2 Connect.

Зауваження :

Сервери DB2 для z/OS та OS/390 підтримують довжину до 32 символів.

wrkstnname

SQL_ATTR_INFO_WRKSTNNAME - Вказівник на символьний рядок із завершальним нулем, що використовується для ідентифікації імені клієнтської програми, що надсилається на сервер бази даних хоста під час використання DB2 Connect.

Зауваження :

Сервери DB2 для z/OS та OS/390 підтримують довжину до 18 символів.

У наступній таблиці наведено параметри, сумісні з доступними типами ресурсів:

Матриця параметрів ресурсів

Ключ	Значение	Тип ресурса
		Connection
userid	SQL_ATTR_INFO_USERID	X
acctstr	SQL_ATTR_INFO_ACCTSTR	X
applname	SQL_ATTR_INFO_APPLNAME	X
wrkstnname	SQL_ATTR_INFO_WRKSTNNAME	X

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

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

Приклади

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

Loading...
▶

Результат виконання наведеного прикладу:

Атрибуты клиента, передаваемые через строку подключения
db2inst1
account
myapp
workstation
Атрибуты клиента прошли после подключения:
db2inst1
account
myapp
workstation

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

• db2_connect() - Повертає з'єднання з базою даних
• db2_cursor_type() - Повертає тип курсору, який використовується у ресурсі оператора
• db2_exec() - Виконує SQL-запит безпосередньо
• db2_set_option() - Встановлення опції для з'єднання або ресурсу оператора
• db2_pconnect() - Повертає постійне з'єднання з базою даних
• db2_prepare() - готує SQL-запит до виконання