XML 一括読み込みのガイドラインと制限 (SQLXML 4.0)

[アーティクル]
07/05/2024

XML 一括読み込みを使用する場合は、次のガイドラインと制限に留意してください。

インラインスキーマはサポートされません。

インラインスキーマがソース XML ドキュメントにある場合、XML 一括読み込みでそのスキーマは無視されます。 XML 一括読み込みには、XML データの外部にあるマッピングスキーマを指定してください。 xmlns="x:schema" 属性を使用して、ノードでマッピングスキーマを指定することはできません。
XML ドキュメントが適切な形式であるかどうかはチェックされますが、検証は行われません。

XML 一括読み込みでは、XML ドキュメントが整形式であるかどうかを確認し、XML が World Wide Web Consortium の XML 1.0 の推奨事項の構文要件に準拠していることを確認します。ドキュメントが適切な形式でない場合、XML 一括読み込みの処理は取り消され、エラーが返されます。ただし、ドキュメントがフラグメントの場合 (ドキュメントに単一のルート要素がない場合) だけは、XML 一括読み込みでドキュメントが読み込まれます。

XML 一括読み込みでは、XML データファイル内で定義または参照されている XML-Data または DTD スキーマに関して、ドキュメントの検証は行われません。さらに、XML 一括読み込みでは、指定されるマッピングスキーマに対して XML データファイルは検証されません。
XML prolog 情報は無視されます。

XML 一括読み込みでは、XML ドキュメント内の <root> 要素の前後のすべての情報が無視されます。たとえば、XML 宣言、内部 DTD 定義、外部 DTD 参照、コメントなどは無視されます。

マッピングスキーマで、2 つのテーブル (たとえば Customer と CustOrder) 間の主キー/外部キーのリレーションシップを定義する場合は、主キーがあるテーブルを先に記述する必要があります。外部キー列があるテーブルは、後に記述します。その理由は、テーブルがスキーマで識別される順序が、データベースへの読み込みに使用される順序であるためです。たとえば、次の XDR スキーマでは、 <Order> 要素が <Customer> 要素の前に記述されているため、XML 一括読み込みで使用するとエラーが発生します。 CustOrder の CustomerID 列は、Cust テーブル内の CustomerID 主キー列を参照する外部キー列です。

<?xml version="1.0" ?>  
<Schema xmlns="urn:schemas-microsoft-com:xml-data"   
        xmlns:dt="urn:schemas-microsoft-com:xml:datatypes"    
        xmlns:sql="urn:schemas-microsoft-com:xml-sql" >  

    <ElementType name="Order" sql:relation="CustOrder" >  
      <AttributeType name="OrderID" />  
      <AttributeType name="CustomerID" />  
      <attribute type="OrderID" />  
      <attribute type="CustomerID" />  
    </ElementType>  

   <ElementType name="CustomerID" dt:type="int" />  
   <ElementType name="CompanyName" dt:type="string" />  
   <ElementType name="City" dt:type="string" />  

   <ElementType name="root" sql:is-constant="1">  
      <element type="Customers" />  
   </ElementType>  
   <ElementType name="Customers" sql:relation="Cust"   
                     sql:overflow-field="OverflowColumn"  >  
      <element type="CustomerID" sql:field="CustomerID" />  
      <element type="CompanyName" sql:field="CompanyName" />  
      <element type="City" sql:field="City" />  
      <element type="Order" >   
           <sql:relationship  
               key-relation="Cust"  
                key="CustomerID"  
                foreign-key="CustomerID"  
                foreign-relation="CustOrder" />  
      </element>  
   </ElementType>  
</Schema>

スキーマで sql:overflow-field 注釈を使用してオーバーフロー列を指定しない場合、XML 一括読み込みでは、XML ドキュメントに存在するがマッピングスキーマには記述されていないデータは無視されます。

XML 一括読み込みでは、XML データストリーム内に既知のタグが検出されると常に、指定のマッピングスキーマが適用されます。 XML ドキュメントに存在していてもスキーマに記述されていないデータは無視されます。たとえば、 <Customer> 要素を記述するマッピングスキーマがあるとします。 XML データファイルには、すべての <Customer> 要素を囲む <AllCustomers> ルートタグ (スキーマでは説明されていません) があります。
```
<AllCustomers>  
  <Customer>...</Customer>  
  <Customer>...</Customer>  
   ...  
</AllCustomers>  
```
この場合、XML 一括読み込みでは、 <AllCustomers> 要素が無視され、 <Customer> 要素でマッピングが開始されます。 XML ドキュメントに存在していてもスキーマに記述されていない要素は無視されます。

<Order> 要素を含む別の XML ソースデータファイルについて考えてみましょう。この要素はマッピングスキーマには記述されていません。
```
<AllCustomers>  
  <Customer>...</Customer>  
    <Order> ... </Order>  
    <Order> ... </Order>  
     ...  
  <Customer>...</Customer>  
    <Order> ... </Order>  
    <Order> ... </Order>  
     ...  
  ...  
</AllCustomers>  
```
XML 一括読み込みでは、これらの <Order> 要素は無視されます。ただし、スキーマで sql:overflow-fieldannotation を使用して列をオーバーフロー列として識別する場合、XML 一括読み込みでは、この列にすべての未使用のデータが格納されます。
CDATA セクションとエンティティ参照は、データベースに保存される前に、同等の文字列に変換されます。

この例では、CDATA セクションは、 <City> 要素の値をラップします。 XML 一括読み込みでは、 <City> 要素をデータベースに挿入する前に、文字列値 ("NY") が抽出されます。
```
<City><![CDATA[NY]]> </City>  
```
XML 一括読み込みでは、エンティティ参照は保持されません。

マッピングスキーマで属性に既定値が指定されており、その属性が XML ソースデータに含まれていない場合、XML 一括読み込みでは既定値が使用されます。

次のサンプル XDR スキーマでは、 HireDate 属性に既定値が割り当てられます。

<?xml version="1.0" ?>  
<Schema xmlns="urn:schemas-microsoft-com:xml-data"   
        xmlns:dt="urn:schemas-microsoft-com:xml:datatypes"    
        xmlns:sql="urn:schemas-microsoft-com:xml-sql" >  
   <ElementType name="root" sql:is-constant="1">  
      <element type="Customers" />  
   </ElementType>  

   <ElementType name="Customers" sql:relation="Cust3" >  
      <AttributeType name="CustomerID" dt:type="int"  />  
      <AttributeType name="HireDate"  default="2000-01-01" />  
      <AttributeType name="Salary"   />  

      <attribute type="CustomerID" sql:field="CustomerID" />  
      <attribute type="HireDate"   sql:field="HireDate"  />  
      <attribute type="Salary"     sql:field="Salary"    />  
   </ElementType>  
</Schema>

この XML データでは、2 番目の <Customers> 要素に HireDate 属性がありません。 XML 一括読み込みでは、2 番目の <Customers> 要素をデータベースに挿入すると、スキーマで指定されている既定値が使用されます。

<ROOT>  
  <Customers CustomerID="1" HireDate="1999-01-01" Salary="10000" />  
  <Customers CustomerID="2" Salary="10000" />  
</ROOT>

sql:url-encode 注釈はサポートされていません。

XML データ入力に URL を指定して、その場所からデータの一括読み込みを行うことはできません。

マッピングスキーマで指定されているテーブルは、新しく作成されます (データベースは存在する必要があります)。 1 つ以上のテーブルがデータベースに既に存在する場合、SGDropTables プロパティは、これらの既存のテーブルを削除して再作成するかどうかを決定します。
SchemaGen プロパティ (SchemaGen = true など) を指定すると、マッピングスキーマで識別されるテーブルが作成されます。ただし、SchemaGen では、これらのテーブルに制約 (PRIMARY KEY/FOREIGN KEY 制約など) は作成されませんが、1 つの例外があります。リレーションシップの主キーを構成する XML ノードが XML 型の ID (つまり、XSD の場合は type="xsd:ID" ) を持つと定義され、SchemaGen の SGUseID プロパティが True に設定されている場合、では、ID 型指定されたノードから主キーが作成されるだけでなく、主キーと外部キーのリレーションシップはマッピングスキーマリレーションシップから作成されます。
SchemaGen は、リレーショナル SQL Server スキーマを生成するために XSD スキーマファセットと拡張機能を使用しません。
一括読み込み時に SchemaGen プロパティ (SchemaGen = true など) を指定すると、指定されたテーブル (共有名のビューではなく) のみが更新されます。
SchemaGen には、注釈付き XSD からリレーショナルスキーマを生成するための基本的な機能のみが用意されています。ユーザーは必要に応じて、生成されたテーブルを手動で変更する必要があります。
テーブル間に複数のリレーションシップが存在する場合、SchemaGen は、2 つのテーブル間に関係するすべてのキーを含む 1 つのリレーションシップを作成しようとします。この制限は、Transact-SQL エラーの原因である可能性があります。
データベースに XML データの一括読み込みを行う場合は、マッピングスキーマ内に、データベース列にマップされる属性または子要素が 1 つ以上存在している必要があります。
XML 一括読み込みを使用して日付値を挿入する場合、値は (-)CCYY-MM-DD((+-)TZ) の形式で指定する必要があります。これは日付の標準の XSD 形式です。
一部のプロパティフラグは、他のプロパティフラグと互換性がありません。たとえば、一括読み込みでは、 Ignoreduplicatekeys=true と共に Keepidentity=false はサポートされません。 Keepidentity=false の場合、一括読み込みでは、サーバーがキー値を生成することが想定されます。テーブルには、キーに対する IDENTITY 制約が必要です。サーバーは重複するキーを生成しません。つまり、 Ignoreduplicatekeys を true に設定する必要はありません。 Ignoreduplicatekeys を true に設定する必要があります 行を含むテーブルに受信データから主キー値をアップロードする場合にのみ、主キー値の競合が発生する可能性があります。

次の方法で共有

XML 一括読み込みのガイドラインと制限 (SQLXML 4.0)

フィードバック

フィードバック

その他のリソース