Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gilt für:
SQL Server SSIS Integration Runtime in Azure Data Factory
Wichtig
Microsoft Connector für Oracle ist jetzt veraltet. Die Details beziehen sich auf die Ankündigung.
Das Oracle-Ziel lädt Daten per Massenladevorgang in die Oracle-Datenbank.
Das Ziel verwendet den Oracle-Verbindungs-Manager, um eine Verbindung mit einer Datenquelle herzustellen. Weitere Informationen finden Sie unter Oracle-Verbindungs-Manager.
Ein Oracle-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. Außerdem tritt zur Laufzeit ein Fehler auf, wenn die Eingabedaten nicht mit dem Typ der Zielspalte kompatibel sind. Je nach Einstellung des Fehlerverhaltens wird der Fehler ignoriert, führt zu einem Fehlschlag, oder die Zeile wird an die Fehlerausgabe umgeleitet.
Das Oracle-Ziel weist eine reguläre Eingabe und eine Fehlerausgabe auf.
Spalten mit nicht unterstützten Datentypen werden vor der Zuordnung unter Ausgabe einer Warnung gelöscht. Weitere Informationen finden Sie unter Unterstützung für Datentypen.
Ladeoptionen
Es werden zwei Lastmodi für den Zugriff unterstützt. Der Modus kann im Oracle-Ziel-Editor (Seite „Verbindungs-Manager“) festgelegt werden. Die beiden Modi sind:
Batchladevorgang: In diesem Modus werden Daten in Batches in eine Oracle-Tabelle geladen, und der gesamte Batch wird in derselben Transaktion eingefügt. Weitere Informationen dazu, wie Sie diesen Modus konfigurieren, finden Sie unter Oracle-Zieleditor (Seite „Verbindungs-Manager“) und Benutzerdefinierte Eigenschaften des Oracle-Ziels.
Schnelles Laden mithilfe von direktem Pfad: Hier wird der Modus des Treibers mit direktem Pfad zum Laden der Oracle-Tabelle verwendet. Es gibt Einschränkungen bei der Verwendung dieses Modus. Weitere Informationen finden Sie in der Oracle-Dokumentation.
Details dazu, wie dieser Modus konfiguriert wird, finden Sie unter: Oracle-Ziel-Editor (Seite „Verbindungs-Manager“) und Benutzerdefinierte Eigenschaften des Oracle-Ziels.
Fehlerbehandlung
Das Oracle-Ziel verfügt über eine Fehlerausgabe. Die Komponentenfehlerausgabe enthält die folgenden Ausgabespalten:
Fehlercode: Eine Zahl, die den Fehlertyp des aktuellen Fehlers darstellt. Als Absender des Fehlercodes kommen infrage:
- Oracle-Server. Weitere Informationen finden Sie in der detaillierten Fehlerbeschreibung der Dokumentation zur Oracle-Datenbank.
- SSIS Runtime. Eine Liste der SSIS-Fehlercodes finden Sie in der SSIS-Fehler- und Meldungsreferenz.
Fehlerspalte: Die Quellspaltennummer, die den Konvertierungsfehler verursacht hat.
Fehlerdatenspalten: Die Daten, die den Fehler verursachen.
Typen von Ausgabefehlern beim unterstützten Ladevorgang sind: Datenkonvertierung, Abschneiden oder Einschränkungsverletzung usw. Siehe Oracle-Ziel-Editor (Seite „Fehlerausgabe“).
DieMaximale Anzahl von Fehlern (MaxErrors)-Eigenschaft legt die maximale Anzahl von Fehlern fest, die auftreten können. Die Ausführung wird beendet und es werden Fehler zurückgegeben, wenn die maximale Anzahl erreicht ist. Nur Ausführungsdatensätze, die vor Erreichen der maximalen Anzahl von Fehlern liegen, werden in die Zieltabelle aufgenommen. Ausführliche Konfigurationsinformationen finden Sie unter Oracle-Ziel-Editor (Seite „Verbindungs-Manager“).
Parallelität
Im Batchlademodus gibt es keine Einschränkung für die Konfiguration paralleler Ausführungen, aber die Leistung kann durch den standardmäßigen Datensatz-Sperrmechanismus beeinträchtigt werden. Die Höhe des Leistungsverlustes hängt von den Daten und der Organisation der Tabelle ab.
Im Direct-Path-Protokoll (schnelles Laden) kann nur ein Oracle-Ziel so konfiguriert werden, dass es gleichzeitig für dieselbe Tabelle ausgeführt wird, kann jedoch den Parallelmodus verwenden.
Ein paralleler Direktpfad ermöglicht mehrere Direktpfad-Ladevorgänge, wobei mehrere Oracle-Ziele so konfiguriert werden können, dass sie gleichzeitig auf dieselbe Tabelle zugreifen. Oracle sperrt die Zieltabelle nicht exklusiv für die Verwendung in der Sitzung für schnelles Laden, sodass zusätzliche Zielkomponenten für schnelles Laden ausgeführt werden können, um dieselbe Zieltabelle parallel zu laden. Der parallele direkte Pfad ist restriktiver, und jede Verwendung der Parallelität sollte im Voraus geplant werden.
Es gibt keinen Grund, eine einzelne parallele Sitzung zu verwenden.
Informationen zu Einschränkungen bei der Verwendung paralleler Direktpfad-Ladevorgänge finden Sie in der Oracle-Dokumentation.
Weitere Informationen finden Sie unter Benutzerdefinierte Eigenschaften von Oracle-Zielen.
Problembehandlung des Oracle-Ziels
Sie können die ODBC-Aufrufe protokollieren, die die Oracle-Quelle an Oracle-Datenquellen richtet, um Probleme beim Exportieren von Daten zu beheben. Aktivieren Sie den ODBC-Trace des Treibermanagers, um die ODBC-Aufrufe zu protokollieren, die von der Oracle-Quelle an Oracle-Datenquellen abgesetzt werden. Weitere Informationen finden Sie in der Microsoft-Dokumentation zur Erstellung einer ODBC-Ablaufverfolgung mit dem ODBC-Datenquellen-Administrator.
Benutzerdefinierte Eigenschaften von Oracle-Zielen
In der folgenden Tabelle werden die benutzerdefinierten Eigenschaften des Oracle-Ziels beschrieben. Alle Eigenschaften sind lesbar und schreibbar.
| Eigenschaftsname | Datentyp | BESCHREIBUNG | Lademodus |
|---|---|---|---|
| Stapelgröße | Integer | Die Größe des Batches für den Massenladevorgang. Dies ist die Anzahl der Zeilen, die als Batch geladen werden. | Wird nur im Batchmodus verwendet. |
| DefaultCodePage | Integer | Die zu verwendende Codepage, wenn die Datenquelle keine Codepageinformationen enthält. Hinweis: Diese Eigenschaft wird nur vom Erweiterten Editor festgelegt. |
Verwendung für beide Modi. |
| FastLoad | Boolean | Gibt an, ob das schnelle Laden verwendet wird. Der Standardwert ist false. Dies kann auch im Oracle-Ziel-Editor (Seite „Verbindungs-Manager“) festgelegt werden. | Verwendung für beide Modi. |
| MaxErrors | Integer | Die Anzahl der Fehler, die auftreten können, bevor der Datenfluss abgebrochen wird. Der Standardwert ist 0(null). Dies bedeutet, dass die Fehlerzahl nicht begrenzt ist. Wenn Fluss umleiten auf der Seite Fehlerbehandlung ausgewählt ist. Bevor der Fehlerzahl-Grenzwert erreicht wird, werden alle Fehler in der Fehlerausgabe zurückgegeben. Weitere Informationen finden Sie unter Fehlerbehandlung. |
Verwendung nur im Modus für schnelles Laden. |
| NoLogging | Boolean | Gibt an, ob die Datenbankprotokollierung deaktiviert ist. Der Standardwert ist False, was bedeutet, dass die Protokollierung aktiviert ist. | Verwendung für beide Modi. |
| Parallel | Boolean | Gibt an, ob paralleles Laden zulässig ist.
True gibt an, dass andere Ladevorgänge für dieselbe Zieltabelle zulässig sind. Weitere Informationen finden Sie unter Parallelität. |
Verwendung nur im Modus für schnelles Laden. |
| TableName | String | Der Name der Tabelle mit den Daten, der verwendet werden. | Wird für beide Modi verwendet. |
| TableSubName | String | Der Untername oder die Unterpartition. Dieser Wert ist optional. Hinweis: Diese Eigenschaft kann nur im Erweiterten Editor festgelegt werden. |
Verwendung nur im Modus für schnelles Laden. |
| Transaktionsgröße | Integer | Die Anzahl von Einfügungen, die in einer einzelnen Transaktion möglich sind. Der Standardwert ist BatchSize. | Wird nur im Batchmodus verwendet. |
| TransferBufferSize | Integer | Die Größe des Übertragungspuffers. Der Standardwert ist 64 KB. | Verwendung nur im Modus für schnelles Laden. |
Konfigurieren des Oracle-Ziels
Sie können das Oracle-Ziel programmgesteuert oder mit dem SSIS-Designer konfigurieren.
Der Oracle-Ziel-Editor wird in der folgenden Abbildung dargestellt. Sie enthält die Seite „Verbindungs-Manager“, die Seite „Mappings“ und die Seite „Error Output“.
Weitere Informationen finden Sie in einem der folgenden Abschnitte:
- Oracle-Ziel-Editor (Seite „Verbindungs-Manager“)
- Oracle-Ziel-Editor (Seite „Zuordnungen“)
- Oracle-Ziel-Editor (Seite „Fehlerausgabe“)
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 Integration Services-Projekts mit der rechten Maustaste auf das Oracle-Ziel, 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 Benutzerdefinierte Eigenschaften von Oracle-Zielen.
Oracle-Ziel-Editor (Seite „Verbindungs-Manager“)
Verwenden Sie die Seite Verbindungs-Manager im Dialogfeld Oracle-Ziel-Editor, um den Oracle-Verbindungs-Manager für das Ziel auszuwählen. Außerdem können Sie auf dieser Seite eine Tabelle oder Sicht aus der Datenbank auswählen.
Öffnen der Seite des Verbindungs-Managers im Oracle-Ziel-Editor
Öffnen Sie in SQL Server Data Tools das SQL Server Integration Services-Paket (SSIS), das das Oracle-Ziel enthält.
Doppelklicken Sie auf der Registerkarte „Datenfluss“ auf das ODBC-Ziel.
Klicken Sie im Oracle-Ziel-Editor auf „Verbindungs-Manager“.
Optionen
Verbindungs-Manager
Wählen Sie einen vorhandenen Verbindungs-Manager aus der Liste aus, oder klicken Sie auf Neu, um einen neuen Oracle-Verbindungs-Manager zu erstellen.
Neu
Klicken Sie auf Neu. Das Dialogfeld Oracle-Verbindungs-Manager-Editor, in dem Sie einen neuen 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 | Konfigurieren Sie das Oracle-Ziel, um im Batchmodus zu arbeiten. Optionen: Name der Tabelle oder Sicht: Wählen Sie in der Liste eine verfügbare Tabelle oder Sicht in der Datenbank aus. Transaktionsgröße: Anzahl von Einfügungen, die in einer einzelnen Transaktion möglich sind. Der Standardwert ist BatchSize. Batchgröße: Geben Sie die Größe des Batches (Anzahl der geladenen Zeilen) für das Massenladen ein. |
| Tabellenname – schnelles Laden | Konfigurieren Sie das Oracle-Ziel so, dass es im Schnelllademodus (Direct Path) arbeitet. Diese Optionen stehen zur Verfügung: Name der Tabelle oder Sicht: Wählen Sie in der Liste eine verfügbare Tabelle oder Sicht in der Datenbank aus. Paralleles Laden: Gibt an, ob paralleles Laden aktiviert ist. Weitere Informationen finden Sie unter Parallelität. Keine Protokollierung: Dieses Kontrollkästchen dient zum Deaktivieren der Datenbankprotokollierung. Diese Protokollierung ist eine Oracle-Datenbank, die für Wiederherstellungszwecke verwendet wird und nicht mit der Ablaufverfolgung in Zusammenhang steht. Maximale Anzahl von Fehlern: Die maximale Anzahl der Fehler, die auftreten können, bevor der Datenfluss abgebrochen wird. Der Standardwert ist 0, was bedeutet, dass es keine Zahlenbegrenzung gibt. Alle Fehler, die auftreten können, werden in der Fehlerausgabe zurückgegeben. Übertragungspuffergröße (KB) : Geben Sie die Größe des Übertragungspuffers ein. Die Standardgröße ist 64 KB. |
Vorhandene Daten anzeigen
Klicken Sie auf Vorhandene Daten anzeigen, um die ersten 200 Datenzeilen für die ausgewählte Tabelle anzuzeigen.
Editor für das Oracle-Ziel (Seite „Zuordnungen“)
Auf der Seite Zuordnungen des Dialogfelds Editor für Oracle-Ziel können Sie eine Zuordnung von Eingabe- zu Zielspalten vornehmen.
Öffnen der Seite „Zuordnungen“ des Oracle-Ziel-Editors
Öffnen Sie in SQL Server Data Tools das SQL Server Integration Services-Paket (SSIS), das das Oracle-Ziel enthält.
Doppelklicken Sie auf der Registerkarte „Datenfluss“ auf das ODBC-Ziel.
Klicken Sie im Oracle-Ziel-Editor auf „Zuordnungen“.
Optionen
Verfügbare Eingabespalten
Die Liste der verfügbaren Eingabespalten. Ziehen Sie eine Eingabespalte per Drag-and-drop auf eine verfügbare Zielspalte, um die Spalten zuzuordnen.
Verfügbare Zielspalten
Die Liste der verfügbaren Zielspalten. Ziehen Sie eine Zielspalte per Drag-and-drop auf eine verfügbare Eingabespalte, um die Spalten zuzuordnen.
Eingabespalte
Zeigt die von Ihnen ausgewählten Eingabespalten an. Sie können Zuordnungen entfernen, indem Sie <Ignorieren> auswählen, um Spalten aus der Ausgabe auszuschließen.
Zielspalte
Zeigt alle verfügbaren Zielspalten an, sowohl die zugeordneten als auch die nicht zugeordneten.
Hinweis
Spalten mit nicht unterstützten Datentypen werden mit einer Warnung aus der Zuordnung gelöscht.
Editor für Oracle-Ziel (Seite „Fehlerausgabe“)
Verwenden Sie die Seite „Fehlerausgabe“ im Dialogfeld „Oracle-Ziel-Editor“, um Optionen für die Fehlerbehandlung auszuwählen.
Öffnen der Seite „Fehlerausgabe“ des Oracle-Ziel-Editors
Öffnen Sie in SQL Server Data Tools das SQL Server Integration Services-Paket (SSIS), das das Oracle-Ziel enthält.
Doppelklicken Sie auf der Registerkarte „Datenfluss“ auf das ODBC-Ziel.
Klicken Sie im „Editor für Oracle-Ziel“ auf „Fehlerausgabe“.
Optionen
Fehlerverhalten
Wählen Sie, wie die Oracle-Quelle in einem Datenfluss mit Fehlern umgehen soll: den Fehler ignorieren, die Zeile umleiten oder die Komponente fehlschlagen lassen. Verwandter Abschnitt: Fehlerbehandlung in Daten
Abschneidung
Wählen Sie aus, wie die Oracle-Quelle die Abschneidung in einem Fluss behandeln soll: den Fehler ignorieren, die Zeile umleiten oder für die Komponente einen Fehler auslösen.