ADO NET-källa

gäller för:SQL Server SSIS Integration Runtime i Azure Data Factory

ADO NET-källan använder data från en .NET-provider och gör data tillgängliga för dataflödet.

Du kan använda ADO NET-källan för att ansluta till Microsoft Azure SQL Database. Det går inte att ansluta till SQL Database med hjälp av OLE DB. Mer information om SQL Database finns i Allmänna riktlinjer och begränsningar (Azure SQL Database).

Stöd för datatyp

Källan konverterar alla datatyper som inte mappas till en specifik datatyp för Integration Services till datatypen DT_NTEXT Integration Services. Den här konverteringen sker även om datatypen är System.Object.

Du kan ändra DT_NTEXT datatyp till DT_WSTR datatyp eller ändra DT_WSTR till DT_NTEXT. Du ändrar datatyper genom att ange egenskapen DataType i dialogrutan Avancerad redigerare för ADO NET-källan. Mer information finns i Vanliga egenskaper.

Datatypen DT_NTEXT kan också konverteras till datatypen DT_BYTES eller DT_STR med hjälp av en omvandling av datakonvertering efter ADO NET-källan. Mer information finns i Omvandling av datakonvertering.

I Integration Services mappar datumdatatyperna DT_DBDATE, DT_DBTIME2, DT_DBTIMESTAMP2 och DT_DBTIMESTAMPOFFSET till vissa datumdatatyper i SQL Server. Du kan konfigurera ADO NET-källan för att konvertera datumdatatyperna från dem som SQL Server använder till dem som Integration Services använder. Om du vill konfigurera ADO NET-källan för att konvertera dessa datumdatatyper anger du egenskapen Typsystemversion för ADO.NET anslutningshanteraren till Senaste. (Egenskapen Typ systemversion finns på sidan Alla i dialogrutan Anslutningshanteraren . Om du vill öppna dialogrutan Anslutningshanteraren högerklickar du på ADO.NET anslutningshanteraren och klickar sedan på Redigera.)

Anmärkning

Om egenskapen Typ systemversion för ADO.NET anslutningshanteraren är inställd på SQL Server 2005 konverterar systemet SQL Server-datumdatatyperna till DT_WSTR.

Systemet konverterar användardefinierade datatyper (UDT) till Integration Services binära stora objekt (BLOB) när ADO.NET anslutningshanteraren anger providern som .NET Data Provider för SQL Server (SqlClient). Systemet tillämpar följande regler när udt-datatypen konverteras:

  • Om data är en icke-stor UDT konverterar systemet data till DT_BYTES.

  • Om data är en icke-stor UDT och egenskapen Längd för kolumnen i databasen är inställd på -1 eller ett värde som är större än 8 000 byte konverterar systemet data till DT_IMAGE.

  • Om data är en stor UDT konverterar systemet data till DT_IMAGE.

    Anmärkning

    Om ADO NET-källan inte har konfigurerats för att använda felutdata strömmar systemet data till kolumnen DT_IMAGE i segment på 8 000 byte. Om ADO NET-källan är konfigurerad för att använda felutdata skickar systemet hela bytematrisen till kolumnen DT_IMAGE. Mer information om hur du konfigurerar komponenter för att använda felutdata finns i Felhantering i Data.

Mer information om datatyperna Integration Services, datatypskonverteringar som stöds och datatypsmappning över vissa databaser, inklusive SQL Server, finns i Datatyper för Integration Services.

Information om hur du mappar Integration Services-datatyper till hanterade datatyper finns i Arbeta med datatyper i dataflödet.

Felsökning av ADO NET-källa

Du kan logga de anrop som ADO NET-källan gör till externa dataleverantörer. Du kan använda den här loggningsfunktionen för att felsöka inläsningen av data från externa datakällor som ADO NET-källan utför. Om du vill logga de anrop som ADO NET-källan gör till externa dataleverantörer aktiverar du paketloggning och väljer diagnostikhändelsen på paketnivå. Mer information finns i Felsökningsverktyg för paketkörning.

ADO NET-källkonfiguration

Du konfigurerar ADO NET-källan genom att ange SQL-instruktionen som definierar resultatuppsättningen. Till exempel extraherar en ADO NET-källa som ansluter till AdventureWorks2025 databasen och använder SQL-instruktionen SELECT * FROM Production.Product alla rader från tabellen Production.Product och tillhandahåller datamängden till en underordnad komponent.

Anmärkning

När du använder en SQL-instruktion för att anropa en lagrad procedur som returnerar resultat från en tillfällig tabell använder du alternativet WITH RESULT SETS för att definiera metadata för resultatuppsättningen.

Anmärkning

Om du använder en SQL-instruktion för att köra en lagrad procedur och paketet misslyckas med följande fel kanske du kan lösa felet genom att lägga till SET FMTONLY OFF-instruktionen före exec-instruktionen.

Det går inte att hitta kolumn <column_name> på datakällan.

ADO NET-källan använder en ADO.NET anslutningshanterare för att ansluta till en datakälla, och anslutningshanteraren anger .NET-providern. Mer information finns i ADO.NET Anslutningshanteraren.

ADO NET-källan har en normal utdata och en felutgång.

Du kan ange egenskaper via SSIS Designer eller 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:

Mer information om hur du anger egenskaper finns i Ange egenskaper för en dataflödeskomponent.

ADO NET-källredigeraren (anslutningshanterarsidan)

Använd sidan Anslutningshanteraren i dialogrutan ADO NET-källredigeraren för att välja ADO.NET anslutningshanteraren för källan. På den här sidan kan du också välja en tabell eller vy från databasen.

Mer information om ADO NET-källan finns i ADO NET-källa.

Så här öppnar du sidan Anslutningshanteraren

  1. I SQL Server Data Tools (SSDT) öppnar du Integration Services-paketet som har ADO NET-källan.

  2. Dubbelklicka på ADO NET-källan på fliken Dataflöde .

  3. I ADO NET-källredigeraren klickar du på Anslutningshanteraren.

Statiska alternativ

ADO.NET anslutningshanteraren
Välj en befintlig anslutningshanterare i listan eller skapa en ny anslutning genom att klicka på Ny.

Ny
Skapa en ny anslutningshanterare med hjälp av dialogrutan Konfigurera ADO.NET Anslutningshanteraren .

Dataåtkomstläge
Ange metoden för att välja data från källan.

Alternativ Beskrivning
Tabell eller vy Hämta data från en tabell eller vy i ADO.NET datakälla.
SQL-kommando Hämta data från ADO.NET datakälla med hjälp av en SQL-fråga.

Förhandsversion
Förhandsgranska resultat genom att använda dialogrutan Datavy. Förhandsgranskning kan visa upp till 200 rader.

Anmärkning

När du förhandsgranskar data innehåller kolumner med en CLR-användardefinierad typ inte data. Värdet <för stort för att visas> eller så visas System.Byte[]. Den förstnämnda visar när datakällan används med hjälp av ADO.NET-providern, den senare när du använder SQL Server Native Client-providern.

Dynamiska alternativ för dataåtkomstläge

Dataåtkomstläge = Tabell eller vy

Namnet på tabellen eller vyn
Välj namnet på tabellen eller vyn i en lista över de som är tillgängliga i datakällan.

Dataåtkomstläge = SQL-kommando

SQL-kommandotext
Ange texten i en SQL-fråga, skapa frågan genom att klicka på Skapa fråga eller leta upp filen som innehåller frågetexten genom att klicka på Bläddra.

Skapa fråga
Använd dialogrutan Query Builder för att skapa SQL-frågan visuellt.

Bläddra
Använd dialogrutan Öppna för att hitta filen som innehåller texten i SQL-frågan.

ADO NET-källredigeraren (kolumnsidan)

Använd sidan Kolumner i dialogrutan ADO NET-källredigeraren för att mappa en utdatakolumn till varje extern kolumn (källa).

Mer information om ADO NET-källan finns i ADO NET-källa.

Öppna sidan Kolumner

  1. I SQL Server Data Tools (SSDT) öppnar du Integration Services-paketet som har ADO NET-källan.

  2. Dubbelklicka på ADO NET-källan på fliken Dataflöde .

  3. I ADO NET-källredigeraren klickar du på Kolumner.

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 som du ser dem när du konfigurerar komponenter som använder data från den här källan.

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.

ADO NET-källredigeraren (felutdatasida)

Använd sidan Felutdata i dialogrutan ADO NET-källredigeraren för att välja alternativ för felhantering och ange egenskaper för felutdatakolumner.

Mer information om ADO NET-källan finns i ADO NET-källa.

Att öppna sidan Felutdata

  1. I SQL Server Data Tools (SSDT) öppnar du Integration Services-paketet som har ADO NET-källan.

  2. Dubbelklicka på ADO NET-källan på fliken Dataflöde .

  3. I ADO NET-källredigeraren klickar du på Felutdata.

Alternativ

Indata/utdata
Visa namnet på datakällan.

Kolumn
Visa de externa kolumner (källa) som du valde på sidan Anslutningshanteraren i dialogrutan ADO NET-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 felet, omdirigera raden eller låt 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.

Använda
Använd alternativet för felhantering för de markerade cellerna.

Se även

DataReader-mål
ADO.NET-destination
Dataflöde