組み込み SQL アプリケーションにおける XML 列の更新

Db2® 表の XML 列でデータを更新または挿入する場合、 入力データはテキスト XML 形式でなければなりません。

XML データのエンコード方式は、データ自体から導出する (内部的にエンコードされた データという) か、または外部ソースから導き出される (外部的にエンコードされた データという) ことができます。 データベース・サーバーにバイナリー・データとして送信される XML データは、内部的にエンコードされたデータとして扱われます。 データベース・サーバーに文字データとして送信される XML データは、外部的にエンコードされたデータとして扱われます。

外部的にエンコードされたデータは、内部エンコード方式を持つことができます。 つまり、 データはデータベース・サーバーに文字データとして送信されますが、データにエンコード情報が含まれています。 Db2 は、 内部エンコード方式と外部エンコード方式の整合性を強要しません。内部エンコード方式と外部エンコード方式 の情報が異なる場合、外部エンコード方式が優先されます。 ただし、外部エンコード方式と内部エンコード方式に違いがある場合、 それを調整する文字変換がデータに対して行われることがあり、それによりデータが損失する可能性があります。

XML 列の文字データは、UTF-8 エンコード方式で保管されます。データベース・サーバーは、 内部または外部エンコード方式から UTF-8 へのデータ変換を処理します。

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

例: 以下の例は、XML AS BLOB、XML AS CLOB、および CLOB ホスト変数のデータを XML 列に 挿入するアセンブラー・プログラムを示しています。 XML AS BLOB データはバイナリー・データとして挿入されるため、データベース・サーバーは、 データを内部エンコード方式として扱います。XML AS CLOB および CLOB データは文字データとして挿入されるため、 データベース・サーバーは、データを外部エンコード方式として扱います。
**********************************************************************
* UPDATE AN XML COLUMN WITH DATA IN AN XML AS CLOB HOST VARIABLE     *
**********************************************************************
         EXEC SQL                                                      +
               UPDATE MYCUSTOMER                                       +
               SET INFO = :XMLBUF                                      +
               WHERE CID = 1000
**********************************************************************
* UPDATE AN XML COLUMN WITH DATA IN AN XML AS BLOB HOST VARIABLE     *
**********************************************************************
         EXEC SQL                                                      +
               UPDATE MYCUSTOMER                                       +
               SET INFO = :XMLBLOB                                     +
               WHERE CID = 1000
**********************************************************************
* UPDATE AN XML COLUMN WITH DATA IN A CLOB HOST VARIABLE. USE        *
* THE XMLPARSE FUNCTION TO CONVERT THE DATA TO THE XML TYPE.         *
**********************************************************************
         EXEC SQL                                                      +
               UPDATE MYCUSTOMER                                       +
               SET INFO = XMLPARSE(DOCUMENT :CLOBBUF)                  +
               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 AS BLOB、XML AS CLOB、および CLOB ホスト変数のデータを XML 列に 挿入する C 言語プログラムを示しています。 XML AS BLOB データはバイナリー・データとして挿入されるため、データベース・サーバーは、 データを内部エンコード方式として扱います。XML AS CLOB および CLOB データは文字データとして挿入されるため、 データベース・サーバーは、データを外部エンコード方式として扱います。
/******************************/
/* 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;
/******************************************************************/
/* Update an XML column with data in an XML AS CLOB host variable */
/******************************************************************/
EXEC SQL UPDATE MYCUSTOMER SET INFO = :xmlBuf where CID = 1000;
/******************************************************************/
/* Update an XML column with data in an XML AS BLOB host variable */
/******************************************************************/
 EXEC SQL UPDATE MYCUSTOMER SET INFO = :xmlblob where CID = 1000;
/******************************************************************/
/* Update an XML column with data in a CLOB host variable. Use    */
/* the XMLPARSE function to convert the data to the XML type.     */
/******************************************************************/
EXEC SQL UPDATE MYCUSTOMER SET INFO = XMLPARSE(DOCUMENT :clobBuf) where CID = 1000;
例: 以下の例は、XML AS BLOB、XML AS CLOB、および CLOB ホスト変数のデータを XML 列に 挿入する COBOL プログラムを示しています。 XML AS BLOB データはバイナリー・データとして挿入されるため、データベース・サーバーは、 データを内部エンコード方式として扱います。XML AS CLOB および CLOB データは文字データとして挿入されるため、 データベース・サーバーは、データを外部エンコード方式として扱います。
******************************
* 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). 
*******************************************************************
* Update an XML column with data in an XML AS CLOB host variable  *
*******************************************************************
 EXEC SQL UPDATE MYCUSTOMER SET INFO = :XMLBUF where CID = 1000.
*******************************************************************
* Update an XML column with data in an XML AS BLOB host variable  *
*******************************************************************
 EXEC SQL UPDATE MYCUSTOMER SET INFO = :XMLBLOB where CID = 1000.
*******************************************************************
* Update an XML column with data in a CLOB host variable. Use     *
* the XMLPARSE function to convert the data to the XML type.      *
*******************************************************************
 EXEC SQL UPDATE MYCUSTOMER SET INFO = XMLPARSE(DOCUMENT :CLOBBUF) where CID = 1000.
例: 以下の例は、XML AS BLOB、XML AS CLOB、および CLOB ホスト変数のデータを XML 列に 挿入する PL/I プログラムを示しています。 XML AS BLOB データはバイナリー・データとして挿入されるため、データベース・サーバーは、 データを内部エンコード方式として扱います。XML AS CLOB および CLOB データは文字データとして挿入されるため、 データベース・サーバーは、データを外部エンコード方式として扱います。
/******************************/
/* 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);
/*******************************************************************/
/* Update an XML column with data in an XML AS CLOB host variable  */
/*******************************************************************/
 EXEC SQL UPDATE MYCUSTOMER SET INFO = :XMLBUF where CID = 1000;
/*******************************************************************/
/* Update an XML column with data in an XML AS BLOB host variable  */
/*******************************************************************/
 EXEC SQL UPDATE MYCUSTOMER SET INFO = :XMLBLOB where CID = 1000;
/*******************************************************************/
/* Update an XML column with data in a CLOB host variable. Use     */
/* the XMLPARSE function to convert the data to the XML type.      */
/*******************************************************************/
 EXEC SQL UPDATE MYCUSTOMER SET INFO = XMLPARSE(DOCUMENT :CLOBBUF) where CID = 1000;