Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
              van toepassing op:SQL Server
 SSIS Integration Runtime in Azure Data Factory
De ADO NET-bron verbruikt gegevens van een .NET-provider en maakt de gegevens beschikbaar voor de gegevensstroom.
U kunt de ADO NET-bron gebruiken om verbinding te maken met Microsoft Azure SQL Database. Verbinding maken met SQL Database met behulp van OLE DB wordt niet ondersteund. Zie Algemene richtlijnen en beperkingen (Azure SQL Database) voor meer informatie over SQL Database.
Ondersteuning voor gegevenstypen
De bron zet elk gegevenstype dat niet overeenkomt met een specifiek Integration Services-gegevenstype om naar het Integration Services-gegevenstype DT_NTEXT. Deze conversie vindt zelfs plaats als het gegevenstype System.Object is.
U kunt het gegevenstype DT_NTEXT wijzigen in DT_WSTR, of DT_WSTR wijzigen in DT_NTEXT. U wijzigt gegevenstypen door de eigenschap DataType in te stellen in het dialoogvenster Geavanceerde editor van de ADO NET-bron. Zie Algemene eigenschappen voor meer informatie.
Het DT_NTEXT gegevenstype kan ook worden geconverteerd naar het DT_BYTES of DT_STR gegevenstype met behulp van een gegevensconversietransformatie na de ADO NET-bron. Zie Gegevensconversietransformatievoor meer informatie.
In Integration Services worden de datumgegevenstypen, DT_DBDATE, DT_DBTIME2, DT_DBTIMESTAMP2 en DT_DBTIMESTAMPOFFSET, toegewezen aan bepaalde datumgegevenstypen in SQL Server. U kunt de ADO NET-bron configureren om de datumgegevenstypen te converteren van de gegevenstypen die door SQL Server worden gebruikt naar de gegevenstypen die door Integration Services worden gebruikt. Als u de ADO NET-bron wilt configureren om deze datumgegevenstypen te converteren, stelt u de eigenschap Systeemversie van het type van het ADO.NET verbindingsbeheer in op Meest recente. (De eigenschap Type systeemversie bevindt zich op de pagina Alle van het dialoogvenster Verbindingsbeheer . Als u het dialoogvenster Verbindingsbeheer wilt openen, klikt u met de rechtermuisknop op het ADO.NET verbindingsbeheer en klikt u op Bewerken.)
Opmerking
Als de eigenschap Type System Version voor het ADO.NET verbindingsbeheer is ingesteld op SQL Server 2005, converteert het systeem de datumgegevenstypen van SQL Server naar DT_WSTR.
Het systeem converteert door de gebruiker gedefinieerde gegevenstypen (UDT's) naar binaire grote objecten van Integration Services (BLOB) wanneer het ADO.NET verbindingsbeheer de provider opgeeft als de .NET-gegevensprovider voor SQL Server (SqlClient). Het systeem past de volgende regels toe wanneer het UDT-gegevenstype wordt geconverteerd:
Als de gegevens een niet-grote UDT zijn, converteert het systeem de gegevens naar DT_BYTES.
Als de gegevens een niet-grote UDT zijn en de eigenschap Lengte van de kolom in de database is ingesteld op -1 of een waarde groter dan 8000 bytes, worden de gegevens door het systeem geconverteerd naar DT_IMAGE.
Als de gegevens een grote UDT zijn, converteert het systeem de gegevens naar DT_IMAGE.
Opmerking
Als de ADO NET-bron niet is geconfigureerd voor het gebruik van foutuitvoer, worden de gegevens door het systeem naar de kolom DT_IMAGE gestreamd in segmenten van 8000 bytes. Als de ADO NET-bron is geconfigureerd voor het gebruik van foutuitvoer, geeft het systeem de hele matrix van bytes door aan de kolom DT_IMAGE. Zie Foutafhandeling in gegevens voor meer informatie over het configureren van onderdelen voor het gebruik van foutuitvoer.
Voor meer informatie over de Integration Services-gegevenssoorten, de ondersteunde conversies van gegevenssoorten en toewijzingen van gegevenssoorten over bepaalde databases, inclusief SQL Server, zie Integration Services Data Types.
Zie Werken met gegevenstypen in de gegevensstroom voor informatie over het toewijzen van Integration Services-gegevenstypen aan beheerde gegevenstypen.
Problemen met ADO NET-bron oplossen
U kunt de aanroepen die de ADO NET-bron uitvoert, registreren bij externe gegevensproviders. U kunt deze logboekregistratiefunctie gebruiken om problemen met het laden van gegevens uit externe gegevensbronnen op te lossen die door de ADO NET-bron worden uitgevoerd. Als u de aanroepen wilt registreren die door de ADO NET-bron naar externe gegevensproviders worden uitgevoerd, schakelt u pakketregistratie in en selecteert u de diagnostische gebeurtenis op pakketniveau. Zie Hulpprogramma's voor probleemoplossing voor pakketuitvoering voor meer informatie.
ADO NET-bronconfiguratie
U configureert de ADO NET-bron door de SQL-instructie op te geven waarmee de resultatenset wordt gedefinieerd. Een ADO NET-bron die verbinding maakt met de AdventureWorks2022 database en de SQL-instructie SELECT * FROM Production.Product gebruikt, extraheert bijvoorbeeld alle rijen uit de tabel Production.Product en levert de gegevensset aan een downstreamonderdeel.
Opmerking
Wanneer u een SQL-instructie gebruikt om een opgeslagen procedure aan te roepen die resultaten van een tijdelijke tabel retourneert, gebruikt u de optie WITH RESULT SETS om metagegevens voor de resultatenset te definiëren.
Opmerking
Als u een SQL-instructie gebruikt om een opgeslagen procedure uit te voeren en het pakket mislukt met de volgende fout, kunt u de fout mogelijk oplossen door de INSTRUCTIE SET FMTONLY OFF toe te voegen vóór de exec-instructie.
Kolom <column_name> kan niet worden gevonden in de gegevensbron.
De ADO NET-bron maakt gebruik van een ADO.NET verbindingsbeheer om verbinding te maken met een gegevensbron en de verbindingsbeheerder geeft de .NET-provider op. Zie ADO.NET Connection Manager voor meer informatie.
De ADO NET-bron heeft één normale uitvoer en één foutuitvoer.
U kunt eigenschappen instellen via SSIS Designer of programmatisch.
Klik op een van de volgende onderwerpen voor meer informatie over de eigenschappen die u kunt instellen in het dialoogvenster Geavanceerde editor of programmatisch:
Zie Eigenschappen van een gegevensstroomonderdeel instellen voor meer informatie over het instellen van eigenschappen.
ADO NET-broneditor (pagina Verbindingsbeheer)
Gebruik de pagina Verbindingsbeheer van het dialoogvenster ADO NET-broneditor om het ADO.NET verbindingsbeheer voor de bron te selecteren. Op deze pagina kunt u ook een tabel of weergave in de database selecteren.
Zie ADO NET-bron voor meer informatie over de ADO NET-bron.
De pagina Verbindingsbeheer openen
Open in SQL Server Data Tools (SSDT) het Integration Services-pakket met de ADO NET-bron.
Dubbelklik op het tabblad Gegevensstroom op de ADO NET-bron.
Klik in de ADO NET-broneditor op Verbindingsbeheer.
Statische opties
              ADO.NET verbindingsbeheer
Selecteer een bestaand verbindingsbeheer in de lijst of maak een nieuwe verbinding door op Nieuw te klikken.
              Nieuw
Maak een nieuw verbindingsbeheer met behulp van het dialoogvenster ADO.NET Verbindingsbeheer configureren .
              gegevenstoegangsmodus
Geef de methode op voor het selecteren van gegevens uit de bron.
| Optie | Beschrijving | 
|---|---|
| Tabel of weergave | Gegevens ophalen uit een tabel of weergave in de ADO.NET gegevensbron. | 
| SQL-opdracht | Gegevens ophalen uit de ADO.NET gegevensbron met behulp van een SQL-query. | 
              Voorbeeld
Bekijk een voorbeeld van de resultaten door het dialoogvenster gegevensweergave te gebruiken. 
              Preview kan maximaal 200 rijen weergeven.
Opmerking
Wanneer u een voorbeeld van gegevens bekijkt, bevatten kolommen met een door de gebruiker gedefinieerd CLR-type geen gegevens. In plaats daarvan is de waarde van de waarden <te groot om weer te geven> of system.Byte[] weer te geven. De vorige wordt weergegeven wanneer de gegevensbron wordt geopend met behulp van de ADO.NET-provider, de laatste wanneer de SQL Server Native Client-provider wordt gebruikt.
Dynamische opties voor gegevenstoegangsmodus
Gegevenstoegangsmodus = Tabel of weergave
              Naam van de tabel of de weergave
Selecteer de naam van de tabel of weergave in een lijst met de tabellen die beschikbaar zijn in de gegevensbron.
Gegevenstoegangsmodus = SQL-opdracht
              SQL-opdrachttekst
Voer de tekst van een SQL-query in, bouw de query door op BuildQuery te klikken of zoek het bestand dat de querytekst bevat door op Bladeren te klikken.
              Buildquery
Gebruik het dialoogvenster Opbouwfunctie voor query's om de SQL-query visueel samen te stellen.
              navigeren
Gebruik het dialoogvenster Openen om het bestand te zoeken dat de tekst van de SQL-query bevat.
ADO NET-broneditor (Kolommenpagina)
Gebruik de pagina Kolommen van het dialoogvenster ADO NET-broneditor om een uitvoerkolom toe te wijzen aan elke externe (bron) kolom.
Zie ADO NET-bron voor meer informatie over de ADO NET-bron.
De pagina Kolommen openen
Open in SQL Server Data Tools (SSDT) het Integration Services-pakket met de ADO NET-bron.
Dubbelklik op het tabblad Gegevensstroom op de ADO NET-bron.
Klik in de ADO NET-broneditor op Kolommen.
Opties
              beschikbare externe kolommen
Bekijk de lijst met beschikbare externe kolommen in de gegevensbron. U kunt deze tabel niet gebruiken om kolommen toe te voegen of te verwijderen.
              Externe Kolom
Bekijk externe (bron)kolommen in de volgorde waarin u ze ziet wanneer u onderdelen configureert die gegevens uit deze bron verbruiken.
              Uitvoerkolom
Geef een unieke naam op voor elke uitvoerkolom. De standaardwaarde is de naam van de geselecteerde externe kolom (bronkolom; U kunt echter elke unieke, beschrijvende naam kiezen. De opgegeven naam wordt weergegeven in de SSIS Designer.
ADO NET-broneditor (Foutuitvoerpagina)
Gebruik de pagina Foutuitvoer van het dialoogvenster ADO NET-broneditor om opties voor foutafhandeling te selecteren en eigenschappen in te stellen voor kolommen voor foutuitvoer.
Zie ADO NET-bron voor meer informatie over de ADO NET-bron.
De pagina Foutuitvoer openen
Open in SQL Server Data Tools (SSDT) het Integration Services-pakket met de ADO NET-bron.
Dubbelklik op het tabblad Gegevensstroom op de ADO NET-bron.
Klik in de ADO NET-broneditor op Foutuitvoer.
Opties
              Invoer/Uitvoer
Bekijk de naam van de gegevensbron.
              kolom
Bekijk de externe (bron)kolommen die u hebt geselecteerd op de pagina Verbindingsbeheer van het dialoogvenster ADO NET-broneditor .
              Fout
Geef op wat er moet gebeuren wanneer er een fout optreedt: de fout negeren, de rij omleiden of het onderdeel mislukken.
verwante onderwerpen:foutafhandeling in gegevens
              Afkorting
Geef op wat er moet gebeuren wanneer er een afkapping plaatsvindt: de fout negeren, de rij omleiden of het onderdeel laten falen.
              Beschrijving
Bekijk de beschrijving van de fout.
              deze waarde instellen op geselecteerde cellen
Geef op wat er moet gebeuren met alle geselecteerde cellen wanneer er een fout of truncatie optreedt: negeer de fout, leid de rij om, of laat het onderdeel falen.
              Toepassen
Pas de foutafhandelingsoptie toe op de geselecteerde cellen.