XML ソース

更新 : 2006 年 4 月 14 日

XML ソースは XML データ ファイルを読み取り、ソース出力の列にデータを設定します。

XML ファイルのデータには、多くの場合、階層リレーションシップが含まれます。たとえば、XML データ ファイルはカタログおよびカタログ内のアイテムを表す場合があります。データ フローにデータを入力できるようにするためには、XML データ ファイルの要素のリレーションシップを特定し、ファイル内部の各要素に対して出力を生成する必要があります。

XML ソースは、スキーマを使用して XML データを解釈します。XML ソースでは、XML スキーマ定義 (XSD) ファイルまたはインライン スキーマを使用して、XML データを表形式に変換できます。[XML ソース エディタ] ダイアログ ボックスを使用して XML ソースを構成する場合、ユーザー インターフェイスにより、指定した XML データ ファイルから XSD を生成できます。

メモ :
DTD はサポートされていません。

スキーマでは、単一の名前空間のみがサポートされます。スキーマ コレクションはサポートされません。

メモ :
XML ソースは、XML ファイルのデータを XSD に対して検証しません。

XML ソースでは、3 つの異なるデータ アクセス モードがサポートされています。XML データ ファイルのファイルの場所、ファイルの場所を含む変数、または XML データを含む変数を指定できます。

XML ソースには、パッケージの読み込み時にプロパティ式で更新できる、XMLData カスタム プロパティと XMLSchemaDefinition カスタム プロパティがあります。詳細については、「Integration Services の式のリファレンス」、「パッケージでのプロパティ式の使用」、および「変換元のカスタム プロパティ」を参照してください。

XML ソースでは、複数の標準出力と複数のエラー出力がサポートされています。

SQL Server 2005 Integration Services (SSIS) には、XML ソースを構成する [XML ソース エディタ] ダイアログ ボックスが含まれています。このダイアログ ボックスは、SSIS デザイナから利用できます。

XML ソース エディタの使用

XML ファイルのデータには、多くの場合、階層リレーションシップが含まれます。[XML ソース エディタ] ダイアログ ボックスでは、指定したスキーマを使用して XML ソース出力を生成します。XSD ファイルの指定、インライン スキーマの使用、または、指定した XML データ ファイルからの XSD の生成を行うことができます。スキーマは、デザイン時に使用できる必要があります。

XML ソースは、XML ファイル内の別の要素が含まれる各要素の出力を作成し、XML データから表形式構造を生成します。たとえば、XML データがカタログおよびカタログ内のアイテムを表している場合、XML ソースはカタログの出力、および、カタログに含まれる各種類のアイテムに対する出力を作成します。各アイテムの出力には、そのアイテムの属性に対する出力列が含まれます。

出力内のデータの階層リレーションシップに関する情報を提供するため、XML ソースは、各子要素に対する親要素を識別する列を出力に追加します。異なる種類のアイテムを持つカタログの場合、各アイテムは、アイテムが属するカタログを識別する列の値を持つことになります。

XML ソースは各要素に対して出力を作成しますが、すべての出力を使用する必要はありません。使用しない出力を削除したり、下流コンポーネントに出力を連結しないようにできます。

また、XML ソースは、明確な名前を持つ出力名を生成します。これらの名前は、長すぎて、出力を識別するには役に立たない場合があります。出力名は、一意である限り変更できます。また、出力列のデータ型や長さも変更できます。

各出力に対し、XML ソースはエラー出力を追加します。既定では、エラー出力の列は、長さ 255 文字の Unicode 文字列データ型 (DT_WSTR) です。ただし、データ型と長さを変更して、エラー出力の列を構成できます。

XML データ ファイルに、XSD に存在しない要素が含まれる場合、これらの要素は無視され、出力が生成されません。これに対し、XML データ ファイルに XSD で表されている要素がない場合、出力には NULL 値の列が含まれます。

データが XML データ ファイルから抽出されると、そのデータは Integration Services データ型に変換されます。XSD またはインライン スキーマで要素のデータ型を指定することもできますが、指定しない場合は [XML ソース エディタ] ダイアログ ボックスで出力の要素が含まれる列に Unicode 文字列データ型 (DT_WSTR) が割り当てられ、その列の長さが 255 文字に設定されます。スキーマで要素の最大長を指定する場合、出力列の長さはこの値に設定されます。最大長が、要素の変換後の Integration Services データ型でサポートされている長さよりも大きい場合、データはデータ型の最大長に切り捨てられます。たとえば、長さ 5,000 の文字列の場合、DT_WSTR データ型の最大長は 4,000 文字であるため、4,000 文字に切り捨てられます。同様に、バイト データは DT_BYTES データ型の最大長である 8,000 文字に切り捨てられます。スキーマで最大長を指定しない場合、どのデータ型でも列の既定の長さは 255 に設定されます。XML ソースのデータの切り捨ては、他のデータ フロー コンポーネントでの切り捨てと同様に処理されます。詳細については、「データのエラー処理」を参照してください。

データ型と列の長さは変更できます。詳細については、「Integration Services のデータ型」を参照してください。

XML ソースの構成

プロパティを設定するには、SSIS デザイナから行うか、またはプログラムによって設定します。

[XML ソース エディタ] ダイアログ ボックスで設定できるプロパティの詳細については、次のトピックのいずれかを参照してください。

• [XML ソース エディタ] ([接続マネージャ] ページ)
• [XML ソース エディタ] ([列] ページ)
• [XML ソース エディタ] ([エラー出力] ページ)

[詳細エディタ] ダイアログ ボックスには、プログラムによって設定できるプロパティが反映されます。[詳細エディタ] ダイアログ ボックスまたはプログラムで設定できるプロパティの詳細については、次のトピックのいずれかを参照してください。

• 共通プロパティ
• 変換元のカスタム プロパティ

プロパティの設定方法の詳細については、次のトピックのいずれかを参照してください。

• XML ソースを使用してデータを抽出する方法
• コンポーネント エディタを使用して、データ フロー コンポーネントのプロパティを設定する方法
• [プロパティ] ウィンドウでデータ フロー コンポーネントのプロパティを設定する方法
• 詳細エディタを使用して、データ フロー コンポーネントのプロパティを設定する方法

参照

概念

パッケージのデータ フローの作成

その他の技術情報

Integration Services ソース

ヘルプおよび情報

SQL Server 2005 の参考資料の入手

変更履歴

リリース	履歴
2006 年 4 月 14 日	新しい内容 : データの切り捨てと列の既定の長さに関する情報を追加しました。
2005 年 12 月 5 日	新しい内容 : カスタム プロパティの情報を追加しました。