XML 列値を含む行の挿入

XML 列を含む行を表に挿入する場合は、SQL INSERT ステートメントを使用できます。

変更の始まりXML 列に挿入する文書は、XML 1.0 仕様に定義されているとおりの整形式 XML 文書でなければなりません。 文書ノードがまだ存在しない場合は、それが暗黙的に作成されます。 アプリケーション・データ・タイプは、XML (XML AS BLOB、XML AS CLOB、XML AS DBCLOB)、 文字、またはバイナリー・タイプとすることができます。変更の終わり

推奨事項: Db2® データベース・サーバーがホスト変数データ・タイプを使用してエンコード情報の一部を判別できるように、XML データはリテラルではなく、ホスト変数を使用して挿入することをお勧めします。

アプリケーション内の XML データはテキスト XML 形式またはバイナリー XML 形式が可能です (拡張可能動的バイナリー XML Db2 クライアント/サーバー・バイナリー XML 形式)。 バイナリー XML 形式は、JDBC アプリケーション、SQLJ アプリケーション、および ODBC アプリケーションでのみ有効です。そのデータを XML 列に挿入する際、データを XML 階層形式に変換しなければなりません。 XML データがホスト変数から XML 列に直接挿入される場合、Db2 データベース・サーバーは、この操作を 暗黙的に実行します。あるいは、挿入操作実行時に XMLPARSE 関数を明示的に呼び出して、 データを XML 階層形式に変換することができます。

文書の挿入時に、登録済みの XML スキーマに照らして XML 文書を妥当性検査することができます。 文書を挿入する XML 列に XML スキーマ修飾子が付いている場合、妥当性検査は 自動的に実行されます。実行されない場合、DSN_XMLVALIDATE 関数を呼び出して XML スキーマの妥当性検査を実行できます。文書挿入の際に妥当性検査を 実行できるのは、文書がテキスト XML 形式である場合のみです。

以下の例は、XML データを XML 列に挿入する方法を示しています。 この例では、サンプルの CUSTOMER 表のコピーである表 MYCUSTOMER を使用します。 挿入される XML データは、次のようになっています。
<customerinfo xmlns="http://posample.org" Cid="1015">
<name>Christine Haas</name>
<addr country="Canada">
<street>12 Topgrove</street>
<city>Toronto</city>
<prov-state>Ontario</prov-state>
<pcode-zip>N8X-7F8</pcode-zip>
</addr>
<phone type="work">905-555-5238</phone>
<phone type="home">416-555-2934</phone>
</customerinfo>
例: JDBC アプリケーションで、テキスト XML データをバイナリー・データとしてファイル c6.xml から読み取り、そのデータを XML 列に挿入します。
PreparedStatement insertStmt = null;
String sqls = null;
int cid = 1015;
sqls = "INSERT INTO MyCustomer (Cid, Info) VALUES (?, ?)";
insertStmt = conn.prepareStatement(sqls);
insertStmt.setInt(1, cid);
File file = new File("c6.xml");
insertStmt.setBinaryStream(2, new FileInputStream(file), (int)file.length());
insertStmt.executeUpdate();
例: ファイル c7.xml 内のデータはファイル c6.xml と同じ XML 文書を含む一方で、このデータはバイナリー XML 形式で格納されているとします。JDBC アプリケーションで、データをファイル c7.xml から読み取り、そのデータを XML 列に挿入します。
…
SQLXML info = conn.createSQLXML();
OutputStream os = info.setBinaryStream();
FileInputStream fis = new FileInputStream("c7.xml");
int read;
while ((read = fis.read ()) != -1) {
  os.write (read);
}
PreparedStatement insertStmt = null;
String sqls = null;
int cid = 1015;
sqls = "INSERT INTO MyCustomer (Cid, Info) VALUES (?, ?)";
insertStmt = conn.prepareStatement(sqls);
insertStmt.setInt(1, cid);
insertStmt.setSQLXML(2, info);
insertStmt.executeUpdate(); 
例: 静的組み込み C アプリケーションで、データを XML AS BLOB ホスト変数から XML 列に挿入します。
EXEC SQL BEGIN DECLARE SECTION;
   sqlint64 cid;
   SQL TYPE IS XML AS BLOB (10K) xml_hostvar;
EXEC SQL END DECLARE SECTION;
…
cid=1015;
/* Read data from file c6.xml into xml_hostvar */
…
EXEC SQL INSERT INTO MyCustomer (Cid,Info) VALUES (:cid, :xml_hostvar);
例: 静的組み込み COBOL アプリケーションで、データを文字 XML ホスト変数から XML 列に挿入します。
…
 WORKING-STORAGE SECTION.                                  
…
* XML HOST VARIABLES
 01  CLOB-XML-IN USAGE IS SQL TYPE IS XML AS CLOB(10K).    
 01  CLOB-XML-OUT USAGE IS SQL TYPE IS XML AS CLOB(10K).   
* VARIABLE USED FOR DISPLAY OF THE RETRIEVED VALUE
 01  CLOB-XML-OUT-DISPLAY.                                 
   02  CLOB-XML-OUT-DISPLAY-LENGTH                         
       PIC 9(9) COMP.                                      
   02  CLOB-XML-OUT-DISPLAY-DATA.                          
       49  FILLER PIC X(10240).                            
*****************************************************     
* SQL INCLUDE FOR SQLCA                             *     
*****************************************************     
      EXEC SQL INCLUDE SQLCA  END-EXEC.                   
 PROCEDURE DIVISION.                                      
* USE XMLPARSE TO CONVERT THE INPUT DATA TO THE XML TYPE.
      EXEC SQL SET :CLOB-XML-IN=                            
       XMLPARSE(DOCUMENT                                        
       '<customerinfo xmlns="http://posample.org" Cid="1015">' ||
       '<name>Christine Haas</name>'                           ||
       '<addr country="Canada">'                               ||
       '<street>12 Topgrove</street>'                          ||
       '<city>Toronto</city>'                                  ||
       '<prov-state>Ontario</prov-state>'                      ||
       '<pcode-zip>N8X-7F8</pcode-zip>'                        ||
       '</addr>'                                               ||
       '<phone type="work">905-555-5238</phone>'               ||
       '<phone type="home">416-555-2934</phone>'               ||
       '</customerinfo>')                                        
      END-EXEC.
* INSERT THE DATA.
      EXEC SQL INSERT INTO CUSTOMER(CID, INFO)                  
       VALUES (1015,:CLOB-XML-IN)                              
      END-EXEC.                                                 
* CHECK THE VALUE THAT YOU INSERTED.
      EXEC SQL SELECT INFO                                     
       INTO :CLOB-XML-OUT FROM CUSTOMER                         
       WHERE CID=1015                                           
      END-EXEC.                                                 
      MOVE CLOB-XML-OUT TO CLOB-XML-OUT-DISPLAY.                
      DISPLAY                                                   
      CLOB-XML-OUT-DISPLAY-DATA(1:CLOB-XML-OUT-DISPLAY-LENGTH).