Delen via


ODBC-bron

van toepassing op:SQL Server SSIS Integration Runtime in Azure Data Factory

De ODBC-bron extraheert gegevens uit een ODBC-ondersteunde database met behulp van een databasetabel, een weergave of een SQL-instructie.

De ODBC-bron heeft de volgende modi voor gegevenstoegang voor het extraheren van gegevens:

  • Een tabel of weergave.

  • De resultaten van een SQL-instructie.

De bron maakt gebruik van een ODBC-verbindingsbeheer, waarmee de provider wordt opgegeven die moet worden gebruikt.

Een ODBC-bron bevat de brongegevensuitvoerkolommen. Wanneer uitvoerkolommen in de ODBC-bestemming aan de doelkolommen zijn toegewezen, kunnen er fouten optreden als niet alle uitvoerkolommen aan de doelbestemmingen zijn gekoppeld. Kolommen van verschillende typen kunnen worden toegewezen, maar als de uitvoergegevens niet compatibel zijn voor de bestemming, treedt er tijdens runtime een fout op. Afhankelijk van het foutgedrag zal het instellen van de fout genegeerd worden, een falen veroorzaken, of de rij zal naar de foutuitvoer worden verzonden.

De ODBC-bron heeft één normale uitvoer en één foutuitvoer.

Foutafhandeling

De ODBC-bron 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 de odbc-ondersteunde database die u gebruikt 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-bron het retourneren van fouten (gegevensconversie, afkapping) die optreden tijdens het extractieproces in de foutuitvoer. Zie de ODBC-doeleditor (verbindingsbeheerpagina) voor meer informatie.

Ondersteuning voor gegevenstypen

Zie Connector for Open Database Connectivity (ODBC) voor informatie over de gegevenstypen die worden ondersteund door de ODBC-bron.

Opties om te extraheren

De ODBC-bron werkt in Batch- of Rij-op-Rijmodus. De gebruikte modus wordt bepaald door de eigenschap FetchMethod . In de volgende lijst worden de modi beschreven.

  • Batch: Het onderdeel probeert de meest efficiënte ophaalmethode te gebruiken op basis van de waargenomen MOGELIJKHEDEN van de ODBC-provider. Voor de meeste moderne ODBC-providers is dit SQLFetchScroll met matrixbinding (waarbij de matrixgrootte wordt bepaald 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.

  • Row-by Row: Het onderdeel maakt gebruik van SQLFetch om de rijen één voor één op te halen.

Zie ODBC Source Custom Properties voor meer informatie bij de eigenschap FetchMethod.

Parallellisme

Er is geen beperking voor het aantal ODBC-brononderdelen dat parallel kan worden uitgevoerd voor dezelfde tabel of verschillende tabellen, op dezelfde computer of op verschillende computers (behalve normale globale 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-bron. 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.

Problemen met de ODBC-bron oplossen

U kunt de aanroepen die de ODBC-bron doet, 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 ODBC-bron worden uitgevoerd. Als u de aanroepen wilt registreren die door de ODBC-bron worden uitgevoerd bij externe gegevensproviders, schakelt u de tracering van ODBC-stuurprogrammabeheer in. Voor meer informatie, zie de Microsoft-documentatie over hoe een ODBC-tracering te genereren met de ODBC-gegevensbronbeheerder.

De ODBC-bron configureren

U kunt de ODBC-bron programmatisch of via SSIS Designer configureren.

Het dialoogvenster Geavanceerde editor bevat de eigenschappen die programmatisch kunnen worden ingesteld.

Om het dialoogvenster Geavanceerde editor te openen:

  • Klik in het scherm Gegevensstroom van uw SSIS-project (SQL Server 2019 Integration Services) met de rechtermuisknop op de ODBC-bron en selecteer Geavanceerde editor weergeven.

Zie aangepaste eigenschappen van ODBC-bron voor meer informatie over de eigenschappen die u kunt instellen in het dialoogvenster Geavanceerde editor.

In deze sectie

ODBC-broneditor (pagina Verbindingsbeheer)

Gebruik de pagina Verbindingsbeheer van het dialoogvenster ODBC-broneditor om het ODBC-verbindingsbeheer voor de bron te selecteren. Op deze pagina kunt u ook een tabel of weergave in de database selecteren.

Takenlijst

De verbindingsbeheerpagina van de ODBC-broneditor openen

  • Open in SQL Server Data Tools het SSIS-pakket (SQL Server 2019 Integration Services) met de ODBC-bron.

  • Dubbelklik op het tabblad Gegevensstroom op de ODBC-bron.

Options

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. Het dialoogvenster ODBC Connection Manager-editor configureren wordt geopend, waar u een nieuw ODBC-verbindingsbeheer kunt maken.

Gegevenstoegangsmodus

Selecteer de methode voor het selecteren van gegevens uit de bron. De opties worden weergegeven in de volgende tabel:

Optie Description
Tabelnaam Gegevens ophalen uit een tabel of weergave in de ODBC-gegevensbron. Wanneer u deze optie selecteert, selecteert u een waarde in de lijst voor het volgende:
Naam van de tabel of de weergave: Selecteer een beschikbare tabel of weergave in de lijst of typ een reguliere expressie om de tabel te identificeren.
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.
SQL-opdracht Gegevens ophalen uit de ODBC-gegevensbron met behulp van een SQL-query. U moet de query schrijven in de syntaxis van de brondatabase waarmee u werkt. Wanneer u deze optie selecteert, voert u een query op een van de volgende manieren in:
Voer de tekst van de SQL-query in het tekstveld van de SQL-opdracht in.
Klik op Bladeren om de SQL-query uit een tekstbestand te laden.
Klik op Query parseren om de syntaxis van de querytekst te controleren.

Preview

Klik op Voorbeeld om maximaal de eerste 200 rijen van de gegevens weer te geven die zijn geëxtraheerd uit de tabel of weergave die u hebt geselecteerd.

ODBC-broneditor (pagina Kolommen)

Gebruik de pagina Kolommen van het dialoogvenster ODBC-broneditor om een uitvoerkolom toe te wijzen aan elke externe (bron)-kolom.

Takenlijst

De Kolommenpagina van de ODBC-broneditor openen

  1. Open in SQL Server Data Tools het SSIS-pakket (SQL Server 2019 Integration Services) met de ODBC-bron.

  2. Dubbelklik op het tabblad Gegevensstroom op de ODBC-bron.

  3. Klik in de ODBC-broneditor op Kolommen.

Options

Beschikbare externe kolommen

Een lijst met beschikbare externe kolommen in de gegevensbron. U kunt deze tabel niet gebruiken om kolommen toe te voegen of te verwijderen. Selecteer de kolommen die u uit de bron wilt gebruiken. De geselecteerde kolommen worden toegevoegd aan de lijst Externe kolom in de volgorde waarin ze zijn geselecteerd.

Schakel het selectievakje Alles selecteren in om alle kolommen te selecteren.

Externe kolom

Een weergave van de externe (bron) kolommen in de volgorde waarin u ze ziet bij het configureren van onderdelen die gegevens uit de ODBC-bron verbruiken.

Uitvoerkolom

Voer een unieke naam in voor elke uitvoerkolom. De standaardwaarde is de naam van de geselecteerde externe kolom (bronkolom; U kunt echter elke unieke, beschrijvende naam kiezen. De ingevoerde naam wordt weergegeven in de SSIS Designer.

ODBC-broneditor (foutuitvoerpagina)

Gebruik de pagina Foutuitvoer van het dialoogvenster ODBC-broneditor om opties voor foutafhandeling te selecteren.

Takenlijst

De foutuitvoerpagina van de ODBC-broneditor openen

  • Open in SQL Server Data Tools het SSIS-pakket (SQL Server 2019 Integration Services) met de ODBC-bron.

  • Dubbelklik op het tabblad Gegevensstroom op de ODBC-bron.

  • Klik in de ODBC-broneditor op Foutuitvoer.

Options

Invoer/uitvoer

Bekijk de naam van de gegevensbron.

Rubriek

Niet gebruikt.

Fout

Selecteer hoe de ODBC-bron fouten in een datastroom moet verwerken: negeer de fout, leid de rij om of laat het onderdeel falen.

Truncatie

Selecteer hoe de ODBC-bron moet omgaan met het afkorten van data in een stroom. Negeer de fout, leid de rij om, of laat het onderdeel falen.

Description

Niet gebruikt.

Deze waarde instellen op geselecteerde cellen

Selecteer hoe de ODBC-bron alle geselecteerde cellen verwerkt 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-bron 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 veroorzaakt of de afkapping wordt omgeleid naar de foutuitvoer van de ODBC-bron.