XML 來源

  • 發行項

適用於：SQL Server Azure Data Factory 中的 SSIS Integration Runtime

XML 來源會讀取 XML 資料檔案，並將資料填入來源輸出中的資料行。

XML 檔案中的資料經常會包括階層式關聯性。 例如，XML 資料檔案可代表目錄以及目錄中的項目。 在資料能夠進入資料程序之前，必須先決定 XML 資料檔案中各元素之間的關聯性，並且為檔案中各元素產生輸出。

結構描述

XML 來源使用結構描述解譯 XML 資料。 XML 來源支援使用 XML 結構描述定義 (XSD) 檔或內嵌結構描述，將 XML 資料翻譯成表格格式。 如果您使用 [XML 來源編輯器] 對話方塊設定 XML 來源，則使用者介面可從指定的 XML 資料檔案產生 XSD。

注意

不支援 DTD。

結構描述僅可支援單一命名空間，而不支援結構描述集合。

注意

XML 來源不會根據 XSD 驗證 XML 檔案中的資料。

XML 來源編輯器

XML 檔案中的資料經常會包括階層式關聯性。 [XML 來源編輯器] 對話方塊會使用指定的結構描述產生 XML 來源輸出。 您可以指定 XSD 檔、使用內嵌結構描述，或從指定的 XML 資料檔案產生 XSD。 結構描述必須於設計階段提供。

XML 來源會藉由為包含 XML 檔案中其他元素的每項元素建立輸出的方式，從 XML 資料產生表格式結構。 例如，如果 XML 資料代表目錄以及目錄中的項目，則 XML 來源會為目錄以及目錄所包含的每一種項目建立輸出。 每一個項目的輸出將包含該項目屬性的輸出資料行。

為了提供有關輸出中資料的階層式關聯性的資訊，XML 來源會在輸出中加入識別每一個子元素所屬父元素的資料行。 若使用含有不同項目類型的目錄範例，則各項目可能會有識別其所屬目錄的資料行值。

XML 來源會為每一個元素建立輸出，但您不需使用所有輸出。 您可以刪除任何不要使用的輸出，或不要將它連接到下游元件。

XML 來源還會產生輸出名稱，以確保名稱不會模糊不清。 這些名稱可能很長，且可能不會以對您來說實用的方式識別輸出。 您可以重新命名輸出，只要其名稱保持唯一即可。 您也可以修改資料類型和輸出資料行的長度。

XML 來源會針對每一項輸出加入錯誤輸出。 依預設，錯誤輸出中的資料行的資料類型為 Unicode 字串 (DT_WSTR)，且其長度為 255，不過您可以藉由修改資料類型和長度的方式設定錯誤輸出中的資料行。

如果 XML 資料檔案包含 XSD 中沒有的元素，則會略過這些元素且不會產生其輸出。 換言之，如果 XML 資料檔案遺漏了 XSD 中出現的元素，則輸出會包含擁有 Null 值的資料行。

從 XML 資料檔案擷取資料時，該資料會轉換為 Integration Services 資料類型。 但是，XML 來源無法將 XML 資料轉換成 DT_TIME2 或 DT_DBTIMESTAMP2 資料類型，因為此來源不支援這些資料類型。 如需詳細資訊，請參閱 Integration Services 資料類型。

XSD 或內嵌結構描述可能會指定元素的資料類型；如果未指定，則 [XML 來源編輯器] 對話方塊會指派 Unicode 字串資料類型 (DT_WSTR) 給包含該元素的輸出中的資料行，並將資料行長度設定為 255 個字元。

如果結構描述指定元素的最大長度，輸出資料行的長度會設為此值。 如果最大長度大於元素轉換成的 Integration Services 資料類型支援的長度，則資料會截斷成該資料類型的最大長度。 例如，如果字串長度為 5000，因為 DT_WSTR 資料類型的最大長度是 4000 個字元，則字串會截斷成 4000 個字元；同樣地，位元組資料會截斷成 DT_BYTES 資料類型的最大長度 8000 個字元。 如果結構描述指定無最大長度，則具有其中一種資料類型的預設資料行長度會設為 255。 XML 來源中的資料截斷會使用與其他資料流程元件中的截斷相同的方式來處理。 如需詳細資訊，請參閱 處理資料中的錯誤。

您可以修改資料類型和資料行長度。 如需詳細資訊，請參閱 Integration Services 資料類型。

設定 XML 來源

XML 來源支援三種不同的資料存取模式。 您可以指定 XML 資料檔案的檔案位置、包含檔案位置的變數，或包含 XML 資料的變數。

XML 來源包括 XMLData 和 XMLSchemaDefinition 自訂屬性，屬性運算式可以在載入封裝時更新這些屬性。 如需詳細資訊，請參閱 Integration Services (SSIS) 運算式、在套件中使用屬性運算式和 XML 來源自訂屬性。

XML 來源支援多項規則輸出和多項錯誤輸出。

SQL Server Integration Services 包含用來設定 XML 來源的 [XML 來源編輯器] 對話方塊。 [SSIS Designer] 中即提供此對話方塊。

您可以透過 SSIS 設計師或以程式設計方式設定屬性。

[進階編輯器] 對話方塊會反映能以程式設計的方式設定之屬性。 如需有關可以在 [進階編輯器] 對話方塊中或以程式設計方式設定之屬性的詳細資訊，請按下列其中一個主題：

如需有關如何設定屬性的詳細資訊，請按下列其中一個主題：

XML 來源編輯器 (連接管理員頁面)

使用 [XML 來源編輯器] 的 [連接管理員] 頁面，來指定 XML 檔案和轉換 XML 資料的 XSD。

靜態選項

資料存取模式
從來源中指定選取資料的方法。

值 描述
XML 檔案位置 從 XML 檔案擷取資料。
來自變數的 XML 檔案 指定變數中的 XML 檔案名稱。

相關資訊：在套件中使用變數
來自變數的 XML 資料 從變數中擷取 XML 資料。

使用內嵌結構描述
指定 XML 來源資料本身是否包含定義及驗證其結構和資料的 XSD 結構描述。

XSD 位置
輸入 XSD 結構描述檔案的路徑和檔案名稱，或按一下 [瀏覽] 來找出檔案。

瀏覽
使用 [開啟] 對話方塊來找出 XSD 結構描述檔案。

產生 XSD
使用 [另存新檔] 對話方塊，來選取自動產生之 XSD 結構描述檔案的位置。 編輯器會從 XML 資料的結構中推斷結構描述。

資料存取模式動態選項

資料存取模式 = XML 檔案位置

XML 位置
輸入 XML 資料檔的路徑和檔案名稱，或按一下 [瀏覽] 來找出檔案。

瀏覽
使用 [開啟] 對話方塊來找出 XML 資料檔。

資料存取模式 = 來自變數的 XML 檔案

變數名稱
選取包含 XML 檔案之路徑和檔案名稱的變數。

資料存取模式 = 來自變數的 XML 資料

變數名稱
選取包含 XML 資料的變數。

XML 來源編輯器 (資料行頁面)

使用 [XML 來源編輯器] 對話方塊的 [資料行] 節點，即可將輸出資料行對應至外部 (來源) 資料行。

選項。

可用的外部資料行
在資料來源中檢視可用的外部資料行清單。 您無法使用此資料表來加入或刪除資料行。

[外部資料行]
依工作讀取外部 (來源) 資料行的順序來檢視它們。 您可以變更此順序，方法是先在編輯器所顯示的資料表中清除選取的資料行，然後以不同的順序從清單中選取外部資料行。

輸出資料行
為每個輸出資料行提供唯一的名稱。 預設值為選取的外部 (來源) 資料行的名稱；不過，您也可以選擇任何唯一的、描述性的名稱。 提供的名稱將顯示在 SSIS 設計師內。

XML 來源編輯器 (錯誤輸出頁面)

使用 [XML 來源編輯器] 對話方塊的 [錯誤輸出] 頁面，以選取錯誤處理選項，並設定錯誤輸出資料行上的屬性。

選項。

輸入/輸出
檢視資料來源的名稱。

資料行
檢視您在 [XML 來源編輯器] 對話方塊的 [連線管理員] 頁面上所選取的外部 (來源) 資料行。

錯誤
指定錯誤發生時要採取的動作：忽略失敗、重新導向資料列，或使元件失效。

相關主題處理資料中的錯誤

截斷
指定截斷發生時要採取的動作：忽略失敗、重新導向資料列，或使元件失效。

說明
檢視錯誤的描述。

將這個值設定到選取的資料格
指定發生錯誤或截斷時要對所有選取之資料格採取的動作：忽略失敗、重新導向資料列，或使元件失效。

套用
將錯誤處理選項套用至選取的資料格。

使用 XML 來源來擷取資料