Teilen über


OLE DB-Ziel

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

Das OLE DB-Ziel lädt Daten mithilfe einer Datenbanktabelle oder -ansicht oder eines SQL-Befehls in eine Vielzahl von OLE DB-kompatiblen Datenbanken. Beispielsweise können aus der OLE DB-Quelle Daten in Tabellen in Microsoft Office Access- und SQL Server-Datenbanken geladen werden.

Hinweis

Wenn es sich bei der Datenquelle um Microsoft Office Excel 2007 handelt, erfordert die Datenquelle einen anderen Verbindungs-Manager als frühere Versionen von Excel. Weitere Informationen finden Sie unter Herstellen einer Verbindung mit einer Excel-Arbeitsmappe.

Das OLE DB-Ziel stellt fünf verschiedene Datenzugriffsmodi zum Laden von Daten bereit:

  • Eine Tabelle oder Sicht. Sie können eine vorhandene Tabelle oder Sicht angeben oder eine neue Tabelle erstellen.

  • Eine Tabelle oder Sicht, die Optionen für schnelles Laden verwendet. Sie können eine vorhandene Tabelle angeben oder eine neue Tabelle erstellen.

  • Eine in einer Variablen angegebene Tabelle oder Sicht.

  • Eine in einer Variablen angegebene Tabelle oder Sicht, die Optionen für schnelles Laden verwendet.

  • Die Ergebnisse einer SQL-Anweisung.

Hinweis

Vom OLE DB-Ziel werden keine Parameter unterstützt. Wenn Sie eine parametrisierte INSERT-Anweisung ausführen müssen, ziehen Sie die Transformation für den OLE DB-Befehl in Betracht. Weitere Informationen finden Sie unter OLE DB Command Transformation.

Wenn das OLE DB-Ziel Daten lädt, die einen Doppelbyte-Zeichensatz (Double-Byte Character Set, DBCS) verwenden, werden die Daten möglicherweise beschädigt, falls der Datenzugriffsmodus nicht die Option für schnelles Laden verwendet und falls der OLE DB-Verbindungs-Manager den Microsoft OLE DB-Anbieter für SQL Server (SQLOLEDB) verwendet. Um die Integrität von Doppelbyte-Zeichensatzdaten sicherzustellen, sollten Sie für den OLE DB-Verbindungs-Manager die Verwendung des SQL Server Native Client konfigurieren oder einen der Zugriffsmodi für das schnelle Laden verwenden: Tabelle oder Sicht – schnelles Laden oder Variable für Tabellenname oder Sichtname – schnelles Laden. Beide Optionen sind im Dialogfeld Ziel-Editor für OLE DB verfügbar. Bei der Programmierung des SSIS-Objektmodells sollten Sie die AccessMode-Eigenschaft auf OpenRowset Using FastLoadoder OpenRowset mit Using FastLoad From Variable festlegen.

Hinweis

Wenn Sie mithilfe des Dialogfelds Ziel-Editor für OLE DB im SSIS-Designer die Zieltabelle erstellen, in die das OLE DB-Ziel Daten einfügt, müssen Sie möglicherweise die neu erstellte Tabelle manuell auswählen. Die manuelle Auswahl ist erforderlich, wenn ein OLE DB-Anbieter, wie z. B. der OLE DB-Anbieter für DB2, dem Tabellennamen automatisch Schemabezeichner hinzufügt.

Hinweis

Die CREATE TABLE-Anweisung, die das Dialogfeld Ziel-Editor für OLE DB generiert, muss eventuell je nach Zieltyp geändert werden. Beispielsweise unterstützen einige Ziele nicht die von der CREATE TABLE-Anweisung verwendeten Datentypen.

Dieses Ziel verwendet einen OLE DB-Verbindungs-Manager zum Herstellen einer Verbindung mit einer Datenquelle, und der Verbindungs-Manager gibt den zu verwendenden OLE DB-Anbieter an. Weitere Informationen finden Sie unter OLE DB Connection Manager.

Ein Integration Services-Projekt stellt außerdem das Datenquellenobjekt bereit, von dem Sie einen OLE DB-Verbindungs-Manager erstellen können, um Datenquellen und Datenquellensichten für das OLE DB-Ziel zur Verfügung zu stellen.

Ein OLE DB-Ziel enthält Zuordnungen zwischen Eingabespalten und Spalten in der Zieldatenquelle. Sie müssen nicht allen Zielspalten Eingabespalten zuordnen. In Abhängigkeit von den Eigenschaften der Zielspalten können jedoch Fehler auftreten, falls den Zielspalten keine Eingabespalten zugeordnet sind. Wenn eine Zielspalte z. B. keine NULL-Werte zulässt, muss dieser Spalte eine Eingabespalte zugeordnet werden. Darüber hinaus müssen die Datentypen zugeordneter Spalten kompatibel sein. Beispielsweise kann eine Eingabespalte mit einem Zeichenfolgen-Datentyp keiner Zielspalte mit einem numerischen Datentyp zugeordnet werden.

Das OLE DB-Ziel weist eine reguläre Eingabe und eine Fehlerausgabe auf.

Weitere Informationen zu Datentypen finden Sie unter Integration Services Data Types.

Optionen für schnelles Laden

Wenn das OLE DB-Ziel einen Datenzugriffsmodus für schnelles Laden verwendet, können Sie für das Ziel die folgenden Optionen für schnelles Laden in der Benutzeroberfläche, dem Ziel-Editor für OLE DB, angeben:

  • Identitätswerte aus der importierten Datendatei beibehalten oder von SQL Serverzugewiesene eindeutige Werte verwenden.

  • Einen NULL-Wert während des Massenladevorgangs beibehalten.

  • Während des Massenimportvorgangs Einschränkungen der Zieltabelle oder -sicht überprüfen.

  • Sperre auf Tabellenebene für die Dauer des Massenladevorgangs abrufen.

  • Die Zeilenanzahl im Batch und die Commitgröße angeben.

Einige Optionen für schnelles Laden werden in bestimmten Eigenschaften des OLE DB-Ziels gespeichert. FastLoadKeepIdentity gibt beispielsweise an, ob Werte weiterhin identifiziert werden sollen, während mit FastLoadKeepNulls angegeben wird, ob NULL-Werte beibehalten werden sollen. FastLoadMaxInsertCommitSize gibt wiederum die in einen Batch zu übernehmende Zeilenanzahl an. Andere Optionen für schnelles Laden werden in der FastLoadOptions-Eigenschaft in einer durch Trennzeichen getrennten Liste gespeichert. Wenn das OLE DB-Ziel alle in FastLoadOptions gespeicherten und im Dialogfeld Ziel-Editor für OLE DB aufgelisteten Optionen für schnelles Laden verwendet, wird der Wert der Eigenschaft auf TABLOCK, CHECK_CONSTRAINTS, ROWS_PER_BATCH=1000festgelegt. Der Wert 1000 gibt an, dass das Ziel zum Verwenden von Batches mit 1000 Zeilen konfiguriert wurde.

Hinweis

Einschränkungsfehler am Ziel bewirken, dass der gesamte Batch mit Zeilen, die durch FastLoadMaxInsertCommitSize definiert sind, fehlschlägt.

Neben den im Dialogfeld Ziel-Editor für OLE DB verfügbar gemachten Optionen für schnelles Laden können Sie das OLE DB-Ziel so konfigurieren, dass die folgenden Optionen für das Massenladen verwendet werden, indem Sie die Optionen im Dialogfeld Erweiterter Editor in der FastLoadOptions-Eigenschaft eingeben.

Option für schnelles Laden BESCHREIBUNG
KILOBYTES_PER_BATCH Gibt die einzufügende Größe in Kilobyte an. Die Option hat die folgende Form: KILOBYTES_PER_BATCH = <positive ganze Zahl>.
FIRE_TRIGGERS Gibt an, ob in der Einfügetabelle Trigger ausgelöst werden. Die Option hat die Form FIRE_TRIGGERS. Das Vorhandensein der Option gibt an, dass Trigger ausgelöst werden.
ORDER Gibt die Sortierung der Eingabedaten an. Die Option hat die folgende Form: ORDER <Spaltenname> ASC|DESC. Es kann eine beliebige Anzahl an Spalten aufgelistet werden. Optional kann die Sortierreihenfolge eingeschlossen werden. Wird die Sortierreihenfolge ausgelassen, geht der Einfügevorgang davon aus, dass die Daten nicht sortiert sind.

Hinweis: Die Leistung wird verbessert, wenn die Eingabedaten entsprechend dem gruppierten Index der Tabelle mit der ORDER-Option sortiert werden.

Die Transact-SQL-Schlüsselwörter werden in der Regel in Großbuchstaben eingegeben. Bei den Schlüsselwörtern wird jedoch nicht nach Groß-/Kleinschreibung unterschieden.

Weitere Informationen zu den Optionen für schnelles Laden finden Sie unter BULK INSERT (Transact-SQL).

Problembehandlung des OLE DB-Zieles

Sie können die vom OLE DB-Ziel an externe Datenanbieter gerichteten Aufrufe protokollieren. Mithilfe dieser Protokollierungsfunktion können Sie Probleme beim Speichern von Daten in externen Datenquellen durch das OLE DB-Ziel behandeln. Aktivieren Sie zum Protokollieren der vom OLE DB-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 OLE DB-Zieles

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:

Klicken Sie auf eines der folgenden Themen, um weitere Informationen zum Festlegen von Eigenschaften anzuzeigen:

Ziel-Editor für OLE DB (Seite Verbindungs-Manager)

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

Hinweis

Wenn es sich bei der Datenquelle um Microsoft Office Excel 2007 handelt, erfordert die Datenquelle einen anderen Verbindungs-Manager als frühere Versionen von Excel. Weitere Informationen finden Sie unter Herstellen einer Verbindung mit einer Excel-Arbeitsmappe.

Hinweis

Die CommandTimeout -Eigenschaft des OLE DB-Ziels ist nicht im Ziel-Editor für OLE DBverfügbar, sie kann jedoch mit dem Dialogfeld Erweiterter Editorfestgelegt werden. Darüber hinaus sind bestimmte Optionen für schnelles Laden nur im Dialogfeld Erweiterter Editorverfügbar. Weitere Informationen zu diesen Eigenschaften finden Sie im Abschnitt OLE DB-Ziel von OLE DB Custom Properties.

Die Eigenschaft CommandTimeout ist nur dann wirksam, wenn der Datenzugriffsmodus SQL-Befehl lautet.

Statische Optionen

Teilcache
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 OLE DB-Verbindungs-Manager konfigurieren einen neuen Verbindungs-Manager.

Datenzugriffsmodus
Gibt das Verfahren für das Laden von Daten in das Ziel an. Für das Laden von Doppelbyte-Zeichensatzdaten (Double-Byte Character Set oder DBCS) ist die Verwendung einer der Optionen für schnelles Laden erforderlich. Weitere Informationen zu Datenzugriffsmodi für schnelles Laden, die für Masseneinfügungen optimiert sind, finden Sie unter OLE DB Destination.

Option BESCHREIBUNG
Tabelle oder Sicht Lädt Daten in eine Tabelle oder Sicht im OLE DB-Ziel.
Tabelle oder Sicht - schnelles Laden Lädt Daten in eine Tabelle oder Sicht im OLE DB-Ziel und verwendet die Option für das schnelle Laden. Weitere Informationen zu Datenzugriffsmodi für schnelles Laden, die für Masseneinfügungen optimiert sind, finden Sie unter OLE DB Destination.
Variable für Tabellenname oder Sichtname Gibt den Namen der Tabelle oder Sicht in einer Variablen an.

Verwandte Informationen: Verwenden von Variablen in Paketen
Variable für Tabellenname oder Sichtname - schnelles Laden Gibt den Namen der Tabelle oder Sicht in einer Variablen an und verwendet zum Laden der Daten die Option für das schnelle Laden. Weitere Informationen zu Datenzugriffsmodi für schnelles Laden, die für Masseneinfügungen optimiert sind, finden Sie unter OLE DB Destination.
SQL-Befehl Lädt Daten mithilfe einer SQL-Abfrage in das OLE DB-Ziel.

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.

Dynamische Optionen (Datenzugriffsmodus)

Für jede der Einstellungen für Datenzugriffsmodus werden spezifische dynamische Optionen angezeigt. In den folgenden Abschnitten werden alle dynamischen Optionen, die für die einzelnen Einstellungen für Datenzugriffsmodus verfügbar sind, beschrieben.

Datenzugriffsmodus = Tabelle oder Sicht

Name der Tabelle oder Sicht
Wählen Sie den Namen der Tabelle oder Sicht aus einer Liste der verfügbaren Namen in der Datenquelle aus.

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

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

Datenzugriffsmodus = Tabelle oder Ansicht – schnelles Laden

Name der Tabelle oder Sicht
Wählen Sie mithilfe dieser Liste eine Tabelle oder Sicht in der Datenbank aus, oder erstellen Sie eine neue Tabelle, indem Sie auf Neuklicken.

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

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

Identität beibehalten
Gibt an, ob beim Laden von Daten Identitätswerte kopiert werden sollen. Diese Eigenschaft ist nur für die Option für das schnelle Laden verfügbar. Der Standardwert dieser Eigenschaft ist false.

NULL-Werte beibehalten
Gibt an, ob beim Laden von Daten NULL-Werte kopiert werden sollen. Diese Eigenschaft ist nur für die Option für das schnelle Laden verfügbar. Der Standardwert dieser Eigenschaft ist false.

Tabellensperre
Gibt an, ob die Tabelle während des Ladens gesperrt ist. Der Standardwert dieser Eigenschaft ist true.

Check-Einschränkungen
Gibt an, ob das Ziel beim Laden von Daten Einschränkungen überprüft. Der Standardwert dieser Eigenschaft ist true.

Zeilen pro Batch
Geben Sie die Anzahl der Zeilen in einem Batch an. Der Standardwert dieser Eigenschaft lautet -1und bedeutet, dass kein Wert zugewiesen wurde.

Hinweis

Löschen Sie im Dialogfeld Ziel-Editor für OLE DB den Inhalt des Textfelds, um anzugeben, dass für diese Eigenschaft kein benutzerdefinierter Wert zugewiesen werden soll.

Maximale Einfügungscommitgröße
Gibt die Batchgröße an, für die das OLE DB-Ziel bei schnellen Ladevorgängen die Durchführung eines Commits versucht. Der Wert 0 gibt an, dass nach dem Verarbeiten aller Zeilen für alle Daten in einem einzelnen Batch ein Commit ausgeführt wird.

Hinweis

Der Wert 0 bewirkt möglicherweise, dass das Paket bei der Ausführung nicht mehr reagiert, wenn das OLE DB-Ziel und andere Datenflusskomponenten dieselbe Quelltabelle aktualisieren. Um zu verhindern, dass die Paketausführung beendet wird, legen Sie die Option Maximale Einfügungscommitgröße auf 2147483647fest.

Wenn Sie für diese Eigenschaft einen Wert bereitstellen, führt das Ziel für Zeilen in Batches, die kleiner sind als (a) die Maximale Einfügungscommitgrößeoder (b) die verbleibenden Zeilen im Puffer, der gerade verarbeitet wird, einen Commit durch.

Hinweis

Einschränkungsfehler am Ziel bewirken, dass der gesamte Batch mit Zeilen, die durch Maximale Einfügungscommitgröße definiert sind, fehlschlägt.

Datenzugriffsmodus = Variable für Tabellenname oder Sichtname

Variablenname
Wählen Sie die Variable aus, die den Namen der Tabelle oder Sicht enthält.

Datenzugriffsmodus = Variable für Tabellenname oder Ansichtsname – schnelles Laden

Variablenname
Wählen Sie die Variable aus, die den Namen der Tabelle oder Sicht enthält.

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

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

Identität beibehalten
Gibt an, ob beim Laden von Daten Identitätswerte kopiert werden sollen. Diese Eigenschaft ist nur für die Option für das schnelle Laden verfügbar. Der Standardwert dieser Eigenschaft ist false.

NULL-Werte beibehalten
Gibt an, ob beim Laden von Daten NULL-Werte kopiert werden sollen. Diese Eigenschaft ist nur für die Option für das schnelle Laden verfügbar. Der Standardwert dieser Eigenschaft ist false.

Tabellensperre
Gibt an, ob die Tabelle während des Ladens gesperrt ist. Der Standardwert dieser Eigenschaft ist false.

Check-Einschränkungen
Gibt an, ob Einschränkungen vom Task überprüft werden sollen. Der Standardwert dieser Eigenschaft ist false.

Zeilen pro Batch
Geben Sie die Anzahl der Zeilen in einem Batch an. Der Standardwert dieser Eigenschaft lautet -1und bedeutet, dass kein Wert zugewiesen wurde.

Hinweis

Löschen Sie im Dialogfeld Ziel-Editor für OLE DB den Inhalt des Textfelds, um anzugeben, dass für diese Eigenschaft kein benutzerdefinierter Wert zugewiesen werden soll.

Maximale Einfügungscommitgröße
Gibt die Batchgröße an, für die das OLE DB-Ziel bei schnellen Ladevorgängen die Durchführung eines Commits versucht. Der Standardwert 2147483647 zeigt an, dass nach dem Verarbeiten aller Zeilen für alle Daten in einem einzelnen Batch ein Commit durchgeführt wird.

Hinweis

Der Wert 0 bewirkt möglicherweise, dass das Paket bei der Ausführung nicht mehr reagiert, wenn das OLE DB-Ziel und andere Datenflusskomponenten dieselbe Quelltabelle aktualisieren. Um zu verhindern, dass die Paketausführung beendet wird, legen Sie die Option Maximale Einfügungscommitgröße auf 2147483647fest.

Datenzugriffsmodus = SQL-Befehl

SQL-Befehlstext
Geben Sie den Text einer SQL-Abfrage ein, und erstellen Sie die Abfrage, indem Sie auf Abfrage erstellenklicken, oder suchen Sie nach der Datei, die den Abfragetext enthält, indem Sie auf Durchsuchenklicken.

Hinweis

Vom OLE DB-Ziel werden keine Parameter unterstützt. Wenn Sie eine parametrisierte INSERT-Anweisung ausführen müssen, ziehen Sie die Transformation für den OLE DB-Befehl in Betracht. Weitere Informationen finden Sie unter OLE DB Command Transformation.

Abfrage erstellen
Mithilfe des Dialogfelds Abfrage-Generator können Sie die SQL-Abfrage visuell erstellen.

Durchsuchen
Mithilfe des Dialogfelds Öffnen können Sie nach der Datei suchen, die den Text der SQL-Abfrage enthält.

Abfrage analysieren
Überprüft die Syntax des Abfragetexts.

Ziel-Editor für OLE DB (Seite Zuordnungen)

Auf der Seite Zuordnungen des Dialogfelds Ziel-Editor für OLE DB können Sie eine Zuordnung von Eingabe- zu Zielspalten vornehmen.

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.

Ziel-Editor für OLE DB (Seite Fehlerausgabe)

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

Tastatur

Eingabe/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.

OLE DB-Quelle

Integration Services-Variablen (SSIS)

Datenfluss