組み込み 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;