バイナリー XML データの SQLDA 拡張

バイナリー XML ホスト変数に対する組み込み SQL サポートはありませんが、XML データが XML バイナリー・データであることを示すために SQLDA をセットアップすることが可能です。

プログラム固有のプログラミング・インターフェース情報の開始

OPEN、 EXECUTE、 FETCH、および CALL の各ステートメント/入力ホスト変数や出力ホスト変数の場合、アプリケーション・プログラムは、SQLDA 内のフィールドを設定して、アプリケーション・プログラム内の入力または出力ホスト変数に関する情報を Db2® に提供します。

バイナリー XML ホスト変数を記述するために、SQLDA には、以下の形式と内容があります。

  • ファイル参照変数ではないバイナリー XML ホスト変数には、2 組の SQLVAR を持つ SQLDA が必要です。
  • 基本 SQLVAR で、SQLTYPE フィールドは BLOB (404/405) に設定され、SQLLEN フィールドは 0 に設定されます
  • 基本 SQLVAR の SQLNAME フィールドは次のように設定されます。 SQLNAME の長さは 8 です。SQLNAME のデータ部分の最初の 4 バイトは X'00000000' です。5 番目のバイトは、ホスト変数のタイプを示すフラグ・フィールドです。このフィールドの値は以下のとおり。
    • X'01'- XML 変数 (XML AS BLOB、XML AS CLOB、XML AS DBCLOB)
    • X'03'- バイナリー XML 変数

基本 SQLVAR の SQLNAME フィールドの 6 番目から 8 番目までの変更はありません

  • 拡張 SQLVAR では、SQLLONGLEN フィールドは、バイナリー XML 変数の長さ属性に設定されます。

ファイル参照変数では、バイナリー XML ファイルを記述するために必要なのは、1 組の SQLVARs を持つ SQLDA のみです。 基本 SQLVAR の SQLTYPE フィールドは、BLOB_FILE (916/917) に設定されます。基本 SQLVAR の SQLNAME フィールドは、バイナリー XML 変数と同じ値に設定されます。

DESCRIBE ステートメントおよび PREPARE INTO ステートメントの出力 SQLDA に変更はありません。

それ以外のすべてのデータ・タイプのホスト変数のバイナリー XML ビットは無視されます。

プログラム固有のプログラミング・インターフェース情報の終了