db2_set_option
(PECL ibm_db2 >= 1.0.0)
db2_set_option — 接続リソースあるいはステートメントリソースのオプションを設定する
説明
ステートメントリソースあるいは接続リソースのオプションを設定します。 結果セットリソースのオプションを設定することはできません。
パラメータ
resource
-
db2_prepare() が返す有効なステートメントリソースか、 あるいは db2_connect() や db2_pconnect() が返す有効な接続リソース。
options
-
ステートメントあるいは接続のオプションを含む連想配列。 このパラメータは、自動コミットの値を変更したりカーソルの型を (スクロール可能、あるいは前進のみに) 変更したり、結果セットに表示されるカラム名を (小文字、大文字、あるいは元のままに) 設定したりする際に使用します。
autocommit
-
DB2_AUTOCOMMIT_ON
を渡すと、 指定した接続リソースの自動コミットをオンにします。DB2_AUTOCOMMIT_OFF
を渡すと、 指定した接続リソースの自動コミットをオフにします。 cursor
-
DB2_FORWARD_ONLY
を渡すと、 ステートメントリソースに前進のみのカーソルを指定します。 これはデフォルトのカーソル型であり、 すべてのデータベースサーバーでサポートされています。DB2_SCROLLABLE
を渡すと、 ステートメントリソースにスクロール可能なカーソルを指定します。 このカーソルは、順番どおり以外の方法で結果セットの行にアクセス可能です。 しかし、IBM DB2 Universal Database でしかサポートされていません。 binmode
-
DB2_BINARY
を渡すと、 バイナリデータがそのままの形式で返されるようになります。 これはデフォルトのモードです。php.ini でibm_db2.binmode=1
とするのと同じことです。DB2_CONVERT
を渡すと、 バイナリデータを十六進エンコーディングで変換して返します。 これは、php.ini でibm_db2.binmode=2
とするのと同じことです。DB2_PASSTHRU
を渡すと、 バイナリデータをnull
に変換するようになります。これは php.ini でibm_db2.binmode=3
とするのと同じことです。 db2_attr_case
-
DB2_CASE_LOWER
を渡すと、 結果セットのカラム名を小文字で返します。DB2_CASE_UPPER
を渡すと、 結果セットのカラム名を大文字で返します。DB2_CASE_NATURAL
を渡すと、 結果セットのカラム名をそのまま何もせずに返します。 deferred_prepare
-
DB2_DEFERRED_PREPARE_ON
を渡すと、 指定したステートメントリソースについて遅延プリペアを有効にします。DB2_DEFERRED_PREPARE_OFF
を渡すと、 指定したステートメントリソースについて遅延プリペアを無効にします。
以下の新しい i5/OS オプションは、ibm_db2 のバージョン 1.5.1 以降で使用可能です。 これらのオプションが適用されるのは、PHP と ibm_db2 が i5 システム上でネイティブに動作している場合のみです。
i5_fetch_only
-
DB2_I5_FETCH_ON
- カーソルは読み込み専用となり、場所を指定しての更新や削除には使用できません。 これは、SQL_ATTR_FOR_FETCH_ONLY
がSQL_FALSE
に設定されていない場合のデフォルト設定です。DB2_I5_FETCH_OFF
- カーソルは、場所を指定しての更新や削除に使用できるようになります。
以下の新しいオプションが、ibm_db2 バージョン 1.8.0 以降で使用可能です。
rowcount
-
DB2_ROWCOUNT_PREFETCH_ON
- クライアントは、取得する前に全行数を問い合わせることができます。つまり、ROLLFORWARD_ONLY
カーソルを使っている場合でも 選択された行数を db2_num_rows() で取得することができます。DB2_ROWCOUNT_PREFETCH_OFF
- クライアントは、取得する前に全行数を問い合わせることができません。
以下の新しいオプションが、ibm_db2 バージョン 1.7.0 以降で使用可能です。
trusted_user
-
ユーザーを信頼済みユーザーに変更する際に、信頼済みユーザーのユーザー ID (文字列) をこのキーの値として渡します。 このオプションは、接続リソース上でのみ設定可能です。 このオプションを使用するには、 信頼済みコンテキストを接続リソース上で有効にしなければなりません。
trusted_password
-
trusted_user キーで指定したユーザーに対応するパスワード (文字列)。
以下の新しいオプションが、ibm_db2 バージョン 1.6.0 以降で使用可能です。 これらは、有用な情報を提供します。これらの情報は、 db2_get_option() によって取得します。
注意:
各オプションの値を設定する際、 サーバーによっては指定したすべての内容を処理できないことがあります。 その場合、値が切り詰められます。
指定したオプションが正しく変換されてホストシステムに送信されることを確実にするには、 A から Z までの文字と 0 から 9 までの数字、そしてアンダースコア (_) とピリオド (.) のみを使用するようにします。
userid
-
SQL_ATTR_INFO_USERID
- ヌル終端の文字列へのポインタで、DB2 接続の際にホストデータベースサーバーに送信する クライアントのユーザー ID として使用します。注意:
z/OS および OS/390 サーバー版の DB2 は 16 文字までの長さをサポートしています。 このユーザー ID を、認証時に使用するユーザー ID と混同しないでください。 これは識別のためだけに使用するものであり、認証には用いられません。
acctstr
-
SQL_ATTR_INFO_ACCTSTR
- ヌル終端の文字列へのポインタで、DB2 接続の際にホストデータベースサーバーに送信する クライアントのアカウンティング・ストリングとして使用します。注意:
z/OS および OS/390 サーバー版の DB2 は 200 文字までの長さをサポートしています。
applname
-
SQL_ATTR_INFO_APPLNAME
- ヌル終端の文字列へのポインタで、DB2 接続の際にホストデータベースサーバーに送信する クライアントのアプリケーション名として使用します。注意:
z/OS および OS/390 サーバー版の DB2 は 32 文字までの長さをサポートしています。
wrkstnname
-
SQL_ATTR_INFO_WRKSTNNAME
- ヌル終端の文字列へのポインタで、DB2 接続の際にホストデータベースサーバーに送信する クライアントのワークステーション名として使用します。注意:
z/OS および OS/390 サーバー版の DB2 は 18 文字までの長さをサポートしています。
type
-
この関数に渡すリソースの型を、整数値で指定します。 リソースの型とこの値は必ず一致していなければなりません。
1
は、 接続リソースがこの関数に渡されることを表します。1
以外の整数を指定すると、 ステートメントリソースがこの関数に渡されることを表します。
次の表は、それぞれのオプションがどのリソース型で使用可能かをまとめたものです。
キー | 値 | リソースの型 | ||
---|---|---|---|---|
接続 | ステートメント | 結果セット | ||
autocommit | DB2_AUTOCOMMIT_ON |
X | - | - |
autocommit | DB2_AUTOCOMMIT_OFF |
X | - | - |
cursor | DB2_SCROLLABLE |
- | X | - |
cursor | DB2_FORWARD_ONLY |
- | X | - |
binmode | DB2_BINARY |
X | X | - |
binmode | DB2_CONVERT |
X | X | - |
binmode | DB2_PASSTHRU |
X | X | - |
db2_attr_case | DB2_CASE_LOWER |
X | X | - |
db2_attr_case | DB2_CASE_UPPER |
X | X | - |
db2_attr_case | DB2_CASE_NATURAL |
X | X | - |
deferred_prepare | DB2_DEFERRED_PREPARE_ON |
- | X | - |
deferred_prepare | DB2_DEFERRED_PREPARE_OFF |
- | X | - |
i5_fetch_only | DB2_I5_FETCH_ON |
- | X | - |
i5_fetch_only | DB2_I5_FETCH_OFF |
- | X | - |
rowcount | DB2_ROWCOUNT_PREFETCH_ON |
- | X | 上にスクロール