Db2 による DSN_XMLVALIDATE の XML スキーマの選択方法
XML 列への挿入操作または XML 列更新操作の一部として DSN_XMLVALIDATE を実行すると、Db2® では妥当性検査を実行する XML スキーマが 1 つ選択されます。
Db2 は、使用する XML スキーマを以下のように判別します。
- DSN_XMLVALIDATE 呼び出しに XML スキーマ名が指定されている場合、Db2 は、その XML スキーマ名が一意に示す XML スキーマを使用します。
- DSN_XMLVALIDATE 呼び出しにターゲット名前空間またはスキーマ・ロケーション・ヒントのいずれかまたは両方が指定されている場合、Db2 は、Db2 XML スキーマ・リポジトリー (XSR) 内で、ターゲット名前空間とスキーマ・ロケーション・ヒントの組み合わせに対応する XML スキーマ名を検索します。
- ターゲット名前空間とスキーマ・ロケーション・ヒントの組み合わせに対応する XML スキーマ名が 1 つだけ検出されると、Db2 はその XML スキーマ名を使用します。
- ターゲット名前空間とスキーマ・ロケーション・ヒントの組み合わせに対応する XML スキーマ名が複数ある場合、Db2 は最新の登録タイム・スタンプを持つ XML スキーマを使用します。
- ターゲット名前空間とスキーマ・ロケーション・ヒントの組み合わせに対応する XML スキーマ名がない場合、Db2 はエラーを出します。
- DSN_XMLVALIDATE 呼び出しに XML スキーマ名、またはターゲット名前空間とスキーマ・ロケーション・ヒントが指定されていない場合、Db2 はインスタンス文書 (妥当検査対象文書) を調べて XML スキーマを判別します。
- Db2 は、インスタンス文書から次の方法でターゲット名前空間とスキーマ・ロケーション・ヒントを判別します。
- インスタンス文書のルート・エレメント・ノードに名前空間名が含まれている場合、Db2 はその名前空間名をターゲット名前空間名として使用します。
- インスタンス文書のルート・エレメント・ノードに名前空間名が含まれていない場合、Db2 はターゲット名前空間名を使用しません。
- インスタンス文書のルート・エレメント・ノードに xsi:schemaLocation 属性が含まれている場合、Db2 はその値をスキーマ・ロケーション・ヒントとして使用します。
- インスタンス文書のルート・エレメント・ノードに xsi:noNamespaceSchemaLocation 属性が含まれている場合、Db2 はその値を、ターゲット名前空間がないスキーマのスキーマ・ロケーション・ヒントとして使用します。
- Db2 は、Db2 XML スキーマ・リポジトリー (XSR) 内で、インスタンス文書のターゲット名前空間またはスキーマ・ロケーション・ヒント、あるいはこの両方に対応する XML スキーマ名を検索します。
- ターゲット名前空間とスキーマ・ロケーション・ヒントの組み合わせに対応する XML スキーマ名が 1 つだけ検出されると、Db2 はその XML スキーマ名を使用します。
- ターゲット名前空間とスキーマ・ロケーション・ヒントの組み合わせに対応する XML スキーマ名が複数ある場合、Db2 は最新の登録タイム・スタンプを持つ XML スキーマを使用します。
- ターゲット名前空間とスキーマ・ロケーション・ヒントの組み合わせに対応する XML スキーマ名がない場合、Db2 はエラーを出します。
- Db2 は、インスタンス文書から次の方法でターゲット名前空間とスキーマ・ロケーション・ヒントを判別します。
例: XML スキーマ・リポジトリー (XSR) に次の XML スキーマが含まれているとします。
| XML スキーマ名 | ターゲット名前空間 | スキーマ・ロケーション | スキーマが XSR に登録されたときの タイム・スタンプ |
|---|---|---|---|
| PO1 | http://www.example.com/PO1 | http://www.example.com/PO1.xsd | 2008-10-01 10:30:59.0100 |
| PO2 | http://www.example.com/PO2 | http://www.example.com/PO2.xsd | 2009-09-25 13:15:00.0200 |
| PO3 | 名前空間なし | http://www.example.com/PO3.xsd | 2009-06-25 13:15:00.0200 |
| PO4 | http://www.example.com/PO2 | http://www.example.com/PO4.xsd | 2009-10-25 13:15:00.0200 |
また、表 PURCHASEORDERV5 が次のように定義されているとします。
CREATE TABLE PURCHASEORDERV5(
ID INT NOT NULL,
CONTENT XML)
以下の INSERT ステートメントを実行します。
INSERT INTO PURCHASEORDERV5 VALUES(1, 1
DSN_XMLVALIDATE('<po:purchaseOrder xmlns:po="http://www.example.com/PO1">
…
</po:purchaseOrder>')
);
INSERT INTO PURCHASEORDERV5 VALUES(2, 2
DSN_XMLVALIDATE('<po:purchaseOrder xmlns:po="http://www.example.com/PO2"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.example.com/PO2
http://www.example.com/PO2.xsd">
…
</po:purchaseOrder>','SYSXSR.PO2')
);
INSERT INTO PURCHASEORDERV5 VALUES(2, 3
DSN_XMLVALIDATE('<po:purchaseOrder xmlns:po="http://www.example.com/PO2"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.example.com/PO2
http://www.example.com/PO4.xsd">
…
</po:purchaseOrder>',
'http://www.example.com/PO2')
);
INSERT INTO purchase_orders VALUES(3, 4
DSN_XMLVALIDATE(
'<purchaseOrder
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://www.example.com/PO3.xsd">
…
</purchaseOrder>')
);
Db2 で使用される XML スキーマと、各スキーマを使用する理由を次の表に示します。
| INSERT ステートメント番号 | 選択されている順序で妥当性検査に使用される XML スキーマ | 理由 |
|---|---|---|
| 1 | PO1 | DSN_XMLVALIDATE 呼び出しに XML スキーマまたはターゲット名前空間とスキーマ・ロケーション・ヒントが指定されていないため、Db2 はインスタンス文書の情報を使用します。インスタンス文書のルート・エレメントの名前空間名は http://www.example.com/PO1 です。この名前は、XML スキーマ PO1のターゲット名前空間のみと一致します。 |
| 2 | PO2 | DSN_XMLVALIDATE 呼び出しに XML スキーマ SYSXSR.PO2 が指定されています。 |
| 3 | PO4 | DSN_XMLVALIDATE 呼び出しに名前空間 http://www.example.com/PO2 が指定されています。2 つの XML スキーマ (PO2 と PO4) には、このターゲット名前空間が含まれています。PO4 のタイム・スタンプの方が新しいため、Db2 は、PO4 を使用します。 |
| 4 | PO3 | DSN_XMLVALIDATE 呼び出しに XML スキーマまたはターゲット名前空間とスキーマ・ロケーション・ヒントが指定されていないため、Db2 はインスタンス文書の情報を使用します。インスタンス文書のルート・ノード・エレメントには、 xsi:noNamespaceSchemaLocation 属性が含まれており、この属性の値は http://www.example.com/PO3.xsd です。このため、Db2 はターゲット名前空間が含まれていない XML スキーマ PO3と、スキーマ・ロケーション http://www.example.com/PO3.xsd を使用します。 |