XML-källa
gäller för:
SQL Server SSIS Integration Runtime i Azure Data Factory
XML-källan läser en XML-datafil och fyller kolumnerna i källutdata med data.
Data i XML-filer innehåller ofta hierarkiska relationer. En XML-datafil kan till exempel representera kataloger och objekt i kataloger. Innan data kan komma in i dataflödet måste relationen mellan elementen i XML-datafilen fastställas och ett utdata måste genereras för varje element i filen.
Scheman
XML-källan använder ett schema för att tolka XML-data. XML-källan stöder användning av en XML-schemadefinitionsfil (XSD) eller infogade scheman för att översätta XML-data till ett tabellformat. Om du konfigurerar XML-källan med hjälp av dialogrutan XML-källredigeraren kan användargränssnittet generera en XSD från den angivna XML-datafilen.
Obs
DTD:er stöds inte.
Schemana kan endast ha stöd för ett enda namnområde. de stöder inte schemasamlingar.
Not
XML-källan verifierar inte data i XML-filen mot XSD.
XML-källredigeraren
Data i XML-filerna innehåller ofta hierarkiska relationer. Dialogrutan XML-källredigeraren använder det angivna schemat för att generera XML-källutdata. Du kan ange en XSD-fil, använda ett infogat schema eller generera en XSD från den angivna XML-datafilen. Schemat måste vara tillgängligt vid designtillfället.
XML-källan genererar tabellstrukturer från XML-data genom att skapa utdata för varje element som innehåller andra element i XML-filerna. Om XML-data till exempel representerar kataloger och objekt i kataloger skapar XML-källan utdata för kataloger och utdata för varje typ av objekt som katalogerna innehåller. Utdata för varje objekt innehåller utdatakolumner för objektets attribut.
Om du vill ange information om den hierarkiska relationen mellan data i utdata lägger XML-källan till en kolumn i utdata som identifierar det överordnade elementet för varje underordnat element. Med hjälp av exemplet med kataloger med olika typer av objekt skulle varje objekt ha ett kolumnvärde som identifierar katalogen som det tillhör.
XML-källan skapar utdata för varje element, men det krävs inte att du använder alla utdata. Du kan ta bort alla utdata som du inte vill använda, eller bara inte ansluta dem till en underordnad komponent.
XML-källan genererar också utdatanamnen för att säkerställa att namnen är entydiga. Dessa namn kan vara långa och kanske inte identifierar utdata på ett sätt som är användbart för dig. Du kan byta namn på utdata så länge deras namn förblir unika. Du kan också ändra datatypen och längden på utdatakolumnerna.
För varje utdata lägger XML-källan till ett felutdata. Som standard har kolumnerna i felutdata Unicode-strängdatatypen (DT_WSTR) med en längd på 255, men du kan konfigurera kolumnerna i felutdata genom att ändra deras datatyp och längd.
Om XML-datafilen innehåller element som inte finns i XSD ignoreras dessa element och inga utdata genereras för dem. Om XML-datafilen däremot saknar element som representeras i XSD innehåller utdata kolumner med null-värden.
När data extraheras från XML-datafilen konverteras de till en Integration Services-datatyp. XML-källan kan dock inte konvertera XML-data till DT_TIME2 eller DT_DBTIMESTAMP2 datatyper eftersom källan inte stöder dessa datatyper. Mer information finns i Integration Services-datatyper.
XSD- eller inbyggt schema kan ange datatypen för element, men om det inte gör det, tilldelar dialogrutan XML-källredigeraren Unicode-strängdatatypen (DT_WSTR) till kolumnen i utdata som innehåller det här elementet, och anger kolumnlängden till 255 tecken.
Om schemat anger den maximala längden på ett element anges längden på utdatakolumnen till det här värdet. Om den maximala längden är större än den längd som stöds av datatypen Integration Services som elementet konverteras till trunkeras data till datatypens maximala längd. Om en sträng till exempel har en längd på 5 000 trunkeras den till 4 000 tecken eftersom den maximala längden på den DT_WSTR datatypen är 4 000 tecken. på samma sätt trunkeras bytedata till 8 000 tecken, den maximala längden på den DT_BYTES datatypen. Om schemat inte anger någon maximal längd anges standardlängden för kolumner med någon av datatyperna till 255. Datatrunkering i XML-källan hanteras på samma sätt som trunkering i andra dataflödeskomponenter. Mer information finns i Felhantering i Data.
Du kan ändra datatypen och kolumnlängden. Mer information finns i Integration Services-datatyper.
Konfiguration av XML-källan
XML-källan stöder tre olika dataåtkomstlägen. Du kan ange filplatsen för XML-datafilen, variabeln som innehåller filplatsen eller variabeln som innehåller XML-data.
XML-källan innehåller XMLData och XMLSchemaDefinition anpassade egenskaper som kan uppdateras av egenskapsuttryck när paketet läses in. Mer information finns i Integration Services (SSIS)-uttryck, Använd egenskapsuttryck i paketoch XML-källaens anpassade egenskaper.
XML-källan stöder flera vanliga utdata och flera felutdata.
SQL Server Integration Services innehåller dialogrutan XML-källredigeraren för att konfigurera XML-källan. Den här dialogrutan är tillgänglig i SSIS Designer.
Du kan ange egenskaper via SSIS Designer eller programmatiskt.
Dialogrutan Avancerad redigerare visar de egenskaper som kan anges programmatiskt. Om du vill ha mer information om de egenskaper som du kan ange i dialogrutan Avancerad redigerare eller programmatiskt klickar du på något av följande avsnitt:
Om du vill ha mer information om hur du anger egenskaperna klickar du på något av följande avsnitt:
XML-källredigeraren (Anslutningshanterarens sida)
Använd sidan Anslutningshanteraren i XML-källredigeraren för att ange en XML-fil och XSD som transformerar XML-data.
Statiska alternativ
Dataåtkomstläge
Ange metoden för att välja data från källan.
| Värde | Beskrivning |
|---|---|
| XML-filplats | Hämta data från en XML-fil. |
| XML-fil från variabel | Ange XML-filnamnet i en variabel. relaterad information: Använda variabler i paket |
| XML-data från variabel | Hämta XML-data från en variabel. |
Använd infogat schema
Ange om själva XML-källdata innehåller XSD-schemat som definierar och validerar dess struktur och data.
XSD-lokalisering
Skriv sökvägen och filnamnet för XSD-schemafilen eller leta upp filen genom att klicka på Bläddra.
Bläddra
Använd dialogrutan Öppna för att hitta XSD-schemafilen.
generera XSD-
Använd dialogrutan Spara som för att välja en plats för den automatiskt genererade XSD-schemafilen. Redigeraren härleder schemat från STRUKTUREN för XML-data.
Dynamiska alternativ för dataåtkomstläge
Dataåtkomstläge = XML-filplats
XML-plats
Skriv sökvägen och filnamnet för XML-datafilen eller leta upp filen genom att klicka på Bläddra.
Bläddra
Använd dialogrutan Öppna för att hitta XML-datafilen.
Dataåtkomstläge = XML-fil från variabel
variabelnamn
Välj variabeln som innehåller sökvägen och filnamnet för XML-filen.
Dataåtkomstläge = XML-data från variabel
variabelnamn
Välj variabeln som innehåller XML-data.
XML-källredigeraren (sidan Kolumner)
Använd kolumner noden i dialogrutan XML-källredigeraren för att mappa en utdatakolumn till en extern kolumn (källa).
Alternativ
tillgängliga externa kolumner
Visa listan över tillgängliga externa kolumner i datakällan. Du kan inte använda den här tabellen för att lägga till eller ta bort kolumner.
extern kolumn
Visa externa kolumner (källa) i den ordning aktiviteten läser dem. Du kan ändra den här ordningen genom att först rensa de markerade kolumnerna i tabellen som visas i redigeraren och sedan välja externa kolumner i listan i en annan ordning.
Utdatakolumn
Ange ett unikt namn för varje utdatakolumn. Standardvärdet är namnet på den valda externa kolumnen (källa). Du kan dock välja valfritt unikt, beskrivande namn. Det angivna namnet visas i SSIS Designer.
XML-källredigeraren (felutmatningssida)
Använd sidan Felutdata i dialogrutan XML-källredigeraren för att välja alternativ för felhantering och ange egenskaper för felutdatakolumner.
Alternativ
Input/Output
Visa namnet på datakällan.
kolumn
Visa de externa kolumner (källa) som du har valt på sidan Anslutningshanteraren i dialogrutan XML-källredigeraren.
Fel
Ange vad som ska hända när ett fel inträffar: ignorera felet, omdirigera raden eller fela komponenten.
Relaterade ämnen:felhantering i data
Trunkering
Ange vad som ska hända när en trunkering inträffar: ignorera misslyckandet, omdirigera raden eller göra så att komponenten misslyckas.
Beskrivning
Visa beskrivningen av felet.
Ange det här värdet till markerade celler
Ange vad som ska hända med alla markerade celler när ett fel eller avkortning inträffar: ignorera felet, omdirigera raden, eller låta komponenten misslyckas.
Tillämpa
Använd alternativet för felhantering för de markerade cellerna.