db2_set_option 接続リソースあるいはステートメントリソースのオプションを設定する &reftitle.description; booldb2_set_option resourceresource arrayoptions inttype ステートメントリソースあるいは接続リソースのオプションを設定します。 結果セットリソースのオプションを設定することはできません。 &reftitle.parameters; 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 - rowcount DB2_ROWCOUNT_PREFETCH_OFF - X - trusted_user <USER NAME> (文字列) X - - trusted_password <PASSWORD> (文字列) X - - userid 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 - &reftitle.returnvalues; &return.success; &reftitle.examples; DB2_AUTOCOMMIT_ON); /* 正しいリソースとオプションの配列、そして型を表す値を指定して関数をコールします */ $result = db2_set_option($conn, $options, 1); /* すべてのオプションが正しく設定できたかどうかを調べます */ if($result) { echo 'オプションの設定に成功しました'; } else { echo 'オプションが設定できませんでした'; } ?> ]]> &example.outputs; DB2_AUTOCOMMIT_OFF, 'binmode' => DB2_PASSTHRU, 'db2_attr_case' => DB2_CASE_UPPER, 'cursor' => DB2_SCROLLABLE); /* 正しいリソースとオプションの配列、そして型を表す値を指定して関数をコールします */ $result = db2_set_option($conn, $options, 1); /* すべてのオプションが正しく設定できたかどうかを調べます */ if($result) { echo 'オプションの設定に成功しました'; } else { echo 'オプションが設定できませんでした'; } ?> ]]> &example.outputs; DB2_AUTOCOMMIT_OFF, 'MY_INVALID_KEY' => DB2_PASSTHRU, 'db2_attr_case' => DB2_CASE_UPPER, 'cursor' => DB2_SCROLLABLE); /* 正しいリソースとオプションの配列、そして型を表す値を指定して関数をコールします */ $result = db2_set_option($conn, $options, 1); /* すべてのオプションが正しく設定できたかどうかを調べます */ if($result) { echo 'オプションの設定に成功しました'; } else { echo 'オプションが設定できませんでした'; } ?> ]]> &example.outputs; DB2_AUTOCOMMIT_OFF, 'binmode' => 'INVALID_VALUE', 'db2_attr_case' => DB2_CASE_UPPER, 'cursor' => DB2_SCROLLABLE); /* 正しいリソースとオプションの配列、そして型を表す値を指定して関数をコールします */ $result = db2_set_option($conn, $options, 1); /* すべてのオプションが正しく設定できたかどうかを調べます */ if($result) { echo 'オプションの設定に成功しました'; } else { echo 'オプションが設定できませんでした'; } ?> ]]> &example.outputs; DB2_AUTOCOMMIT_OFF, 'binmode' => DB2_PASSTHRU, 'db2_attr_case' => DB2_CASE_UPPER, 'cursor' => DB2_SCROLLABLE); /* 正しいリソースとオプションの配列、そして間違った型を表す値を指定して関数をコールします */ $result = db2_set_option($conn, $options, 2); /* すべてのオプションが正しく設定できたかどうかを調べます */ if($result) { echo 'オプションの設定に成功しました'; } else { echo 'オプションが設定できませんでした'; } ?> ]]> &example.outputs; DB2_AUTOCOMMIT_OFF, 'binmode' => DB2_PASSTHRU, 'db2_attr_case' => DB2_CASE_UPPER, 'cursor' => DB2_SCROLLABLE); $stmt = db2_prepare($conn, 'SELECT * FROM EMPLOYEE'); /* 間違ったリソース、そして正しいオプションの配列と型を表す値を指定して関数をコールします */ $result = db2_set_option($stmt, $options, 1); /* すべてのオプションが正しく設定できたかどうかを調べます */ if($result) { echo 'オプションの設定に成功しました'; } else { echo 'オプションが設定できませんでした'; } ?> ]]> &example.outputs; DB2_CASE_LOWER, 'cursor' => DB2_SCROLLABLE); $stmt = db2_prepare($conn, 'SELECT * FROM EMPLOYEE WHERE EMPNO = ? OR EMPNO = ?'); /* 正しいリソースとオプションの配列、そして型を表す値を指定して関数をコールします */ $option_result = db2_set_option($stmt, $options, 2); $result = db2_execute($stmt, array('000130', '000140')); /* スクロール可能なカーソルのため、1 行目より先に 2 行目を取得します */ print_r(db2_fetch_assoc($stmt, 2)); print '

'; print_r(db2_fetch_assoc($stmt, 1)); ?> ]]> &example.outputs; 000140 [firstnme] => HEATHER [midinit] => A [lastname] => NICHOLLS [workdept] => C01 [phoneno] => 1793 [hiredate] => 1976-12-15 [job] => ANALYST [edlevel] => 18 [sex] => F [birthdate] => 1946-01-19 [salary] => 28420.00 [bonus] => 600.00 [comm] => 2274.00 ) Array ( [empno] => 000130 [firstnme] => DELORES [midinit] => M [lastname] => QUINTANA [workdept] => C01 [phoneno] => 4578 [hiredate] => 1971-07-28 [job] => ANALYST [edlevel] => 16 [sex] => F [birthdate] => 1925-09-15 [salary] => 23800.00 [bonus] => 500.00 [comm] => 1904.00 )]]> "nobody")); $stmt = db2_prepare($conn, 'select * from names where first = ?'); $name = "first2"; db2_bind_param($stmt, 1, "name", DB2_PARAM_IN); $options = array("i5_fetch_only"=>DB2_I5_FETCH_ON); db2_set_option($stmt,$options,0); if (db2_execute($stmt)) { while ($row = db2_fetch_array($stmt)) { echo "{$row[0]} {$row[1]}"; } } ?> ]]> &example.outputs; &reftitle.seealso; db2_connect db2_pconnect db2_exec db2_prepare db2_cursor_type