組み込み SQL アプリケーションにおける XML データの取り出し

組み込み SQL アプリケーションで、データを文字ホスト変数に取り出す場合、 Db2® は、 データを UTF-8 コード化スキームからアプリケーション・コード化スキームに変換します。 データをバイナリー・ホスト変数に取り出す場合には、Db2 は、データを別のコード化スキームに変換しません。

出力データは、テキスト XML 形式です。

Db2 は、 データの取り出し時に XMLSERIALIZE 関数が呼び出されるかどうかに応じて、取り出されたデータに XML エンコード仕様を追加することがあります。 XMLSERIALIZE 関数が呼び出されなかった場合、Db2 は、取り出されるデータに適切な XML エンコード仕様を追加します。 XMLSERIALIZE 関数が呼び出された場合、Db2 は、関数呼び出しに INCLUDING XMLDECLARATION が指定されていると、 UTF-8 エンコード方式用の内部 XML エンコード宣言を追加します。 INCLUDING XMLDECLARATION を使用する際には、取り出されるデータが UTF-8 エンコード方式から 別のエンコード方式に変換されないようにする必要があります。

以下の例で、アセンブラー、C、COBOL、および PI/I アプリケーションにおいて、XML 列からデータを取り出す方法を示します。例では、サンプルの CUSTOMER 表のコピーである MYCUSTOMER という表を使用します。

例: 以下の例は、XML 列のデータを XML AS BLOB、XML AS CLOB、および CLOB ホスト変数に 取り出すアセンブラー・プログラムを示しています。 XML AS BLOB ホスト変数に取り出されるデータはバイナリー・データとして取り出されるため、 データベース・サーバーは、UTF-8 エンコード方式の XML 宣言を生成します。XML AS CLOB ホスト変数に取り出されるデータは文字データとして取り出されるため、 データベース・サーバーは、外部エンコード方式と整合性がある内部エンコード方式の宣言がある XML 宣言を生成します。CLOB ホスト変数に取り出されるデータは文字データとして取り出されるため、 データベース・サーバーは、内部エンコード方式の宣言がある XML 宣言を生成します。その宣言は、 外部エンコード方式と整合性がないことがあります。
**********************************************************************
* RETRIEVE XML COLUMN DATA INTO AN XML AS CLOB HOST VARIABLE         *
**********************************************************************
         EXEC SQL                                                      +
               SELECT INFO                                             +
               INTO :XMLBUF                                            +
               FROM MYCUSTOMER                                         +
               WHERE CID = 1000
**********************************************************************
* RETRIEVE XML COLUMN DATA INTO AN XML AS BLOB HOST VARIABLE         *
**********************************************************************
         EXEC SQL                                                      +
               SELECT INFO                                             +
               INTO :XMLBLOB                                           +
               FROM MYCUSTOMER                                         +
               WHERE CID = 1000
**********************************************************************
* RETRIEVE DATA FROM AN XML COLUMN INTO A CLOB HOST VARIABLE.        *
* BEFORE SENDING THE DATA TO THE APPLICATION, INVOKE THE             * 
* XMLSERIALIZE FUNCTION TO CONVERT THE DATA FROM THE XML             *
* TYPE TO THE CLOB TYPE.                                             *
**********************************************************************
         EXEC SQL                                                      +
               SELECT XMLSERIALIZE(INFO AS CLOB(10K))                  +
               INTO :CLOBBUF                                           +
               FROM MYCUSTOMER                                         +
               WHERE CID = 1000
…
          LTORG
******************************
* HOST VARIABLE DECLARATIONS *
******************************
XMLBUF    SQL TYPE IS XML AS CLOB 10K
XMLBLOB   SQL TYPE IS XML AS BLOB 10K
CLOBBUF   SQL TYPE IS CLOB 10K
例: 以下の例は、XML 列のデータを XML AS BLOB、XML AS CLOB、および CLOB ホスト変数に 取り出す C 言語プログラムを示しています。 XML AS BLOB ホスト変数に取り出されるデータはバイナリー・データとして取り出されるため、 データベース・サーバーは、UTF-8 エンコード方式の XML 宣言を生成します。XML AS CLOB ホスト変数に取り出されるデータは文字データとして取り出されるため、 データベース・サーバーは、外部エンコード方式と整合性がある内部エンコード方式の宣言がある XML 宣言を生成します。CLOB ホスト変数に取り出されるデータは文字データとして取り出されるため、 データベース・サーバーは、内部エンコード方式の宣言がある XML 宣言を生成します。その宣言は、 外部エンコード方式と整合性がないことがあります。
/******************************/
/* Host variable declarations */
/******************************/
EXEC SQL BEGIN DECLARE SECTION;
SQL TYPE IS XML AS CLOB( 10K ) xmlBuf;
SQL TYPE IS XML AS BLOB( 10K ) xmlBlob;
SQL TYPE IS CLOB( 10K ) clobBuf;
EXEC SQL END DECLARE SECTION;
/**********************************************************************/
/* Retrieve data from an XML column into an XML AS CLOB host variable */
/**********************************************************************/
EXEC SQL SELECT INFO   INTO :xmlBuf from myTable where CID = 1000;
/**********************************************************************/
/* Retrieve data from an XML column into an XML AS BLOB host variable */
/**********************************************************************/
EXEC SQL SELECT INFO   INTO :xmlBlob from myTable where CID = 1000;
/**********************************************************************/
/* RETRIEVE DATA FROM AN XML COLUMN INTO A CLOB HOST VARIABLE.        */
/* BEFORE SENDING THE DATA TO THE APPLICATION, INVOKE THE             */
/* XMLSERIALIZE FUNCTION TO CONVERT THE DATA FROM THE XML             */
/* TYPE TO THE CLOB TYPE.                                             */
/**********************************************************************/
EXEC SQL SELECT XMLSERIALIZE(INFO AS CLOB(10K)) 
 INTO :clobBuf from myTable where CID = 1000;
例: 以下の例は、XML 列のデータを XML AS BLOB、XML AS CLOB、および CLOB ホスト変数に 取り出す COBOL プログラムを示しています。 XML AS BLOB ホスト変数に取り出されるデータはバイナリー・データとして取り出されるため、 データベース・サーバーは、UTF-8 エンコード方式の XML 宣言を生成します。XML AS CLOB ホスト変数に取り出されるデータは文字データとして取り出されるため、 データベース・サーバーは、外部エンコード方式と整合性がある内部エンコード方式の宣言がある XML 宣言を生成します。CLOB ホスト変数に取り出されるデータは文字データとして取り出されるため、 データベース・サーバーは、内部エンコード方式の宣言がある XML 宣言を生成します。その宣言は、 外部エンコード方式と整合性がないことがあります。
******************************
* Host variable declarations *
******************************
 01 XMLBUF  USAGE IS SQL TYPE IS XML AS CLOB(10K).
 01 XMLBLOB USAGE IS SQL TYPE IS XML AS BLOB(10K).
 01 CLOBBUF USAGE IS SQL TYPE IS CLOB(10K). 
**********************************************************************
* Retrieve data from an XML column into an XML AS CLOB host variable *
**********************************************************************
 EXEC SQL SELECT INFO
   INTO :XMLBUF
   FROM MYTABLE 
   WHERE CID = 1000
 END-EXEC.
**********************************************************************
* Retrieve data from an XML column into an XML AS BLOB host variable *
**********************************************************************
 EXEC SQL SELECT INFO
   INTO :XMLBLOB 
   FROM MYTABLE 
   WHERE CID = 1000
 END-EXEC.
**********************************************************************
* RETRIEVE DATA FROM AN XML COLUMN INTO A CLOB HOST VARIABLE.        *
* BEFORE SENDING THE DATA TO THE APPLICATION, INVOKE THE             *
* XMLSERIALIZE FUNCTION TO CONVERT THE DATA FROM THE XML             *
* TYPE TO THE CLOB TYPE.                                             *
**********************************************************************
 EXEC SQL SELECT XMLSERIALIZE(INFO AS CLOB(10K)) 
  INTO :CLOBBUF 
  FROM MYTABLE 
  WHERE CID = 1000
 END-EXEC.
例: 以下の例は、XML 列のデータを XML AS BLOB、XML AS CLOB、および CLOB ホスト変数に 取り出す PL/I プログラムを示しています。 XML AS BLOB ホスト変数に取り出されるデータはバイナリー・データとして取り出されるため、 データベース・サーバーは、UTF-8 エンコード方式の XML 宣言を生成します。XML AS CLOB ホスト変数に取り出されるデータは文字データとして取り出されるため、 データベース・サーバーは、外部エンコード方式と整合性がある内部エンコード方式の宣言がある XML 宣言を生成します。CLOB ホスト変数に取り出されるデータは文字データとして取り出されるため、 データベース・サーバーは、内部エンコード方式の宣言がある XML 宣言を生成します。その宣言は、 外部エンコード方式と整合性がないことがあります。
/******************************/
/* Host variable declarations */
/******************************/
 DCL
  XMLBUF SQL TYPE IS XML AS CLOB(10K),
  XMLBLOB SQL TYPE IS XML AS BLOB(10K),
  CLOBBUF SQL TYPE IS CLOB(10K);
/**********************************************************************/
/* Retrieve data from an XML column into an XML AS CLOB host variable */
/**********************************************************************/
 EXEC SQL SELECT INFO   INTO :XMLBUF FROM MYTABLE WHERE CID = 1000;
/**********************************************************************/
/* Retrieve data from an XML column into an XML AS BLOB host variable */
/**********************************************************************/
 EXEC SQL SELECT INFO   INTO :XMLBLOB FROM MYTABLE WHERE CID = 1000;
/**********************************************************************/
/* RETRIEVE DATA FROM AN XML COLUMN INTO A CLOB HOST VARIABLE.        */
/* BEFORE SENDING THE DATA TO THE APPLICATION, INVOKE THE             */
/* XMLSERIALIZE FUNCTION TO CONVERT THE DATA FROM THE XML             */
/* TYPE TO THE CLOB TYPE.                                             */
/**********************************************************************/
 EXEC SQL SELECT XMLSERIALIZE(INFO AS CLOB(10K)) 
  INTO :CLOBBUF FROM MYTABLE WHERE CID = 1000;