ODBC アプリケーションでの XML 列の更新

Db2® 表で XML 列のデータを更新またはデータを挿入すると、入力データはテキスト形式または 拡張可能動的バイナリー XML Db2 クライアント/サーバー・バイナリー XML 形式 (バイナリー XML 形式) になります。

XML データの場合、SQLBindParameter() または SQLSetParam() を使用してパラメーター・マーカーを入力データ・バッファーにバインドする場合、入力データ・バッファーのデータ・タイプ (fCType) を以下のいずれかのタイプに指定できます。

  • SQL_C_BINARY
  • SQL_C_BINARYXML
  • SQL_C_CHAR
  • SQL_C_DBCHAR
  • SQL_C_WCHAR.
XML データを SQL_C_BINARY として含むデータ・バッファーをバインドする場合、ODBC は XML データを内部でエンコードしたデータとして処理します。これは、オーバーヘッドと文字変換の潜在的なデータ損失を回避するので、お勧めする方式です。
重要: XML データをコード化スキームおよびアプリケーション以外の CCSID コード化スキームでエンコードする場合、内部エンコードをデータに組み込んで、文字変換を回避するためにデータを SQL_C_BINARY としてバインドします。
XML データを SQL_C_CHAR、SQL_C_DBCHAR または SQL_C_WCHAR として含むデータ・バッファーをバインドする場合は、ODBC は XML データを外部でエンコードしたデータとして処理します。ODBC では、以下のようにデータのエンコードを決定します。
  • fCType 値が SQL_C_WCHAR の場合は、ODBC ではデータを UCS-2 としてエンコードされると想定します。
  • fCType 値が SQL_C_CHAR または SQL_C_DBCHAR の場合は、ODBC ではデータをアプリケーション・コード化スキームでエンコードされると想定します。

SQL_C_BINARYXML は、内部でのエンコードでも外部でのエンコードでもありません。SQL_C_BINARYXML はバイナリー XML 形式 (テキスト XML 形式との対照) であり、エンコードはありません。

Db2 を使用して、暗黙的な XMLPARSE を XML 列に保管する前に、データに対して行う場合、SQLBindParameter() または SQLSetParam()(fsqlType) にあるパラメーター・マーカーのデータ・タイプを SQL_XML として指定する必要があります。

明示的な XMLPARSE をデータに対して行う場合、SQLBindParameter() または SQLSetParam() (fsqlType) にあるパラメーター・マーカーのデータ・タイプを文字データ・タイプまたはバイナリー・データ・タイプとして指定できます。

XML データを XML 列に挿入する例: 以下の例は、さまざまな C データ・タイプと SQL データ・タイプを使用して XML データを XML 列に挿入する方法を示します。
図 1. XML データを XML 列に挿入する例
/* Variables for input XML data                  */
SQLCHAR     HVCHAR[32768];
SQLWCHAR    HVWCHAR[32768];
/* Variables for input XML data lengths          */
SQLINTEGER  LEN_HVCHAR; 
SQLINTEGER  LEN_HVWCHAR;
/* SQL statement buffer                          */
SQLCHAR     sqlstmt[250];
/* Return code for ODBC calls                    */
SQLRETURN   rc = SQL_SUCCESS;
/* Prepare an INSERT statement for inserting     */
/* data into an XML column. The input parameter  */
/* type is SQL_XML, so DB2 does an implicit      */
/* XMLPARSE.                                     */
strcpy((char *)sqlstmt,
  "INSERT INTO MYTABLE(XMLCOL) VALUES(?)");
/* Bind input XML data with the SQL_C_CHAR type, */
/* to an SQL_XML SQL type.                       */
/* The data is assumed to be externally encoded, */
/* in the application encoding scheme.           */
rc = SQLBindParameter(hstmt, 1, SQL_PARAM_INPUT, SQL_C_CHAR, SQL_XML, 
  0, 0, HVCHAR, sizeof(HVCHAR), &LEN_HVCHAR);
/* Execute the INSERT statement */
rc = SQLExecute(hstmt);
/* Bind input XML data with the SQL_C_WCHAR type, */
/* to an SQL_XML SQL type.                        */
/* The data is assumed to be externally encoded,  */
/* in the UCS-2 encoding scheme.                  */ 
rc = SQLBindParameter(hstmt, 1, SQL_PARAM_INPUT, SQL_C_WCHAR, SQL_XML, 
  0, 0, HVWCHAR, sizeof(HVWCHAR0, &LEN_HVWCHAR);
/* Execute the INSERT statement */
rc = SQLExecute(hstmt);
/* Prepare an INSERT statement for inserting     */
/* data into an XML column. The input parameter  */
/* type is SQL_CLOB, so the application must     */
/* do an explicit XMLPARSE.                      */
strcpy((char *)sqlstmt,
  "INSERT INTO MYTABLE (XMLCOL) ");
strcat((char *)sqlstmt,
  "VALUES(XMLPARSE(DOCUMENT CAST ? AS CLOB))");
/* Bind input XML data with the SQL_C_CHAR type,  */
/* to an SQL_CLOB SQL type.                       */
/* An explicit XMLPARSE is required for inserting */
/* character data into an XML column.             */
rc = SQLBindParameter(hstmt, 1, SQL_PARAM_INPUT, SQL_C_CHAR, SQL_CLOB, 
  32768, 0, HVCHAR, sizeof(HVCHAR), &LEN_HVCHAR);
/* Execute the INSERT statement */
rc = SQLExecDirect(hstmt, sqlstmt, SQL_NTS);
バイナリー XML データを XML 列に挿入する例: 以下の例は、SQL_C_BINARYXML データ・タイプを使用して バイナリー XML データを XML 列に挿入する方法を示します。
図 2. バイナリー XML データを XML 列に挿入する例
CREATE TABLE MYTABLE ( XML_COL XML );

/* Declare variables for binary XML data */
SQLCHAR HV1BINARYXML[100];
SQLINTEGER LEN_HV1BINARYXML;
SQLCHAR sqlstmt[250];
SQLRETURN rc = SQL_SUCCESS;

/* Assume that HV1BINARYXML contains XML data in binary format
   and LEN_HV1BINARYXML contains the length of data in bytes */

/* Prepare insert statement */
strcpy((char *)sqlstmt, "insert into mytable values(?)");
rc = SQLPrepare(hstmt, sqlstmt, SQL_NTS);

/* Bind XML_COL column as SQL_C_BINARYXML */
rc = SQLBindParameter(hstmt, 1, SQL_PARAM_INPUT, SQL_C_BINARYXML, SQL_XML,
                0, 0, HV1BINARYXML, sizeof(HV1BINARYXML), &LEN_HV1BINARYXML);

/* Execute insert */ 
rc = SQLExecute(hstmt);