Db2 ユーティリティーにおける XML サポート

XML オブジェクトに対して IBM® Db2® for z/OS® ユーティリティーを使用することができます。 ユーティリティーは、LOB オブジェクトの処理方法と同様の方法で XML オブジェクトを処理します。 一部のユーティリティーでは、特定の XML キーワードを指定する必要があります。

CHECK DATA

CHECK DATA ユーティリティーは、LOB のリレーションシップだけでなく、XML のリレーションシップも検査します。

CHECK DATA は、基本表スペースと対応する XML 表スペースとの間の整合性を検査できます。

さらに、INCLUDE XML TABLESPACES オプションを指定すると、CHECK DATA は XML 文書の構造保全性を検査できます。CHECK DATA は、XML オブジェクトについて以下の項目を検査できます。

  • XML 列のすべての行が XML 表スペースに存在する。
  • XML 表スペースのすべての文書が構造的に有効である。
  • ノード ID 索引内の各索引項目が対応する XML 文書を持っている。
  • XML 表スペース内の各 XML 文書がノード ID 索引に対応する項目を持っている。
  • 基本表スペースの文書 ID 列の各項目が、XML 表スペース上のノード ID 索引に対応する項目を持っている。
  • ノード ID 索引内の各項目が文書 ID 列に対応する値を含んでいる。
  • 文書 ID 列内の各値が文書 ID 索引に対応する項目を持っている。
  • 文書 ID 索引内の各項目が文書 ID 列に対応する ID 列を持っている。
  • XML 列が XML タイプ修飾子を持っている場合、その列内のすべての XML 文書が、その XML タイプ修飾子に関連付けられている少なくとも 1 つの XML スキーマに関して有効である。

基本表スペースが関連する XML 表スペースと整合性がないか、または前にリストした検査のいずれかで問題が検出された場合、CHECK DATA はエラーを報告します。

XML 検査の場合、CHECK DATA のデフォルトの動作は、各 XML 列とそのノード ID 索引との間の不整合のみを検査することです。ただし、CHECK DATA SCOPE キーワードと INCLUDE XML TABLESPACES キーワードの組み合わせを指定することにより、検査の有効範囲を変更できます。次の表に、キーワードの組み合わせと、実行される検査のタイプをリストします。
表 1. XML 検査の有効範囲を制御する CHECK DATA SCOPE キーワードと INCLUDE XML TABLESPACES キーワードの組み合わせ
XML 検査の有効範囲 SCOPE キーワード INCLUDE XML TABLESPACES キーワード
XML 基本表の列とノード ID 索引の整合性のみ SCOPE AUXONLY、SCOPE ALL、または SCOPE PENDING 未指定
すべての XML 検査 SCOPE ALL または SCOPE PENDING INCLUDE XML TABLESPACES
XML スキーマ妥当性検査を除くすべての XML 検査 SCOPE ALL または SCOPE PENDING INCLUDE XML TABLESPACES XMLSCHEMA
XML スキーマ妥当性検査のみ SCOPE XMLSCHEMAONLY INCLUDE XML TABLESPACES
例えば、表スペース DSNXDX1A.DSNXSX1D に XML 列 XMLCOL (XML タイプ修飾子を持つ) を持つ XMLTBL という名前の表が含まれているとします。次のステートメントを指定した場合、CHECK DATA は、LOB のリレーションシップ、基本表スペース、XML のリレーションシップ、および列 XMLCOL の XML 文書の構造保全性を検査し、列 XMLCOL の文書に対する XML スキーマ妥当性検査を実行します。
CHECK DATA TABLESPACE DSNXDX1A.DSNXSX1D 
 INCLUDE XML TABLESPACES(TABLE XMLTBL XMLCOLUMN XMLCOL)
次のステートメントを指定した場合、CHECK DATA は、LOB のリレーションシップ、基本表スペース、XML のリレーションシップ、および列 XMLCOL の XML 文書の構造保全性を検査しますが、列 XMLCOL の文書に対する XML スキーマ妥当性検査は実行しません。
CHECK DATA TABLESPACE DSNXDX1A.DSNXSX1D 
 INCLUDE XML TABLESPACES(TABLE XMLTBL XMLCOLUMN XMLCOL) XMLSCHEMA

また、該当する以下のいずれかのキーワードを指定して、 Db2 が以下のいずれかの列で エラーを検出した際の Db2 のアクションを指定することもできます。

表 2. CHECK DATA エラー・キーワード
エラーが検出された列 CHECK DATA によるアクション キーワード
XML 列 エラーを報告するのみ XMLERROR REPORT
エラーを報告し、エラーが検出された列を無効な状況に設定し、XML 表スペース内の無効な文書を削除する XMLERROR INVALIDATE
LOB 列 エラーを報告するのみ LOBERROR REPORT
エラーを報告し、エラーが検出された列を無効な状況に設定する LOBERROR INVALIDATE
XML または LOB 列 エラーを報告するのみ AUXERROR REPORT
エラーを報告し、エラーが検出された列を無効な状況に設定する AUXERROR INVALIDATE
例えば、以下のステートメントは、CHECK DATA が XML および LOB のリレーションシップを検査することを 指定しています。Db2 は、 LOB エラーおよび XML エラーを報告し、エラーが検出された XML 列を無効な状況に設定します。
CHECK DATA TABLESPACE DSNXDX1A.DSNXSX1D
                 SCOPE AUXONLY  
      LOBERROR REPORT
      XMLERROR INVALIDATE
CHECK INDEX

CHECK INDEX ユーティリティーを使用して、XML 索引、文書 ID 索引、ノード ID 索引を検査できます。追加のキーワードを指定する必要はありません。

COPY

COPY ユーティリティーを使用して、XML オブジェクトをコピーできます。追加のキーワードを指定する必要はありません。 Db2 が XML 列を持つ表スペースをコピーすることをユーザーが指定しても、 Db2 は関連した XML 表スペースまたは索引を自動的にコピーしません。 ユーザーは、コピーしたい XML オブジェクトを明示的に指定しなければなりません。

例えば、以下のステートメントは、Db2 が基本表スペース DB1.BASETS1 と XML 表スペース DB1.XBAS0001 をコピーすることを指定しています。
//COPYX    EXEC DSNUPROC,SYSTEM=DSN 
//SYSIN    DD *   
           TEMPLATE A DSN(&DB..&SP..COPY1) UNIT CART STACK YES
COPY      TABLESPACE DB1.BASETS1 COPYDDN(A)       
          TABLESPACE DB1.XBAS0001 COPYDDN(A)       
COPYTOCOPY

COPYTOCOPY ユーティリティーを使用して、XML オブジェクトの既存のコピーをコピーできます。追加のキーワードを指定する必要はありません。

EXEC SQL

XML データが含まれているカーソルを宣言することはできません。そのため、 Db2 UDB ファミリーの クロスローダー機能を使用して XML 列のデータを転送することはできません。 ただし、カーソルに XML 列が含まれていない場合は、XML 列がある表でカーソルを宣言できます。

例えば、XML 列がある以下の表を作成するとします。
CREATE TABLE ORDERS 
  (ORDERNO INTEGER,
   PURCHASE_ORDER XML);
以下のカーソルは、PURCHASE_ORDER 列に XML データが含まれている ため、宣言することはできません。
EXEC SQL
  DECLARE C1 CURSOR FOR SELECT * FROM ORDERS
ENDEXEC
ただし、以下の例のように、非 XML 列が含まれているカーソルを宣言することはできます。
EXEC SQL
  DECLARE C2 CURSOR FOR SELECT ORDERNO FROM ORDERS
ENDEXEC
LISTDEF
LISTDEF ユーティリティーを使用してオブジェクト・リストを作成する際に、関連する XML オブジェクトを含めるか、または除外するかを指定できます。オブジェクトを含めるか、排除するかを示すには、以下のキーワードを使用します。
ALL
基本、LOB、および XML オブジェクト (このキーワードはデフォルトです)。
BASE
基本オブジェクトのみ。
LOB
LOB オブジェクトのみ。
XML
XML オブジェクトのみ。
例えば、以下の表の LISTDEF ステートメントは、以下に示されているリストを生成します。
表 3. LISTDEF ステートメントの例
LISTDEF ステートメント リストに含まれるオブジェクト
LISTDEF LISTALL INCLUDE TABLESPACES DATABASE ACCOUNTS
                INCLUDE INDEXSPACES DATABASE ACCOUNTS
  • XML および LOB 表スペースを含む、ACCOUNTS データベース内のすべての表スペース
  • ACCOUNTS データベース内のすべての索引スペース
LISTDEF LISTXML INCLUDE TABLESPACES DATABASE ACCOUNTS XML
                INCLUDE INDEXSPACES DATABASE ACCOUNTS XML
  • ACCOUNTS データベース内のすべての XML 表スペース
  • ACCOUNTS データベース内のすべての XML 索引スペース
LISTDEF LIST   INCLUDE TABLESPACES DATABASE ACCOUNTS ALL
               INCLUDE INDEXSPACES DATABASE ACCOUNTS ALL
               EXCLUDE INDEXSPACES DATABASE ACCOUNTS XML
  • XML および LOB 表スペースを含む、ACCOUNTS データベース内のすべての表スペース
  • XML 索引スペースを除く、ACCOUNTS データベース内のすべての索引スペース
LOAD

LOAD ユーティリティーを使用して XML データをロードできます。

入力データにはテキスト XML 形式またはバイナリー XML 形式を使用できます (拡張可能動的バイナリー XML Db2 クライアント/サーバー・バイナリー XML 形式)。 バイナリー XML 入力データは、区切りなし形式 である必要があります。

XML タイプ修飾子のある XML 列にデータをロードする場合は、XML タイプ修飾子で指定されている XML スキーマに従って、LOAD ユーティリティーが入力データを妥当性検査します。行の XML スキーマ違反を検出した場合、LOAD はその行を削除し、エラー・メッセージを出します。

XML データのロード手順は、 以下のアクションも実行する必要がある点を除いては、他のタイプのデータのロード手順と同様です。
  • 入力データ・セットでは:
    • データ・セットが区切り文字で区切られたフォーマットである場合には、XML 入力フィールド が、LOAD ユーティリティーの区切り文字で区切られた標準のフォーマットに沿うようにします。
    • データ・セットが区切り文字で区切られたフォーマットでない場合には、VARCHAR 入力を指定する方法と 同様の方法で XML 入力フィールドを指定します。 データの前に 2 バイトの 2 進数フィールドでフィールドの長さを指定します。
  • LOAD ステートメントでは:
    • タイプ XML のすべての入力フィールドにキーワード XML を指定します。
    • XML データ内の空白文字を保持したい場合は、さらに、キーワード PRESERVE WHITESPACE も指定します。デフォルトで、LOAD ユーティリティーは空白文字を除去します。

      バイナリー XML 形式のデータが表にロードされ、 PRESERVE WHITESPACE が指定されていない場合、Db2 は、入力データに空白文字のタグが含まれている場合のみ 空白文字を除去します。

例えば、以下の LOAD ステートメントは、Db2 が MYSYSREC データ・セットのデータを PRODUCTS 表にロードするように指定します。
LOAD DATA INDDN(MYSYSREC)
 INTO TABLE PRODUCTS
  (CATEGORY       POSITION  (1) CHAR(8),
   PURCHASE_ORDER POSITION  (10) XML PRESERVE WHITESPACE)
MYSYSREC データ・セットには、 論理的に以下のデータが含まれていることを前提とします (この例は、論理的な表記であり、データが 入力データ・セットで実際にどのようになっているかを示すものではありません。)
Shovel 339<product pid="100-100-01" xmlns="http://podemo.org"> 
            <description> 
                 <name>Snow Shovel, Basic 22"</name>
                 <details>Basic Snow Shovel, 22" wide, straight handle with D-Grip<details>
                 <price>9.99</price>
                 <weight>1 kg<weight>
            </description>
         <product>

Shovel  358<product pid="100-101-01" xmlns="http://podemo.org"> 
            <description> 
                 <name>Snow Shovel, Deluxe 24"</name>
                 <details>A Deluxe Snow Shovel, 24 inches wide, ergonomic curved handle with 
                 D-Grip<details>
                 <price>19.99</price>
                 <weight>2 kg<weight>
            </description>
         <product>
このデータをロードした後、PRODUCTS 表には、以下の情報が含まれています。
表 4. PRODUCTS 表
DB2_GENERATED _document ID_FOR_XML1 CATEGORY PURCHASE_ORDER
1 Shovel
<product pid="100-100-01" xmlns="http://podemo.org">
   <description>
       <name>Snow Shovel, Basic 22"</name>
      <details>Basic Snow Shovel, 22" wide, straight handle
          with D-Grip</details>
       <price>9.99</price>
       <weight>1 kg<weight>
   </description>
<product>
2 Shovel
<product pid="100-101-01" xmlns="http://podemo.org">
   <description>
       <name>Snow Shovel, Deluxe 24"</name>
      <details>A Deluxe Snow Shovel, 24 inches wide,  
        ergonomic curved handle with D-Grip</details>
       <price>19.99</price>
       <weight>2 kg<weight>
   </description>
<product>
注:
  1. Db2 は、 少なくとも 1 つの XML 列を持つ表にロードされる行ごとに文書 ID 列を自動的に生成します。 文書 ID 列は、部分的に非表示です。DocID 列は、SELECT * ステートメントの結果セットに含まれません。 ただし、この列を名前によって照会し、カタログ内のこの列および列の索引に関する情報を表示することができます。 いくつかのユーティリティーの出力では、この列に関する情報が報告されます。
LOAD ユーティリティーによる XML データのロードには、以下の制限があります。
  • XML 入力フィールドが、CHAR 列や VARCHAR 列などの非 XML 列にロードされるように指定することは できません。
  • Db2 は、 このデータに対して次に REORG ユーティリティーが実行されるまで、指定された圧縮を行いません。
  • Db2 は、 このデータに対して次に REORG ユーティリティーが実行されるまで、指定された FREEPAGE および PCTFREE 値を無視します。
  • PREFORMAT が指定されると、Db2 は、基本表スペースの事前フォーマットを行いますが、 XML 表スペースには行いません。
  • 基本表スペースの文書 ID 列を直接ロードすることはできません。
  • XML 列のデフォルト値を指定することはできません。
  • 32 KB より大きい XML 値はロードできません。このような値をロードするには、 LOAD ユーティリティーでファイル参照変数を使用するか、またはアプリケーションで SQL XML AS ファイル参照変数 を使用します。
QUIESCE

QUIESCE TABLESPACESET を指定すると、表スペース・セットに、関連する XML オブジェクトが組み込まれます。QUIESCE ステートメントに追加のキーワードを指定する必要はありません。

REBUILD INDEX

REBUILD INDEX ユーティリティーを使用して、XML 索引、文書 ID 索引、ノード ID 索引を再作成できます。REBUILD INDEX ステートメントに 追加のキーワードを指定する必要はありません。 SHRLEVEL CHANGE を指定した REBUILD INDEX は、XML 索引に無効です。

RECOVER

RECOVER ユーティリティーを使用して、XML オブジェクトをリカバリーできます。RECOVER ステートメントに 追加のキーワードを指定する必要はありません。

XML 索引または表スペースを特定の時点までリカバリーする場合は、 関連するすべてのオブジェクトを同じ時点までリカバリーしなければなりません。関連するオブジェクト としては、XML オブジェクト、LOB オブジェクト、および参照上の関連があるオブジェクトがあります。関連するすべてのオブジェクトを同じ時点までリカバリーしないと、 1 つ以上のオブジェクトが制限された状態になる可能性があります。

REORG INDEX

REORG ユーティリティーを使用して XML 索引を再編成できます。XML 索引を再編成するように指定する場合は、 WORKDDN キーワードも指定し、指定済みの一時作業ファイルを指定する必要があります。 デフォルトは SYSUT1 です。

REORG TABLESPACE

REORG TABLESPACE ユーティリティーを使用して XML オブジェクトを再編成できます。REORG ステートメントに 追加のキーワードを指定する必要はありません。

REORG ステートメントに基本表スペースの名前を指定すると、Db2 は、その表スペースのみ再編成し、 関連した XML オブジェクトは再編成しません。Db2 に XML オブジェクトの再編成を指示したい場合は、 そのオブジェクト名を指定する必要があります。

XML バージョンをサポートする XML 表スペースに対して REORG を実行すると、REORG は、必要でなくなった XML 文書のバージョンの行を破棄します。

XML 表スペースおよび XML 列がある基本表スペースの場合、 REORG ステートメントで以下のオプションを指定することはできません。
  • DISCARD
  • REBALANCE
  • UNLOAD EXTERNAL
REPAIR

XML オブジェクトで REPAIR ユーティリティーを使用できます。

REPAIR ユーティリティーを使用して、以下のことを行うことができます。
  • XML 列の状況を無効に設定する。
  • 破損した XML 文書とそのノード ID 索引項目を削除する。

XML オブジェクトに対する REPAIR ユーティリティーの最も一般的な使用方法は、XML 列がある表スペースに対して SHRLEVEL CHANGE を使用した CHECK DATA を実行した後で修理処置を実行することです。 SHRLEVEL CHANGE を使用した CHECK DATA はシャドー・データ・セットを操作するため、XML 列や XML 表スペースは変更しません。代わりに、CHECK DATA が REPAIR ステートメントを生成し、それを実行して、無効な XML 文書を削除し、対応する XML 列に無効とマークを付けることができます。

REPORT
REPORT TABLESPACESET を指定すると、出力レポートで、表スペース・セット内のメンバー・リストに XML オブジェクトが組み込まれます。以下の出力例には、LOB 列と XML 列が含まれている表の表スペース・セット が示されています。
TABLESPACE SET REPORT:                              
                                                    
TABLESPACE         : DBDKCX.TS0001                  
  TABLE            : SYSADM.DKCTEST                 
  INDEXSPACE       : DBDKCX.IRdocument IDD                
  INDEX            : SYSADM.I_document IDDKCTEST          
                                                    
                                                    
XML TABLESPACE SET REPORT:                          
                                                    
TABLESPACE                 : DBDKCX.TS0001          
                                                    
  BASE TABLE               : SYSADM.DKCTEST         
  COLUMN                   : COL2                   
    XML TABLESPACE         : DBDKCX.XDKC0000        
      XML TABLE            : SYSADM.XDKCTEST        
      XML NODEID INDEXSPACE: DBDKCX.IRNODEID        
      XML NODEID INDEX     : SYSADM.I_NODEIDXDKCTEST
      XML INDEXSPACE       : DBDKCX.VALUES          
      XML INDEX            : SYSADM.VALUES          
RUNSTATS

RUNSTATS ユーティリティーを使用して、XML オブジェクトに関する統計を収集できます。

RUNSTATS は、XML 表と XML 索引で以下のキーワードを無視します。
  • COLGROUP
  • FREQVAL MOST|LEAST|BOTH
  • HISTOGRAM
RUNSTATS INDEX は、XML 索引で以下のキーワードを無視します。
  • KEYCARD
  • FREQVAL MOST|LEAST|BOTH
  • HISTOGRAM

XML 索引は、関連する基本表にではなく XML 表に 関連しています。同じ RUNSTATS 制御ステートメント内に基本表スペースおよび XML 索引を指定すると、Db2 はエラーを生成します。基本表に対して RUNSTATS を実行すると、 RUNSTATS は、基本表の索引 (文書 ID 索引を含む) についてのみ 統計情報を収集します。

UNLOAD

UNLOAD ユーティリティーを使用して XML データをアンロードできます。

出力データにはテキスト XML 形式またはバイナリー XML 形式を使用できます。アンロードされたデータには、 区切り形式または区切りなし形式を使用できます。

データがバイナリー XML 形式でアンロードされた場合、 UNLOAD では空白文字タグを付与しません。

UNLOAD ステートメントでは、基本表スペースを指定します。(XML 表スペースを指定する必要はありません。) また、XML 列のフィールド仕様で XML キーワードを指定します。

例えば、以下の UNLOAD ステートメントは、Db2 が XMLSAMP 表のデータを区切り文字で区切られたフォーマット で SYSREC データ・セットにアンロードするように指定します。
//STEP3    EXEC DSNUPROC,UID='JUQBU105.UNLD1',
//         UTPROC='',
//         SYSTEM='SSTR'
//UTPRINT  DD SYSOUT=*          
//SYSREC   DD DSN=JUQBU105.UNLD1.STEP3.TBQB0501,DISP=(MOD,DELETE,CATLG),
//         UNIT=SYSDA,SPACE=(4000,(20,20),,,ROUND) 
//SYSPUNCH DD DSN=JUQBU105.UNLD1.STEP3.SYSPUNCH
//         DISP=(MOD,CATLG,CATLG)
//         UNIT=SYSDA,SPACE=(4000,(20,20),,,ROUND)
//SYSIN    DD*          
  UNLOAD TABLESPACE DBQB0501.XMLSAMP       
         DELIMITED CHARDEL X'22' COLDEL X'2C' DECPT X'2E'
          FROM TABLE ADMF001.BASETBL
          (CATEGORY          POSITION(*) CHAR, 
           PURCHASE_ORDER    POSITION(*) XML) 
         UNICODE
 /*
表に、表 4 のデータが含まれているとします。 出力の区切り文字で区切られたデータは、次のようになります。
Shovel,"<product pid=""100-100-01"" xmlns="http://podemo.org""> 
            <description> 
                 <name>Snow Shovel, Basic 22""</name>
                 <details>Basic Snow Shovel, 22"" wide, straight handle with D-Grip<details>
                 <price>9.99</price>
                 <weight>1 kg<weight>
            </description>
         <product>"

Shovel,"<product pid=""100-101-01"" xmlns="http://podemo.org""> 
            <description> 
                 <name>Snow Shovel, Deluxe 24""</name>
                 <details>A Deluxe Snow Shovel, 24 inches wide, ergonomic curved handle with 
                 D-Grip<details>
                 <price>19.99</price>
                 <weight>2 kg<weight>
            </description>
         <product>"

可搬性を最大限にするために、UNLOAD ステートメントに UNICODE を指定し、Unicode 区切り文字を 使用してください。XML 列が UTF-8 CCSID 1208 でアンロードされていない場合、 アンロードされた列値の前に、使用されるエンコード方式を指定する標準 XML エンコード方式宣言が 置かれます。

UNLOAD ユーティリティーによる XML データのアンロードには、以下の制限があります。
  • XML データが CHAR や VARCHAR などの別のデータ・タイプに変換されるように指定することはできません。
  • コピーから XML データをアンロードすることはできません。
インライン統計とインライン・コピー
ユーティリティーでの統計の収集を要求したり、インライン・コピーを作成したりする場合には、以下の制限があります。
  • XML 表スペースのインライン・コピーをとることはできません。
  • ユーザーが基本表スペースのインライン統計またはインライン・コピーを要求した場合、 Db2 は、 関連した XML 表スペースのコピーまたは統計収集を行いません。XML 表スペースについての統計を収集したい ことを明示的に指定する必要があります。
  • XML 索引に関するインライン統計を収集することを要求する場合、 以下の統計キーワードは指定できません。
    • HISTOGRAM
    • KEYCARD
    • FREQVAL NUMCOLS COUNT
スタンドアロン・ユーティリティー

スタンドアロン・ユーティリティーには、XML データをサポートするための特別なオプションはありません。ただし、スタンドアロン・ユーティリティーを XML データに使用することができます。

DSN1COPY ユーティリティーには、 XML データに関して使用する場合、次の制約事項があります。

  • DSN1COPY を使用して、あるサブシステムから別のサブシステムに XML 表スペースをコピーしないでください。