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