閱讀(437) 書(shū)簽贊(0) 我要糾錯(cuò)

PHP8 db2_get_option

2024-04-07 10:23 更新

（PECL ibm_db2 >= 1.6.0）

db2_get_option — 檢索語(yǔ)句資源或連接資源的選項(xiàng)值

說(shuō)明

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

檢索語(yǔ)句資源的指定選項(xiàng)值的值或連接資源。

參數(shù)

resource

從 db2_prepare（）返回的有效語(yǔ)句資源或從（）返回的有效連接資源從 db2_connect（）或 db2_pconnect（）返回。

option

有效的語(yǔ)句或連接選項(xiàng)。提供以下新選項(xiàng) 從ibm_db2版本 1.6.0 開(kāi)始。它們提供有用的跟蹤信息可以在執(zhí)行期間使用 db2_get_option（） 設(shè)置。

注意：
早期版本的 ibm_db2 不支持這些新選項(xiàng)。
設(shè)置每個(gè)選項(xiàng)中的值時(shí)，某些服務(wù)器可能無(wú)法處理提供的整個(gè)長(zhǎng)度，可能會(huì)截?cái)嘣撝怠?/p>
確保正確轉(zhuǎn)換每個(gè)選項(xiàng)中指定的數(shù)據(jù) 傳輸?shù)街鳈C(jī)系統(tǒng)時(shí)，僅使用字符 A 到 Z， 0 到 9，以及下劃線（_）或句點(diǎn) （.）。

userid: SQL_ATTR_INFO_USERID- 指向以 null 結(jié)尾的指針用于標(biāo)識(shí)發(fā)送到主機(jī)的客戶端用戶 ID 的字符串使用 DB2 Connect 時(shí)的數(shù)據(jù)庫(kù)服務(wù)器。
注意：
DB2 for z/OS 和 OS/390 服務(wù)器最多支持 16 個(gè)字符的長(zhǎng)度。此 user-id 不要與身份驗(yàn)證 user-id 混淆，它用于僅用于識(shí)別目的，不用于任何授權(quán)。
acctstr: SQL_ATTR_INFO_ACCTSTR- 指向以 null 結(jié)尾的指針用于標(biāo)識(shí)發(fā)送到使用 DB2 Connect 時(shí)的主機(jī)數(shù)據(jù)庫(kù)服務(wù)器。
注意：
DB2 for z/OS 和 OS/390 服務(wù)器最多支持 200 個(gè)字符的長(zhǎng)度。
applname: SQL_ATTR_INFO_APPLNAME- 指向以 null 結(jié)尾的指針用于標(biāo)識(shí)發(fā)送到使用 DB2 Connect 時(shí)的主機(jī)數(shù)據(jù)庫(kù)服務(wù)器。
注意：
DB2 for z/OS 和 OS/390 服務(wù)器最多支持 32 個(gè)字符的長(zhǎng)度。
wrkstnname: SQL_ATTR_INFO_WRKSTNNAME- 指向以 null 結(jié)尾的指針用于標(biāo)識(shí)發(fā)送到使用 DB2 Connect 時(shí)的主機(jī)數(shù)據(jù)庫(kù)服務(wù)器。
注意：
DB2 for z/OS 和 OS/390 服務(wù)器最多支持 18 個(gè)字符的長(zhǎng)度。

下表指定了與哪些選項(xiàng)兼容可用資源類型：

**資源參數(shù)矩陣**
鑰匙	價(jià)值	資源類型
		連接	陳述	結(jié)果集
烏塞里德	`SQL_ATTR_INFO_USERID`	X	X	-
acctstr	`SQL_ATTR_INFO_ACCTSTR`	X	X	-
ApplName	`SQL_ATTR_INFO_APPLNAME`	X	X	-
wrkstnname	`SQL_ATTR_INFO_WRKSTNNAME`	X	X	-

返回值

返回成功時(shí)提供的連接屬性的當(dāng)前設(shè)置或者在失敗時(shí)返回 false.

示例

示例 #1 通過(guò)連接資源設(shè)置和檢索參數(shù)

<?php
/* Database Connection Parameters */
$database = 'SAMPLE';
$user     = 'db2inst1';
$password = 'ibmdb2';

/* Obtain Connection Resource */
$conn = db2_connect($database, $user, $password);

echo "Client attributes passed through connection string:\n";

/* Create the associative options array with valid key-value pairs */
/* Assign the attributes through connection string */
/* Access the options specified */
$options1 = array('userid' => 'db2inst1');
$conn1 = db2_connect($database, $user, $password, $options1);
$val = db2_get_option($conn1, 'userid');
echo $val . "\n";

$options2 = array('acctstr' => 'account');
$conn2 = db2_connect($database, $user, $password, $options2);
$val = db2_get_option($conn2, 'acctstr');
echo $val . "\n";

$options3 = array('applname' => 'myapp');
$conn3 = db2_connect($database, $user, $password, $options3);
$val = db2_get_option($conn3, 'applname');
echo $val . "\n";

$options4 = array('wrkstnname' => 'workstation');
$conn4 = db2_connect($database, $user, $password, $options4);
$val = db2_get_option($conn4, 'wrkstnname');
echo $val . "\n";

echo "Client attributes passed post-connection:\n";

/* Create the associative options array with valid key-value pairs */
/* Assign the attributes after a connection is made */
/* Access the options specified */
$options5 = array('userid' => 'db2inst1');
$conn5 = db2_connect($database, $user, $password);
$rc = db2_set_option($conn5, $options5, 1);
$val = db2_get_option($conn5, 'userid');
echo $val . "\n";

$options6 = array('acctstr' => 'account');
$conn6 = db2_connect($database, $user, $password);
$rc = db2_set_option($conn6, $options6, 1);
$val = db2_get_option($conn6, 'acctstr');
echo $val . "\n";

$options7 = array('applname' => 'myapp');
$conn7 = db2_connect($database, $user, $password);
$rc = db2_set_option($conn7, $options7, 1);
$val = db2_get_option($conn7, 'applname');
echo $val . "\n";

$options8 = array('wrkstnname' => 'workstation');
$conn8 = db2_connect($database, $user, $password);
$rc = db2_set_option($conn8, $options8, 1);
$val = db2_get_option($conn8, 'wrkstnname');
echo $val . "\n";
?>

以上示例會(huì)輸出：

Client attributes passed through connection string:
db2inst1
account
myapp
workstation
Client attributes passed post-connection:
db2inst1
account
myapp
workstation

參見(jiàn)

db2_connect（） - 返回與數(shù)據(jù)庫(kù)的連接
db2_cursor_type（） - 返回語(yǔ)句資源使用的游標(biāo)類型
db2_exec（） - 直接執(zhí)行 SQL 語(yǔ)句
db2_set_option（） - 設(shè)置連接或語(yǔ)句資源的選項(xiàng)
db2_pconnect（） - 返回與數(shù)據(jù)庫(kù)的持久連接
db2_prepare（） - 準(zhǔn)備要執(zhí)行的 SQL 語(yǔ)句

以上內(nèi)容是否對(duì)您有幫助：

← PHP8 db2_free_stmt

PHP8 db2_last_insert_id →

寫(xiě)筆記

我要補(bǔ)充