Zdroj XML
platí pro:
SQL Server SSIS Integration Runtime ve službě Azure Data Factory
Zdroj XML načte datový soubor XML a naplní sloupce ve zdrojovém výstupu daty.
Data v souborech XML často zahrnují hierarchické relace. Například datový soubor XML může představovat katalogy a položky v katalogech. Než mohou data zadat tok dat, musí být určen vztah prvků v datovém souboru XML a výstup musí být generován pro každý prvek v souboru.
Schémata
Zdroj XML používá schéma k interpretaci dat XML. Zdroj XML podporuje použití souboru XSD (XML Schema Definition) nebo vložených schémat k překladu dat XML do tabulkového formátu. Pokud nakonfigurujete zdroj XML pomocí editoru zdrojů XML dialogové okno, uživatelské rozhraní může vygenerovat XSD ze zadaného datového souboru XML.
Poznámka
DTD se nepodporují.
Schémata mohou podporovat pouze jeden obor názvů; nepodporují kolekce schémat.
Poznámka
Zdroj XML neověřuje data v souboru XML proti XSD.
Editor zdrojového kódu XML
Data v souborech XML často zahrnují hierarchické relace. editoru zdrojů XML dialogové okno používá zadané schéma k vygenerování zdrojových výstupů XML. Můžete zadat soubor XSD, použít vložené schéma nebo vygenerovat XSD ze zadaného datového souboru XML. Schéma musí být k dispozici v době návrhu.
Zdroj XML generuje tabulkové struktury z dat XML vytvořením výstupu pro každý prvek, který obsahuje další prvky v souborech XML. Pokud například data XML představují katalogy a položky v katalogech, vytvoří zdroj XML výstup pro katalogy a výstup pro každý typ položky, které katalogy obsahují. Výstup každé položky bude obsahovat výstupní sloupce pro atributy této položky.
Pokud chcete poskytnout informace o hierarchické relaci dat ve výstupech, zdroj XML přidá do výstupů sloupec, který identifikuje nadřazený prvek pro každý podřízený prvek. Při použití příkladu katalogů s různými typy položek by každá položka měla hodnotu sloupce, která identifikuje katalog, do kterého patří.
Zdroj XML vytvoří výstup pro každý prvek, ale není nutné použít všechny výstupy. Můžete odstranit jakýkoli výstup, který nechcete použít, nebo ho jen nepřipojit k podřízené komponentě.
Zdroj XML také generuje výstupní názvy, aby se zajistilo, že názvy jsou jednoznačné. Tyto názvy můžou být dlouhé a nemusí identifikovat výstupy způsobem, který je pro vás užitečný. Výstupy můžete přejmenovat, pokud jejich názvy zůstanou jedinečné. Můžete také upravit datový typ a délku výstupních sloupců.
Pro každý výstup přidá zdroj XML výstup chyby. Ve výchozím nastavení mají sloupce ve výstupech chyb datový typ řetězce Unicode (DT_WSTR) s délkou 255, ale sloupce ve výstupech chyb můžete nakonfigurovat úpravou jejich datového typu a délky.
Pokud datový soubor XML obsahuje prvky, které nejsou v XSD, budou tyto prvky ignorovány a pro ně se nevygeneruje žádný výstup. Na druhé straně, pokud datový soubor XML chybí prvky, které jsou reprezentovány v XSD, výstup bude obsahovat sloupce s hodnotami null.
Při extrahování dat z datového souboru XML se převedou na datový typ Integrační služby. Zdroj XML však nemůže převést data XML na datové typy DT_TIME2 nebo DT_DBTIMESTAMP2, protože zdroj tyto datové typy nepodporuje. Další informace najdete v tématu datové typy integračních služeb.
XSD nebo vložené schéma může určit datový typ prvků, ale pokud ne, dialogové okno Editor zdroje XML určuje řetězcový datový typ Unicode (DT_WSTR) výstupnímu sloupci, který obsahuje prvek, a nastavuje délku sloupce na 255 znaků.
Pokud schéma určuje maximální délku prvku, je délka výstupního sloupce nastavena na tuto hodnotu. Pokud je maximální délka větší než délka podporovaná datovým typem integrační služby, na který je prvek převeden, data se zkrátí na maximální délku datového typu. Pokud má například řetězec délku 5000, zkrátí se na 4 000 znaků, protože maximální délka datového typu DT_WSTR je 4 000 znaků; Podobně jsou bajtová data zkrácena na 8 000 znaků, maximální délka DT_BYTES datového typu. Pokud schéma neurčuje maximální délku, výchozí délka sloupců s oběma datovými typy je nastavena na 255. Zkrácení dat ve zdroji XML se zpracovává stejným způsobem jako zkrácení v jiných komponentách toku dat. Další informace najdete v části Zpracování chyb v datech v.
Datový typ a délku sloupce můžete upravit. Další informace najdete v tématu datové typy integračních služeb.
Konfigurace zdroje XML
Zdroj XML podporuje tři různé režimy přístupu k datům. Můžete zadat umístění souboru datového souboru XML, proměnnou obsahující umístění souboru nebo proměnnou, která obsahuje data XML.
Zdroj XML obsahuje XMLData a XMLSchemaDefinition vlastní vlastnosti, které lze při načtení balíčku aktualizovat pomocí výrazů nastavení. Další informace najdete v tématech výrazy služby Integration Services (SSIS), použití výrazů vlastností v balíčcícha vlastní vlastnosti pro zdroj XML.
Zdroj XML podporuje více běžných výstupů a více chybových výstupů.
Integrační služby SYSTÉMU SQL Server zahrnují dialogové okno editoru zdrojového kódu XML pro konfiguraci zdroje XML. Toto dialogové okno je k dispozici v nástroji SSIS Designer.
Vlastnosti můžete nastavit prostřednictvím návrháře SSIS nebo programově.
Dialogové okno Rozšířený editor odráží vlastnosti, které lze nastavit programově. Další informace o vlastnostech, které můžete nastavit v dialogovém okně Rozšířený editor nebo programově, klikněte na jedno z následujících témat:
Další informace o tom, jak nastavit vlastnosti, klikněte na jedno z následujících témat:
Editor zdrojového kódu XML (stránka Správce připojení)
Pomocí Správce připojení stránku editoru zdrojů XML určit soubor XML a XSD, který transformuje data XML.
Statické možnosti
režimu přístupu k datům
Zadejte metodu pro výběr dat ze zdroje.
| Hodnota | Popis |
|---|---|
| Umístění souboru XML | Načtěte data ze souboru XML. |
| Soubor XML z proměnné | Zadejte název souboru XML v proměnné. související informace: Použití proměnných v balíčcích |
| Data XML z proměnné | Načtěte data XML z proměnné. |
Použít vložené schéma
Určete, zda zdrojová data XML obsahují schéma XSD, které definuje a ověřuje jeho strukturu a data.
umístění XSD
Zadejte cestu a název souboru schématu XSD nebo vyhledejte soubor kliknutím na Procházet.
Procházet
Pomocí dialogového okna Otevřít vyhledejte soubor schématu XSD.
Generovat XSD
Pomocí dialogového okna Uložit jako vyberte umístění pro automaticky vygenerovaný soubor schématu XSD. Editor odvodí schéma ze struktury dat XML.
Dynamické možnosti režimu přístupu k datům
Režim přístupu k datům = umístění souboru XML
umístění XML
Zadejte cestu a název datového souboru XML nebo soubor vyhledejte kliknutím na Procházet.
Procházet
Pomocí dialogového okna Otevřít vyhledejte datový soubor XML.
Režim přístupu k datům = soubor XML z proměnné
název proměnné
Vyberte proměnnou, která obsahuje cestu a název souboru XML.
Režim přístupu k datům = data XML z proměnné
název proměnné
Vyberte proměnnou, která obsahuje data XML.
Editor zdrojového kódu XML (stránka sloupců)
Pomocí sloupců uzlu editoru zdrojů XML namapujte výstupní sloupec na externí (zdrojový) sloupec.
Možnosti
dostupné externí sloupce
Zobrazí seznam dostupných externích sloupců ve zdroji dat. Tuto tabulku nelze použít k přidání nebo odstranění sloupců.
externí sloupec
Umožňuje zobrazit externí (zdrojové) sloupce v pořadí, ve kterém je úkol přečte. Toto pořadí můžete změnit tak, že nejprve vymažete vybrané sloupce v tabulce zobrazené v editoru a pak vyberete externí sloupce ze seznamu v jiném pořadí.
výstupního sloupce
Zadejte jedinečný název pro každý výstupní sloupec. Výchozí hodnota je název vybraného externího (zdrojového) sloupce; můžete ale zvolit libovolný jedinečný popisný název. Zadaný název se zobrazí v návrháři SSIS.
Editor zdrojového kódu XML (stránka výstupu chyby)
Pomocí stránky Výstup chyby dialogového okna editoru zdrojového kódu XML vyberte možnosti zpracování chyb a nastavte vlastnosti ve sloupcích výstupu chyby.
Možnosti
vstupní/výstupní
Zobrazí název zdroje dat.
sloupce
Zobrazte externí (zdrojové) sloupce, které jste vybrali na stránce správce připojení
Chyba
Určete, co se má stát, když dojde k chybě: ignorování selhání, přesměrování řádku nebo selhání komponenty.
Související témata:zpracování chyb v datech
zkrácení
Určete, co se má stát, když dojde ke zkrácení: ignorujte selhání, přesměrujte řádek nebo ukončete činnost komponenty.
popis
Zobrazte popis chyby.
Nastavit tuto hodnotu pro vybrané buňky
Určete, co se má stát se všemi vybranými buňkami, když dojde k chybě nebo zkrácení: ignorovat chybu, přesměrovat řádek nebo selhání součásti.
Použít
Použití možnosti zpracování chyb u vybraných buněk