ODBC-bestemming
van toepassing op:
SQL Server SSIS Integration Runtime in Azure Data Factory
De ODBC-bestemming laadt gegevens bulksgewijs in databasetabellen die door ODBC worden ondersteund. De ODBC-bestemming maakt gebruik van een ODBC-verbindingsbeheer om verbinding te maken met de gegevensbron.
Een ODBC-bestemming bevat toewijzingen tussen invoerkolommen en kolommen in de doeldatabron. U hoeft geen invoerkolommen toe te wijzen aan alle doelkolommen, maar afhankelijk van de eigenschappen van de doelkolommen kunnen er fouten optreden als er geen invoerkolommen zijn toegewezen aan de doelkolommen. Als een doelkolom bijvoorbeeld geen null-waarden toestaat, moet een invoerkolom worden toegewezen aan die kolom. Daarnaast kunnen kolommen van verschillende typen worden toegewezen, maar als de invoergegevens niet compatibel zijn voor het doelkolomtype, treedt er een fout op tijdens runtime. Afhankelijk van de instelling voor foutgedrag wordt de fout genegeerd, veroorzaakt een fout of wordt de rij verzonden naar de foutuitvoer.
De ODBC-bestemming heeft één normale uitvoer en één foutuitvoer.
Laadopties
De ODBC-bestemming kan een van de twee laadmodules voor toegang gebruiken. U stelt de modus in de ODBC-Source Editor (de verbindingsbeheerpagina) in. De twee modi zijn:
Batch-: In deze modus probeert de ODBC-bestemming de meest efficiënte invoegmethode te gebruiken op basis van de mogelijkheden van de ODBC-provider. Voor de meeste moderne ODBC-providers betekent dit dat u een INSERT-instructie met parameters voorbereidt en vervolgens een matrixparameterbinding gebruikt (waarbij de matrixgrootte wordt beheerd door de eigenschap BatchSize). Als u Batch- selecteert en wanneer de provider deze methode niet ondersteunt, schakelt de ODBC-bestemming automatisch over naar de rij-voor-rij-modus.
Rij-per-rij: In deze modus bereidt de ODBC-bestemming een INSERT-instructie met parameters voor en gebruikt SQL Execute om de rijen één voor één aan toe te voegen.
Foutafhandeling
De ODBC-bestemming heeft een foutuitvoer. De foutuitvoer van het onderdeel bevat de volgende uitvoerkolommen:
foutcode: het getal dat overeenkomt met de huidige fout. Raadpleeg de documentatie voor uw brondatabase voor een lijst met fouten. Zie de SSIS-foutcode en berichtreferentie voor een lijst met SSIS-foutcodes.
foutkolom: de bronkolom die de fout veroorzaakt (voor conversiefouten).
De standaard uitvoergegevenskolommen.
Afhankelijk van de instelling voor foutgedrag ondersteunt de ODBC-bestemming het retourneren van fouten (gegevensconversie, afkapping) die optreden tijdens het extractieproces in de foutuitvoer. Zie ODBC-broneditor (foutuitvoerpagina)voor meer informatie.
Parallellisme
Er is geen beperking voor het aantal ODBC-doelonderdelen dat parallel kan worden uitgevoerd voor dezelfde tabel of verschillende tabellen, op dezelfde computer of op verschillende computers (behalve normale algemene sessielimieten).
Beperkingen van de ODBC-provider die worden gebruikt, kunnen echter het aantal gelijktijdige verbindingen via de provider beperken. Deze beperkingen beperken het aantal ondersteunde parallelle exemplaren dat mogelijk is voor de ODBC-bestemming. De SSIS-ontwikkelaar moet zich bewust zijn van de beperkingen van elke gebruikte ODBC-provider en deze in overweging nemen bij het bouwen van SSIS-pakketten.
U moet er ook rekening mee houden dat gelijktijdig laden in dezelfde tabel de prestaties kan verminderen vanwege standaardrecordvergrendeling. Dit is afhankelijk van de gegevens die worden geladen en van de tabelorganisatie.
Problemen met de ODBC-bestemming oplossen
U kunt de aanroepen die de ODBC-bron doet, registreren bij externe gegevensproviders. U kunt deze logboekregistratiefunctie gebruiken om problemen met het opslaan van gegevens op te lossen in externe gegevensbronnen die door de ODBC-bestemming worden uitgevoerd. Als u de aanroepen wilt registreren die door de ODBC-bestemming worden uitgevoerd bij externe gegevensproviders, schakelt u de tracering van ODBC-stuurprogrammabeheer in. Voor meer informatie, zie de Microsoft-documentatie over Hoe een ODBC-trace te genereren met de ODBC-gegevensbronbeheerder.
De ODBC-bestemming configureren
U kunt de ODBC-bestemming programmatisch of via SSIS Designer configureren
Zie een van de volgende onderwerpen voor meer informatie:
Het dialoogvenster Geavanceerde editor bevat de eigenschappen die programmatisch kunnen worden ingesteld.
Om het dialoogvenster Geavanceerde editor te openen:
- Klik in het Dataflow scherm van uw SSIS-project (SQL Server 2019 Integration Services) met de rechtermuisknop op de ODBC-bestemming en selecteer Geavanceerde editor weergeven.
Zie ODBC-doel aangepaste eigenschappenvoor meer informatie over de instellingen die u kunt uitvoeren in het dialoogvenster Geavanceerde editor.
In deze sectie
ODBC-doeleditor (pagina Verbindingsbeheer)
Gebruik de pagina Verbindingsbeheer van de ODBC-doeleditor om het ODBC-verbindingsbeheer voor de bestemming te selecteren. Op deze pagina kunt u ook een tabel of weergave selecteren in de database
De pagina Verbindingsbeheer voor ODBC-doeleditor openen
Takenlijst
Open in SQL Server Data Tools het SSIS-pakket (SQL Server 2019 Integration Services) met de ODBC-bestemming.
Dubbelklik op het tabblad Gegevensstroom op de ODBC-bestemming.
Klik in de ODBC-doeleditorop verbindingsbeheer.
Opties
Verbindingsbeheer
Selecteer een bestaand ODBC-verbindingsbeheer in de lijst of klik op Nieuw om een nieuwe verbinding te maken. De verbinding kan worden gemaakt met elke database die door ODBC wordt ondersteund.
Nieuw
Klik op Nieuw. De ODBC Connection Manager Editor configureren dialoogvenster wordt geopend waarin u een nieuw verbindingsbeheer kunt maken.
Gegevenstoegangsmodus
Selecteer de methode voor het laden van gegevens naar de bestemming. De opties worden weergegeven in de volgende tabel:
| Optie | Beschrijving |
|---|---|
| Tabelnaam - Batch | Selecteer deze optie om de ODBC-bestemming zo te configureren dat deze werkt in de batchmodus. Wanneer u deze optie selecteert, zijn de volgende opties beschikbaar: |
|
Naam van de tabel of de weergave: Selecteer een beschikbare tabel of weergave in de lijst. Deze lijst bevat alleen de eerste 1000 tabellen. Als uw database meer dan 1000 tabellen bevat, kunt u het begin van een tabelnaam typen of de jokerteken (*) gebruiken om een deel van de naam in te voeren om de tabel of tabellen weer te geven die u wilt gebruiken. batchgrootte: typ de grootte van de batch voor bulksgewijs laden. Dit is het aantal rijen dat als batch is geladen |
|
| Tabelnaam - rij per rij | Selecteer deze optie om de ODBC-bestemming te configureren om elk van de rijen in de doeltabel één voor één in te voegen. Wanneer u deze optie selecteert, is de volgende optie beschikbaar: |
|
Naam van de tabel of de weergave: Selecteer een beschikbare tabel of weergave uit de database in de lijst. Deze lijst bevat alleen de eerste 1000 tabellen. Als uw database meer dan 1000 tabellen bevat, kunt u het begin van een tabelnaam typen of de jokerteken (*) gebruiken om een deel van de naam in te voeren om de tabel of tabellen weer te geven die u wilt gebruiken. |
Voorbeeld
Klik op Voorbeeld om maximaal 200 rijen met gegevens weer te geven voor de tabel die u hebt geselecteerd.
ODBC-doeleditor (toewijzingenpagina)
Gebruik de pagina Toewijzingen van het dialoogvenster ODBC-doelbewerkingsprogramma om invoerkolommen toe te wijzen aan doelkolommen.
Opties
Beschikbare invoerkolommen
De lijst met beschikbare invoerkolommen. Sleep een invoerkolom naar een beschikbare doelkolom om de kolommen te koppelen.
Beschikbare doelkolommen
De lijst met beschikbare doelkolommen. Sleep een doelkolom naar een beschikbare invoerkolom om de kolommen te koppelen.
Invoerkolom
Bekijk de invoerkolommen die u hebt geselecteerd. U kunt toewijzingen verwijderen door <> negeren om kolommen uit te sluiten van de uitvoer.
Doelkolom
Bekijk alle beschikbare doelkolommen, zowel toegewezen als niet-toegewezen.
ODBC-doeleditor (foutuitvoerpagina)
Gebruik de pagina Foutuitvoer van het dialoogvenster ODBC-doel editor om opties voor foutafhandeling te selecteren.
De foutenuitvoerpagina van de ODBC-doeleditor openen
Takenlijst
Open in SQL Server Data Tools het SSIS-pakket (SQL Server 2019 Integration Services) met de ODBC-bestemming.
Dubbelklik in het tabblad Gegevensstroom op de ODBC-bestemming.
Klik in de ODBC-bestemmingseditorop Foutuitvoer.
Opties
Invoer/uitvoer
Bekijk de naam van de gegevensbron.
Kolom
Niet gebruikt.
Fout
Kies hoe de ODBC-bestemming fouten in een gegevensstroom moet verwerken: negeer de fout, leid de rij om, of laat het onderdeel mislukken.
Truncatie
Selecteer hoe de ODBC-bestemming afkorten in een datastroom moet verwerken: negeer de fout, verwijs de rij om of laat de component falen.
Beschrijving
Bekijk een beschrijving van de fout.
Deze waarde instellen op geselecteerde cellen
Selecteer hoe de ODBC-bestemming alle geselecteerde cellen moet verwerken wanneer er een fout of afkapping optreedt: negeer de fout, leid de rij om, of laat het onderdeel mislukken.
Toepassen
Pas de opties voor foutafhandeling toe op de geselecteerde cellen.
Opties voor foutafhandeling
U gebruikt de volgende opties om te configureren hoe de ODBC-bestemming fouten en afkappingen verwerkt.
Onderdeel mislukt
De gegevensstroomtaak mislukt wanneer er een fout of afkapping optreedt. Dit is het standaardgedrag.
Fout negeren
De fout of de afkorting wordt genegeerd.
Omleidingsstroom
De rij die de fout of de afkorting veroorzaakt, wordt omgeleid naar de foutuitvoer van het ODBC-doel. Zie ODBC-bestemming voor meer informatie.