Teilen über

Stellen Sie eine Verbindung mit der Teradata-Quelle her.

  • Artikel

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

Die Teradata-Quelle nutzt Folgendes, um Daten aus Teradata-Datenbanken zu extrahieren:

  • Eine Tabelle oder Sicht.
  • Die Ergebnisse einer SQL-Anweisung.

Die Quelle verwendet den Teradata-Verbindungs-Manager, um eine Verbindung mit der Teradata-Quelle herzustellen. Weitere Informationen finden Sie unter Verwenden des Teradata-Verbindungs-Managers.

Behandeln von Problemen mit der Teradata-Quelle

Sie können die Aufrufe der Teradata-Quelle an die TPT-API (Teradata Parallel Transporter) protokollieren. Aktivieren Sie hierzu die Paketprotokollierung, und wählen Sie dann auf Paketebene das Ereignis Diagnose aus.

Sie können die ODBC-Aufrufe (Open Database Connectivity) der Teradata-Quelle an den Teradata-ODBC-Treiber protokollieren, indem Sie die Ablaufverfolgung für den ODBC-Treiber-Manager aktivieren. Weitere Informationen finden Sie unter Generieren einer ODBC-Ablaufverfolgung mit dem ODBC-Datenquellen-Administrator.

Parallelität

Die Teradata-Quelle unterstützt Parallelität, wobei Exportaufträge auf die gleiche oder verschiedene Tabellen gleichzeitig zugreifen können. Eine Datenbankvariable namens MaxLoadTasks legt die Obergrenze der Anzahl gleichzeitig ausgeführter Exportaufträge fest. Sie können diese maximale Anzahl mithilfe der Variablen MaxLoadTasks festlegen.

Benutzerdefinierte Eigenschaften der Teradata-Quelle

Die benutzerdefinierten Eigenschaften der Teradata-Quelle sind in der folgenden Tabelle aufgeführt. Alle Eigenschaften weisen Lese-/Schreibzugriff auf.

Eigenschaftenname Datentyp BESCHREIBUNG
AccessMode Ganze Zahl (Enumeration) Der zum Zugreifen auf die Datenbank verwendete Modus. Die möglichen Werte sind Tabellenname und SQL-Befehl. Der Standardwert ist Tabellenname.
BlockSize Integer Die Blockgröße in Bytes, die beim Zurückgeben von Daten an den Client verwendet wird. Der Standardwert ist 1.048.576 MB (1 MB). Der Mindestwert ist 256 Bytes. Der Höchstwert ist 16.7751.68 Bytes.
Diese Eigenschaft befindet sich im Bereich Erweiterter Editor.
BufferMaxSize Integer Die maximale Gesamtgröße des von der GetBuffer-Funktion zurückgegebenen Datenpuffers. Diese Größe muss ausreichend sein, um mindestens eine Datenzeile, einschließlich Zeilenkopf, eigentlicher Datenzeile und Puffernachspann, aufzunehmen. Die standardmäßige maximale Gesamtgröße des Datenpuffers ist 16.775.552 Bytes.
Weitere Informationen finden Sie unter Exportieren von Daten aus einer Teradata-Datenbank mithilfe von GetBuffer.
BufferMode Boolean Der Standardwert ist True. Wenn die PutBuffer-Funktion verwendet wird, muss der Wert True sein. Diese Eigenschaft befindet sich im Bereich Erweiterter Editor.
DataEncryption Boolean Der Standardwert ist False. Wenn der Wert True ist, wird die vollständige Sicherheitsverschlüsselung verwendet.
DefaultCodePage Integer Die zu verwendende Codepage, wenn die Datenquelle keine Informationen zur Codepage enthält. Diese Eigenschaft befindet sich im Bereich Erweiterter Editor.
DetailedTracingLevel Ganze Zahl (Enumeration) Wählen Sie für die erweiterte Ablaufverfolgung eine der folgenden Optionen aus:
Off: Keine erweiterte Protokollierung.
General: Bei dieser Ablaufverfolgung werden treiberspezifische Aktivitäten protokolliert.
CLI: Bei dieser Ablaufverfolgung werden CLIv2-spezifische Aktivitäten protokolliert.
Notify Method: Aktivitäten im Zusammenhang mit der Benachrichtigung werden protokolliert.
Common Library: Die Ablaufverfolgung von Aktivitäten in der opCommon-Bibliothek wird protokolliert.
All: Die gesamte vorherige Ablaufverfolgung von Aktivitäten wird protokolliert.
Die Protokolldatei mit der erweiterten Ablaufverfolgung wird in der DetailedTracingFile-Eigenschaft definiert.
Die DetailedTracingFile-Eigenschaft muss festgelegt werden, wenn die Option nicht Off ist. Diese Eigenschaft befindet sich im Bereich Erweiterter Editor.
DetailedTracingFile String Der Pfad der Protokolldatei, die automatisch erzeugt wird, wenn DetailedTracingLevel nicht Off ist. Diese Eigenschaft befindet sich im Bereich Erweiterter Editor.
DiscardLargeRow Boolean Der Standardwert ist False. Große Zeilen (mit mehr als 64 KB) werden verworfen, wenn der Wert Trueist.
ExtendedStringColumnsAllocation Boolean Maximal Transfer Character Allocation Factor wird verwendet, wenn der Wert True ist.
Dieser Wert muss auf True festgelegt werden, wenn die Eigenschaft Export Width Table ID der Teradata-Datenbank auf Maximal Defaults festgelegt ist.
Der Standardwert ist False.
JobMaxRowSize Integer Die maximale Zeilenlänge kann unterstützt werden. Dieser Wert wird benötigt, wenn der DiscardLargeRow-Wert True ist.
Gültige Werte:
64 (Standardwert): Zeilenlängen von 2 Bytes können unterstützt werden.
1024: Zeilenlängen von 4 Bytes können unterstützt werden.
MaxSessions Integer Die maximale Anzahl der angemeldeten Sitzungen. Dieser Wert muss größer als 0 (null) sein. Der Standardwert ist eine Sitzung für jede verfügbare AMP-Instanz (Access Module Processor).
MinSessions Integer Die minimale Anzahl der angemeldeten Sitzungen. Dieser Wert muss größer als 0 (null) sein. Der Standardwert ist eine Sitzung für jede verfügbare AMP-Instanz.
QueryBandSessInfo Varchar Ein benutzerdefinierter, sitzungsbasierter Abfragebandausdruck im Format einer Verbindungszeichenfolge. Sie verwenden diese Eigenschaft für die Überwachung und Steuerung von Rückbuchungen. Diese Eigenschaft befindet sich im Bereich Erweiterter Editor.
SpoolMode Varchar Gültige Werte sind:
Spool: Verwenden Sie den Standardwert Spool.
NoSpool: Verwenden Sie Spool nicht. Dieser Wert ist nur gültig, wenn der Datenbankserver NoSpool unterstützt.
NoSpoolOnly: Verwenden Sie Spool auf keinen Fall. Der Auftrag wird mit einem Fehler beendet, wenn der Datenbankserver NoSpool nicht unterstützt.
SqlCommand String Der SQL-Befehl, der ausgeführt werden soll, wenn AccessMode auf SQL Command festgelegt wird.
TableName String Der Name der Tabelle mit den Daten, die verwendet werden, wenn AccessMode auf Tabellenname festgelegt wird.
TenacityHours Integer Die Anzahl der Stunden, die der TPT-Treiber versucht, sich anzumelden, wenn die maximale Anzahl von Lade-/Exportvorgängen bereits läuft. Der Standardwert ist 4 Stunden. Diese Eigenschaft befindet sich im Bereich Erweiterter Editor.
TenacitySleep Integer Die Anzahl der Minuten, die der TPT-Treiber bei Erreichen des Grenzwerts anhält, bevor er versucht, sich anzumelden. Der Grenzwert wird von den Eigenschaften MaxSessions und TenacityHours definiert. Der Standardwert ist 6 Minuten. Diese Eigenschaft befindet sich im Bereich Erweiterter Editor.
UnicodePassThrough Boolean Off (Standardwert): Deaktivieren Sie Unicode-Pass-Through.
Am: Aktivieren Sie Unicode-Pass-Through.

Konfigurieren der Teradata-Quelle

Sie können die Teradata-Quelle programmgesteuert oder mithilfe des SSIS-Designers (SQL Server Integration Services) konfigurieren.

Der Bereich Teradata-Quell-Editor ist in der folgenden Abbildung dargestellt. Weitere Informationen finden Sie in den folgenden Abschnitten des Teradata-Quell-Editors:

Teradata-Quell-Editor

Der Bereich Erweiterter Editor enthält Eigenschaften, die programmgesteuert festgelegt werden können. So öffnen Sie den Bereich

  • Klicken Sie auf der Seite Datenfluss des Integration Services-Projekts mit der rechten Maustaste auf die Teradata-Quelle, und wählen Sie Erweiterten Editor anzeigen aus.

Weitere Informationen zu den Eigenschaften, die Sie im Bereich Erweiterter Editor festlegen können, finden Sie unter Benutzerdefinierte Eigenschaften der Teradata-Quelle.

Der Bereich „Verbindungs-Manager“

Wählen Sie im Bereich Verbindungs-Manager die Instanz des Teradata-Verbindungs-Managers für die Quelle aus. In diesem Bereich können Sie auch eine Tabelle oder Sicht in der Datenbank auswählen. So öffnen Sie den Bereich

  1. Öffnen Sie in SQL Server Data Tools das SSIS-Paket mit der Teradata-Quelle.

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

  3. Wählen Sie im Teradata-Quell-Editor die Registerkarte Verbindungs-Manager aus.

Tastatur

Connection manager

  • Wählen Sie in der Liste einen vorhandenen Verbindungs-Manager aus, oder klicken Sie auf Neu, um eine neue Instanz des Teradata-Verbindungs-Managers zu erstellen.

Neu

  • Wählen Sie Neuaus. Der Bereich Teradata-Verbindungs-Manager-Editor wird geöffnet. Erstellen Sie in diesem Bereich einen neuen Verbindungs-Manager.

Datenzugriffsmodus

  • Wählen Sie die Methode zum Auswählen von Daten aus der Quelle. Die Optionen sind in der folgenden Tabelle aufgeführt:

    Option BESCHREIBUNG
    Tabellenname – TPT-Export Ruft Daten aus einer Tabelle oder Sicht in der Teradata-Datenquelle ab. Wenn diese Option ausgewählt ist, wählen Sie in der Liste eine verfügbare Tabelle oder Sicht für Name der Tabelle oder Sicht aus.
    SQL-Befehl – TPT-Export Abrufen von Daten aus der Teradata-Datenquelle mithilfe einer SQL-Abfrage. Wenn diese Option ausgewählt ist, geben Sie eine Abfrage auf eine der folgenden Arten ein:
    • Geben Sie den Text der SQL-Abfrage im Feld SQL-Befehlstext ein.
    • Wählen Sie Durchsuchen aus, um die SQL-Abfrage aus einer Textdatei zu laden.
    • Wählen Sie Abfrage analysieren aus, um die Syntax des Abfragetexts zu überprüfen.

Vorschau

  • Wählen Vorschau aus, um (max.) die ersten 200 Zeilen der Daten anzuzeigen, die aus der ausgewählten Tabelle bzw. Sicht extrahiert wurden.

Der Bereich „Spalten“

Im Bereich Spalten können Sie jeder externen Spalte (Quellspalte) eine Ausgabespalte zuordnen. So öffnen Sie den Bereich

  1. Öffnen Sie in SQL Server Data Tools das SSIS-Paket mit der Teradata-Quelle.

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

  3. Wählen Sie im Teradata-Quell-Editor die Registerkarte Spalten aus.

Tastatur

Verfügbare externe Spalten

In dieser Tabelle sind die verfügbaren externen Spalten aufgeführt, die Sie auswählen und der Liste Externe Spalte hinzufügen können. Sie können die Spalten in der von Ihnen gewünschten Reihenfolge auflisten. In dieser Tabelle können Spalten weder hinzugefügt noch gelöscht werden.

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

Externe Spalten

Die externen Spalten (Quellspalten), die Sie ausgewählt haben, sind in Reihenfolge aufgelistet. Um die Reihenfolge zu ändern, löschen Sie zuerst die Liste Verfügbare externe Spalten, und wählen Sie dann die Spalten in einer anderen Reihenfolge aus.

Ausgabespalte

Obwohl der Name der ausgewählten externen (Quell-)Spalte der Standardausgabename ist, können Sie einen beliebigen eindeutigen Namen eingeben.

Hinweis

Wenn es Spalten gibt, die nicht unterstützte Datentypen enthalten, erhalten Sie eine Warnung, in der diese nicht unterstützten Datentypen angezeigt werden. Die entsprechenden Spalten werden dann aus den Zuordnungsspalten entfernt.

Der Bereich „Fehlerausgabe“

Im Bereich Fehlerausgabe können Sie Optionen für die Fehlerbehandlung auswählen. So öffnen Sie den Bereich

  1. Öffnen Sie in SQL Server Data Tools das SSIS-Paket mit der Teradata-Quelle.

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

  3. Wählen Sie im Teradata-Quell-Editor die Registerkarte Fehlerausgabe aus.

Tastatur

Fehlerverhalten

  • Wählen Sie aus, wie die Teradata-Quelle Fehler in einem Fluss behandeln soll:
    • Den Fehler ignorieren
    • Die Zeile umleiten
    • Die Komponente mit einem Fehler abbrechen

Verwandte Themen: Weitere Informationen finden Sie unter Fehlerbehandlung in Daten.

Abschneiden

  • Wählen Sie aus, wie die Teradata-Quelle das Abschneiden in einem Fluss behandeln soll:
    • Den Fehler ignorieren
    • Die Zeile umleiten
    • Die Komponente mit einem Fehler abbrechen

Nächste Schritte