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 は、LOB のリレーションシップ、基本表スペース、XML のリレーションシップ、および列 XMLCOL の XML 文書の構造保全性を検査しますが、列 XMLCOL の文書に対する XML スキーマ妥当性検査は実行しません。CHECK DATA TABLESPACE DSNXDX1A.DSNXSX1D INCLUDE XML TABLESPACES(TABLE XMLTBL XMLCOLUMN XMLCOL)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 列がある以下の表を作成するとします。
以下のカーソルは、PURCHASE_ORDER 列に XML データが含まれている ため、宣言することはできません。CREATE TABLE ORDERS (ORDERNO INTEGER, PURCHASE_ORDER XML);
ただし、以下の例のように、非 XML 列が含まれているカーソルを宣言することはできます。EXEC SQL DECLARE C1 CURSOR FOR SELECT * FROM ORDERS ENDEXECEXEC 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 表にロードするように指定します。
MYSYSREC データ・セットには、 論理的に以下のデータが含まれていることを前提とします (この例は、論理的な表記であり、データが 入力データ・セットで実際にどのようになっているかを示すものではありません。)LOAD DATA INDDN(MYSYSREC) INTO TABLE PRODUCTS (CATEGORY POSITION (1) CHAR(8), PURCHASE_ORDER POSITION (10) XML PRESERVE WHITESPACE)
このデータをロードした後、PRODUCTS 表には、以下の情報が含まれています。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>表 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>注:LOAD ユーティリティーによる XML データのロードには、以下の制限があります。- Db2 は、 少なくとも 1 つの XML 列を持つ表にロードされる行ごとに文書 ID 列を自動的に生成します。 文書 ID 列は、部分的に非表示です。DocID 列は、SELECT * ステートメントの結果セットに含まれません。 ただし、この列を名前によって照会し、カタログ内のこの列および列の索引に関する情報を表示することができます。 いくつかのユーティリティーの出力では、この列に関する情報が報告されます。
- 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 データ・セットにアンロードするように指定します。
表に、表 4 のデータが含まれているとします。 出力の区切り文字で区切られたデータは、次のようになります。//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 /*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 表スペースをコピーしないでください。