ADO NET-Ziel

  • Artikel

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

Das ADO NET-Ziel lädt Daten in eine Reihe von ADO.NET-kompatible Datenbanken, die eine Datenbanktabelle oder -sicht verwenden. Sie haben die Möglichkeit, diese Daten in eine vorhandene Tabelle oder Sicht zu laden, oder Sie können eine neue Tabelle erstellen und die Daten in die neue Tabelle laden.

Sie können mithilfe des ADO.NET-Ziels eine Verbindung mit Microsoft Azure SQL-Datenbank herstellen. Das Herstellen einer Verbindung mit SQL-Datenbank über OLE DB wird nicht unterstützt. Weitere Informationen zu SQL-Datenbank finden Sie unter Azure SQL-Datenbank – Allgemeine Einschränkungen und Leitlinien.

Problembehandlung des ADO NET-Ziels

Sie können die vom ADO NET-Ziel an externe Datenanbieter gerichteten Aufrufe protokollieren. Mithilfe dieser Protokollierungsfunktion können Sie Probleme beim Speichern von Daten in externen Datenquellen durch das ADO NET-Ziel behandeln. Aktivieren Sie zum Protokollieren der vom ADO NET-Ziel an externe Datenanbieter gerichteten Aufrufe die Paketprotokollierung, und wählen Sie das Diagnostic -Ereignis auf Paketebene aus. Weitere Informationen finden Sie unter Behandeln von Problemen mit Paketausführungstools.

Konfigurieren des ADO NET-Ziels

Von diesem Ziel wird ein ADO.NET -Verbindungs-Manager zum Herstellen einer Verbindung mit einer Datenquelle verwendet, und der Verbindungs-Manager gibt den zu verwendenden ADO.NET -Anbieter an. Weitere Informationen finden Sie unter ADO.NET Connection Manager.

Ein ADO NET-Ziel enthält Zuordnungen zwischen Eingabespalten und Spalten in der Zieldatenquelle. Sie müssen nicht allen Zielspalten eine Eingabespalten zuordnen. Die Eigenschaften einiger Zielspalten können jedoch die Zuordnung von Eingabespalten erfordern. Andernfalls könnten Fehler auftreten. Wenn z. B. eine Zielspalte keine NULL-Werte zulässt, muss dieser Zielspalte eine Eingabespalte zugeordnet werden. Darüber hinaus müssen die Datentypen zugeordneter Spalten kompatibel sein. Beispielsweise können Sie eine Eingabespalte mit einem string-Datentyp nicht einer Zielspalte mit einem numerischen Datentyp zuordnen, wenn der ADO.NET -Anbieter diese Zuordnung nicht unterstützt.

Hinweis

SQL Server unterstützt nicht das Einfügen von Text in Spalten mit dem Datentyp „image“. Weitere Informationen zu SQL Server-Datentypen finden Sie unter Datentypen (Transact-SQL).

Hinweis

Die Zuordnung einer Eingabespalte, deren Typ auf DT_DBTIME festgelegt ist, zu einer Datenbankspalte, deren Typ auf datetime festgelegt ist, wird vom ADO NET-Ziel nicht unterstützt. Weitere Informationen zu Integration Services -Datentypen finden Sie unter Integration Services-Datentypen.

Das ADO NET-Ziel weist eine reguläre Eingabe und eine Fehlerausgabe auf.

Sie können Eigenschaften mit dem SSIS -Designer oder programmgesteuert festlegen.

Das Dialogfeld Erweiterter Editor enthält die Eigenschaften, die programmgesteuert festgelegt werden können. Klicken Sie auf eines der folgenden Themen, um weitere Informationen zu den Eigenschaften zu erhalten, die Sie im Dialogfeld Erweiterter Editor oder programmgesteuert festlegen können:

Weitere Informationen zum Festlegen der Eigenschaften finden Sie unter Festlegen der Eigenschaften einer Datenflusskomponente.

ADO.NET-Ziel-Editor (Seite 'Verbindungs-Manager')

Mithilfe der Seite Verbindungs-Manager des Dialogfelds ADO.NET-Ziel-Editor können Sie die ADO.NET -Verbindung für das Ziel auswählen. Außerdem können Sie auf dieser Seite eine Tabelle oder Sicht aus der Datenbank auswählen.

So öffnen Sie die Seite "Verbindungs-Manager"

  1. Öffnen Sie in SQL Server Data Tools (SSDT)das Integration Services -Paket, das ADO.NET als Ziel hat.

  2. Doppelklicken Sie auf der Registerkarte Datenfluss auf das ADO NET-Ziel.

  3. Klicken Sie im ADO.NET-Ziel-Editorauf Verbindungs-Manager.

Statische Optionen

Connection manager
Wählen Sie in der Liste einen vorhandenen Verbindungs-Manager aus, oder erstellen Sie eine neue Verbindung, indem Sie auf Neuklicken.

Neu
Erstellen Sie mithilfe des Dialogfelds ADO.NET-Verbindungs-Manager konfigurieren einen neuen Verbindungs-Manager.

Tabelle oder Sicht verwenden
Wählen Sie eine vorhandene Tabelle oder Sicht aus der Liste aus, oder erstellen Sie eine neue Tabelle, indem Sie auf Neuklicken.

Neu
Erstellen Sie mithilfe des Dialogfelds Tabelle erstellen eine neue Tabelle oder Sicht.

Hinweis

Wenn Sie auf Neuklicken, generiert Integration Services eine Standard-CREATE TABLE-Anweisung auf Grundlage der verbundenen Datenquelle. Diese Standard-CREATE TABLE-Anweisung enthält nicht das FILESTREAM-Attribut, selbst wenn die Quelltabelle eine Spalte mit der Erklärung des FILESTREAM-Attributs enthält. Um eine Integration Services -Komponente mit dem FILESTREAM-Attribut auszuführen, implementieren Sie zunächst die FILESTREAM-Speicherung in der Zieldatenbank. Fügen Sie dann das FILESTREAM-Attribut der CREATE TABLE-Anweisung im Dialogfeld Tabelle erstellen hinzu. Weitere Informationen finden Sie unter Blobdaten (Binary Large Object, SQL Server).

Vorschau
Zeigen Sie mithilfe des Dialogfelds Vorschau der Abfrageergebnisse anzeigen eine Vorschau der Ergebnisse an. In der Vorschau können bis zu 200 Zeilen angezeigt werden.

Masseneinfügung verwenden, falls verfügbar
Geben Sie an, ob die Schnittstelle SqlBulkCopy verwendet werden soll, um die Leistung von Masseneinfügungsvorgängen zu verbessern.

Nur ADO.NET-Anbieter, die ein SqlConnection -Objekt zurückgeben, unterstützen die Verwendung der SqlBulkCopy -Schnittstelle. Der .NET-Datenanbieter für SQL Server (SqlClient) gibt ein SqlConnection -Objekt zurück, und ein benutzerdefinierter Anbieter gibt möglicherweise ein SqlConnection -Objekt zurück.

Sie können den .NET-Datenanbieter für SQL Server (SqlClient) verwenden, um eine Verbindung mit Microsoft Azure SQL-Datenbankherzustellen.

Wenn Sie Masseneinfügung verwenden, falls verfügbarauswählen und für Zeile umleiten die Option Fehlerfestlegen, enthält der Datenbatch, der vom Ziel an die Fehlerausgabe umgeleitet wird, möglicherweise intakte Zeilen. Weitere Informationen zur Behandlung von Fehlern in Massenvorgängen finden Sie unter Fehlerbehandlung in Daten. Weitere Informationen zur Option Fehler finden Sie unter ADO.NET-Ziel-Editor (Seite „Fehlerausgabe“).

Hinweis

Wenn eine SQL Server- oder Sybase-Quelltabelle eine Identitätsspalte enthält, müssen Sie SQL ausführen-Tasks zum Aktivieren von IDENTITY_INSERT vor dem ADO NET-Ziel und zum Deaktivieren danach verwenden. (Die Identitätsspalteneigenschaft gibt einen inkrementellen Wert für die Spalte an. Die SET IDENTITY_INSERT-Anweisung ermöglicht das Einfügen expliziter Werte aus der Quelltabelle in die Identitätsspalte der Zieltabelle.)

Um die SET IDENTITY_INSERT-Anweisungen und das Laden der Daten erfolgreich auszuführen, müssen Sie mit den folgenden Schritten vorgehen.
1. Verwenden Sie den gleichen ADO.NET-Verbindungs-Manager für die „SQL ausführen“-Tasks und das ADO.NET-Ziel.
2. Legen Sie auf dem Verbindungs-Manager die Eigenschaft RetainSameConnection und die Eigenschaft MultipleActiveResultSets auf „true“ fest.
3. Legen Sie auf dem ADO.NET-Ziel die Eigenschaft UseBulkInsertWhenPossible auf „false“ fest.

Weitere Informationen finden Sie unter SET IDENTITY_INSERT (Transact-SQL) und IDENTITY (Eigenschaft) (Transact-SQL).

Externe Ressourcen

Technischer Artikel Schnelles Laden von Daten in eine Azure SQL-Datenbank auf sqlcat.com

ADO.NET-Ziel-Editor (Seite 'Zuordnungen')

Auf der Seite Zuordnungen des Dialogfelds ADO.NET-Ziel-Editor können Sie eine Zuordnung von Eingabe- zu Zielspalten vornehmen.

So öffnen Sie die Seite "Zuordnungen"

  1. Öffnen Sie in SQL Server Data Tools (SSDT)das Integration Services -Paket, das ADO.NET als Ziel hat.

  2. Doppelklicken Sie auf der Registerkarte Datenfluss auf das ADO NET-Ziel.

  3. Klicken Sie im ADO.NET-Ziel-Editorauf Zuordnungen.

Tastatur

Verfügbare Eingabespalten
Zeigt die Liste der verfügbaren Eingabespalten an. Mithilfe eines Drag-und-Drop-Vorgangs können Sie verfügbare Eingabespalten in der Tabelle Zielspalten zuordnen.

Verfügbare Zielspalten
Zeigt die Liste der verfügbaren Zielspalten an. Mithilfe eines Drag-und-Drop-Vorgangs können Sie verfügbare Zielspalten in der Tabelle Eingabespalten zuordnen.

Eingabespalte
Zeigt die von Ihnen ausgewählten Eingabespalten an. Sie können Zuordnungen entfernen, indem Sie <ignore> auswählen, um Spalten aus der Ausgabe auszuschließen.

Zielspalte
Zeigt alle verfügbaren Zielspalten an, ganz gleich, ob sie zugeordnet sind oder nicht.

ADO.NET-Ziel-Editor (Seite 'Fehlerausgabe')

Auf der Seite Fehlerausgabe des Dialogfelds ADO.NET-Ziel-Editor geben Sie Optionen für die Fehlerbehandlung an.

So öffnen Sie die Seite "Fehlerausgabe"

  1. Öffnen Sie in SQL Server Data Tools (SSDT)das Integration Services -Paket, das ADO.NET als Ziel hat.

  2. Doppelklicken Sie auf der Registerkarte Datenfluss auf das ADO NET-Ziel.

  3. Klicken Sie im ADO.NET-Ziel-Editorauf Fehlerausgabe.

Tastatur

Eingabe oder Ausgabe
Zeigt den Namen der Eingabe an.

Spalte
Wird nicht verwendet.

Fehler
Gibt an, was bei Auftreten eines Fehlers geschehen soll: den Fehler ignorieren, die Zeile umleiten oder die Komponente mit einem Fehler abbrechen.

Verwandte Themen:Fehlerbehandlung in Daten

Abschneiden
Wird nicht verwendet.

Beschreibung
Zeigt die Beschreibung des Vorgangs an.

Diesen Wert für ausgewählte Zellen festlegen
Gibt an, was im Falle eines Fehlers oder einer Kürzung mit den ausgewählten Zellen geschehen soll: den Fehler ignorieren, die Zeile umleiten oder die Komponente mit einem Fehler abbrechen.

Anwenden
Wendet die Fehlerbehandlungsoption auf die ausgewählten Zellen an.