Share via

ODBC-Quelle

  • Artikel

Gilt für:SQL Server SSIS Integration Runtime in Azure Data Factory

Die ODBC-Quelle extrahiert Daten mithilfe einer Datenbanktabelle, Sicht oder SQL-Anweisung aus einer Datenbank mit ODBC-Unterstützung.

Die ODBC-Quelle verfügt über die folgenden Datenzugriffsmodi zum Extrahieren von Daten:

  • Eine Tabelle oder Sicht.

  • Die Ergebnisse einer SQL-Anweisung.

Die Quelle verwendet einen ODBC-Verbindungs-Manager, der den zu verwendenden Anbieter angibt.

Eine ODBC-Quelle enthält die Ausgabespalten für Quelldaten. Wenn Ausgabespalten auf dem ODBC-Ziel den Zielspalten zugeordnet werden, treten möglicherweise Fehler auf, wenn den Zielspalten keine Ausgabespalten zugeordnet sind. Es können Spalten mit verschiedenen Typen zugeordnet werden. Wenn die Ausgabedaten mit dem Ziel jedoch nicht kompatibel sind, tritt zur Laufzeit ein Fehler auf. Je nach Einstellung des Fehlerverhaltens wird der Fehler ignoriert, ein Fehler verursacht oder die Zeile zurück an die Fehlerausgabe gesendet.

Die ODBC-Quelle weist eine reguläre Ausgabe und eine Fehlerausgabe auf.

Fehlerbehandlung

Die ODBC-Quelle verfügt über eine Fehlerausgabe. Die Komponentenfehlerausgabe enthält die folgenden Ausgabespalten:

  • Fehlercode: Ruft die Zahl ab, die dem aktuellen Fehler entspricht. Eine Liste der Fehler finden Sie in der Dokumentation zur Datenbank mit ODBC-Unterstützung. Eine Liste der SSIS-Fehlercodes finden Sie in der SSIS-Fehler- und Meldungsreferenz.

  • Fehlerspalte: Die Quellspalte, die den Fehler verursacht (für Konvertierungsfehler).

  • Die Spalten mit den Standardausgabedaten.

Je nach Einstellung des Fehlerverhaltens unterstützt die ODBC-Quelle das Zurückgeben von Fehlern (Datenkonvertierung, Abschneiden), die während des Extraktionsprozesses in der Fehlerausgabe auftreten. Weitere Informationen finden Sie unter Ziel-Editor für ODBC (Seite „Verbindungs-Manager“).

Datentypunterstützung

Informationen zu den Datentypen, die von der ODBC-Quelle unterstützt werden, finden Sie unter „Connector für Open Database Connectivity (ODBC) von Attunity“.

Extrahierungsoptionen

Die ODBC-Quelle arbeitet entweder im Modus Batch oder Zeile für Zeile . Der verwendete Modus wird mithilfe der FetchMethod -Eigenschaft bestimmt. Die Modi werden in der folgenden Liste beschrieben:

  • Batch: Die Komponente versucht, basierend auf den erkannten Funktionen des ODBC-Anbieters die effizienteste Abrufmethode zu verwenden. Für die meisten modernen ODBC-Anbieter ist dies SQLFetchScroll mit Arraybindung (wobei die Arraygröße von der BatchSize -Eigenschaft bestimmt wird). Wenn Sie Batch auswählen und der Anbieter diese Methode nicht unterstützt, wechselt das ODBC-Ziel automatisch zum Modus Zeile für Zeile .

  • Zeile für Zeile: Die Komponente ruft die Zeilen mithilfe von SQLFetch einzeln ab.

Weitere Informationen zur FetchMethod -Eigenschaft finden Sie unter ODBC Source Custom Properties.

Parallelität

Es gilt keine Einschränkung in Bezug auf die Anzahl von ODBC-Quellkomponenten, die parallel für dieselbe Tabelle oder verschiedene Tabellen, auf demselben Computer oder auf unterschiedlichen Computern ausgeführt werden können (mit Ausnahme normaler Einschränkungen für globale Sitzungen).

Aufgrund von Einschränkungen in Verbindung mit dem verwendeten ODBC-Anbieter kann die Anzahl gleichzeitiger Verbindungen über den Anbieter möglicherweise trotzdem eingeschränkt sein. Diese Einschränkungen begrenzen die Anzahl der unterstützten parallelen Instanzen, die für die ODBC-Quelle möglich sind. Der SSIS-Entwickler muss sich über die Einschränkungen im Klaren sein, die für verwendete ODBC-Anbieter gelten, und diese beim Erstellen von SSIS-Paketen beachten.

Problembehandlung der ODBC-Quelle

Sie können die von der ODBC-Quelle an externe Datenanbieter gerichteten Aufrufe protokollieren. Mithilfe dieser Protokollierungsfunktion können Sie Probleme beim Laden von Daten aus externen Datenquellen durch die ODBC-Quelle behandeln. Aktivieren Sie die Ablaufverfolgung für den ODBC-Treiber-Manager, um die Aufrufe zu protokollieren, die von der ODBC-Quelle an externe Datenanbieter gesendet werden. Weitere Informationen finden Sie in der Microsoft-Dokumentation unter Generieren einer ODBC-Ablaufverfolgung mit dem ODBC-Datenquellen-Administrator.

Konfigurieren der ODBC-Quelle

Sie können die ODBC-Quelle programmgesteuert oder mit dem SSIS-Designer konfigurieren.

Das Dialogfeld Erweiterter Editor enthält die Eigenschaften, die programmgesteuert festgelegt werden können.

So öffnen Sie das Dialogfeld Erweiterter Editor :

  • Klicken Sie auf dem Bildschirm Datenfluss des SQL Server 2019 Integration Services-Projekts (SSIS) mit der rechten Maustaste auf die ODBC-Quelle, und wählen Sie Erweiterten Editor anzeigen aus.

Weitere Informationen zu den Eigenschaften, die Sie im Dialogfeld Erweiterter Editor festlegen können, finden Sie unter ODBC Source Custom Properties.

In diesem Abschnitt

Quellen-Editor für ODBC (Seite Verbindungs-Manager)

Auf der Seite Verbindungs-Manager des Dialogfelds Quellen-Editor für ODBC können Sie den ODBC-Verbindungs-Manager für die Quelle auswählen. Außerdem können Sie auf dieser Seite eine Tabelle oder Sicht aus der Datenbank auswählen.

Aufgabenliste

So öffnen Sie die Seite "Verbindungs-Manager" des Quellen-Editors für ODBC

  • Öffnen Sie in SQL Server Data Toolsdas SQL Server 2019 Integration Services-Paket (SSIS), das die ODBC-Quelle enthält.

  • Doppelklicken Sie auf der Registerkarte Datenfluss auf die ODBC-Quelle.

Tastatur

Ziel-Editor für Dimensionsverarbeitung

Wählen Sie in der Liste einen vorhandenen ODBC-Verbindungs-Manager aus, oder klicken Sie auf Neu , um eine neue Verbindung zu erstellen. Sie können eine Verbindung mit jeder von ODBC unterstützten Datenbank erstellen.

Neu

Klicken Sie auf Neu. Das Dialogfeld ODBC-Verbindungs-Manager konfigurieren , in dem Sie einen neuen ODBC-Verbindungs-Manager erstellen können, wird geöffnet.

Datenzugriffsmodus

Wählen Sie die Methode für die Auswahl von Daten aus der Quelle aus. Die Optionen sind in der folgenden Tabelle aufgeführt:

Option BESCHREIBUNG
Tabellenname Ruft Daten aus einer Tabelle oder Sicht in der ODBC-Datenquelle ab. Bei Auswahl dieser Option wählen Sie einen der folgenden Werte in der Liste aus:
Name der Tabelle oder Sicht: Wählen Sie in der Liste eine verfügbare Tabelle oder Sicht aus, oder geben Sie einen regulären Ausdruck ein, um die Tabelle zu identifizieren.
Diese Liste enthält nur die ersten 1000 Tabellen. Wenn die Datenbank mehr als 1000 Tabellen enthält, können Sie den Anfang eines Tabellennamens eingeben oder das Platzhalterzeichen (*) verwenden, um einen beliebigen Teil des Namens einzugeben und die gewünschten Tabellen anzuzeigen.
SQL-Befehl Ruft mit einer SQL-Abfrage Daten aus der ODBC-Datenquelle ab. Die Abfrage sollte in der Syntax der verwendeten Quelldatenbank geschrieben werden. Bei Auswahl dieser Option geben Sie anhand einer der folgenden Methoden eine Abfrage ein:
Geben Sie den Text der SQL-Abfrage im Feld SQL-Befehlstext ein.
Klicken Sie auf Durchsuchen , um die SQL-Abfrage aus einer Textdatei zu laden.
Klicken Sie auf Abfrage analysieren , um die Syntax des Abfragetextes zu überprüfen.

Vorschau

Klicken Sie auf Vorschau , um die ersten 200 Zeilen (max.) der Daten anzuzeigen, die aus der ausgewählten Tabelle bzw. Sicht extrahiert wurden.

Quellen-Editor für ODBC (Seite Spalten)

Auf der Seite Spalten des Dialogfelds Quellen-Editor für ODBC können Sie jeder externen Spalte (Quellspalte) eine Ausgabespalte zuordnen.

Aufgabenliste

So öffnen Sie die Seite "Spalten" des Quellen-Editors für ODBC

  1. Öffnen Sie in SQL Server Data Toolsdas SQL Server 2019 Integration Services-Paket (SSIS), das die ODBC-Quelle enthält.

  2. Doppelklicken Sie auf der Registerkarte Datenfluss auf die ODBC-Quelle.

  3. Klicken Sie im Quellen-Editor für ODBCauf Spalten.

Optionen

Verfügbare externe Spalten

Eine Liste der in der Datenquelle verfügbaren externen Spalten. Mit der Tabelle können keine Spalten hinzugefügt oder gelöscht werden. Wählen Sie die zu verwendenden Spalten aus der Datenquelle aus. Die ausgewählten Spalten werden der Liste Externe Spalte in der Reihenfolge hinzugefügt, in der Sie sie auswählen.

Aktivieren Sie das Kontrollkästchen Alle auswählen , um alle Spalten auszuwählen.

Externe Spalte

Eine Ansicht der externen Spalten (Quellspalten) in der Reihenfolge, in der sie angezeigt werden, wenn Sie Komponenten konfigurieren, die Daten aus dieser Quelle verwenden.

Ausgabespalte

Geben Sie für jede Ausgabespalte einen eindeutigen Namen ein. Standardmäßig wird der Name der ausgewählten externen (Quell-)Spalte verwendet. Sie können jedoch auch einen beschreibenden Namen angeben, sofern dieser eindeutig ist. Der eingegebene Name wird im SSIS-Designer angezeigt.

Quellen-Editor für ODBC (Seite Fehlerausgabe)

Auf der Seite Fehlerausgabe des Dialogfelds Quellen-Editor für ODBC können Sie Optionen für die Fehlerbehandlung auswählen.

Aufgabenliste

So öffnen Sie die Seite "Fehlerausgabe" des Quellen-Editors für ODBC

  • Öffnen Sie in SQL Server Data Toolsdas SQL Server 2019 Integration Services-Paket (SSIS), das die ODBC-Quelle enthält.

  • Doppelklicken Sie auf der Registerkarte Datenfluss auf die ODBC-Quelle.

  • Klicken Sie im Quellen-Editor für ODBCauf Fehlerausgabe.

Tastatur

Eingabe/Ausgabe

Zeigt den Namen der Datenquelle an.

Column

Wird nicht verwendet.

Fehler

Wählen Sie aus, wie die ODBC-Quelle Fehler in einem Fluss behandeln soll: Fehler ignorieren, Zeile umleiten oder Komponente mit einem Fehler abbrechen.

Abschneiden

Wählen Sie aus, wie die ODBC-Quelle Kürzungen in einem Fluss behandeln soll: Fehler ignorieren, Zeile umleiten oder Komponente mit einem Fehler abbrechen.

BESCHREIBUNG

Nicht verwendet.

Diesen Wert für ausgewählte Zellen festlegen

Wählen Sie aus, wie die ODBC-Quelle im Fall eines Fehlers oder einer Kürzung mit den ausgewählten Zellen verfahren soll: Fehler ignorieren, Zeile umleiten oder Komponente mit einem Fehler abbrechen.

Anwenden

Wendet die Fehlerbehandlungsoptionen auf die ausgewählten Zellen an.

Fehlerbehandlungsoptionen

Mit den folgenden Optionen konfigurieren Sie, wie die ODBC-Quelle Fehler und Kürzungen behandelt.

Fehler bei Komponente

Bei einem Fehler oder beim Abschneiden von Daten wird der Datenflusstask nicht ausgeführt. Dies ist das Standardverhalten.

Fehler ignorieren

Der Fehler oder die Kürzung wird ignoriert.

Zeile umleiten

Die Zeile, die den Fehler oder die Kürzung verursacht, wird an die Fehlerausgabe der ODBC-Quelle umgeleitet.