ADO NET-Ziel

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. Mit dieser Protokollierungsfunktion können Sie Probleme bei der Speicherung von Daten in externen Datenquellen diagnostizieren, die vom ADO NET-Ziel ausgeführt wird. 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

Dieses Ziel verwendet einen ADO.NET-Verbindungs-Manager für die Verbindung mit einer Datenquelle, und der Verbindungs-Manager legt den zu verwendenden ADO.NET-Anbieter fest. Weitere Informationen finden Sie unter ADO.NET Verbindungs-Manager.

Ein ADO NET-Ziel enthält Zuordnungen zwischen Eingabespalten und Spalten in der Zieldatenquelle. Sie müssen Eingabespalten nicht allen Zielspalten 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 der zugeordneten 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

Verbindungs-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.

Eine Tabelle oder Ansicht 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 "Neu" klicken, generiert Integration Services eine Standard-Anweisung CREATE TABLE basierend auf der verbundenen Datenquelle. Diese Standard-Anweisung CREATE TABLE enthält nicht das FILESTREAM-Attribut, auch wenn die Quelltabelle eine Spalte mit dem deklarierten FILESTREAM-Attribut 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 Binary Large Object (BLOB)-Daten (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ügen 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.

Hinweis

Wenn eine SQL Server- oder Sybase-Quelltabelle eine Identitätsspalte enthält, müssen Sie SQL-Aufgaben ausführen, um vor dem ADO NET-Ziel zu aktivieren IDENTITY_INSERT und danach erneut zu deaktivieren. (Die Identitätsspalteneigenschaft gibt einen inkrementellen Wert für die Spalte an. Mit SET IDENTITY_INSERT der Anweisung können explizite Werte aus der Quelltabelle in die Identitätsspalte in der Zieltabelle eingefügt werden.)

Um die Anweisungen und das erfolgreiche Laden der SET IDENTITY_INSERT Daten auszuführen, müssen Sie die folgenden Schritte ausführen.
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-Editor auf Zuordnungen.

Optionen

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
Zeigen Sie die Liste der verfügbaren Zielspalten an. Ordnen Sie die verfügbaren Zielspalten in der Tabelle per Drag-and-Drop den Eingabespalten zu.

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
Alle verfügbaren Zielspalten anzeigen, unabhängig davon, 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-Editor auf Fehlerausgabe.

Optionen

Eingabe oder Ausgabe
Zeigt den Namen der Eingabe an.

Spalte
Wird nicht verwendet.

Fehler
Geben Sie an, was geschehen soll, wenn ein Fehler auftritt: den Fehler ignorieren, die Zeile umleiten oder für die Komponente einen Fehler auslösen.

Verwandte Themen:Fehlerbehandlung in Daten

Abschneidung
Wird nicht verwendet.

Beschreibung
Zeigt die Beschreibung des Vorgangs an.

Diesen Wert für ausgewählte Zellen festlegen
Legen Sie fest, was bei einem Fehler oder beim Abschneiden für alle ausgewählten Zellen geschehen soll: den Fehler ignorieren, die Zeile umleiten oder die Komponente fehlschlagen lassen.

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

  • Last updated on