Details zur Oracle Database

Einführung

Connector-Version

Diese Dokumentation basiert auf Version 23.0.8895 des Connectors.

Erste Schritte

Oracle OCI-Versionsunterstützung

Der Connector kann eine Verbindung mit Oracle Database 11.2 oder höher herstellen.

Herstellen einer Verbindung

Vor dem Anschließen

Um eine Verbindung zu Oracle herzustellen, müssen Sie zunächst die entsprechende Umfeld aktualisieren. Diese Variable muss einen Ordnerspeicherort enthalten, der die erforderlichen Oracle OCI Library-Assemblys enthält. Die richtige Umfeld hängt von Ihrer Plattform ab:

• Windows: Die nativen Bibliotheken sollten sich in Ihrem PATH befinden.
• Mac: Die nativen Bibliotheken sollten sich in Ihrem DYLIB_LIBRARY_PATH befinden.
• Linux: Die nativen Bibliotheken sollten sich in Ihrem LD_LIBRARY_PATH befinden.

Laden Sie hier die Oracle OCI Library-Assemblies herunter (ZIP).

Note for Linux Users: Die vom Connector verwendeten Linux Oracle OCI-Bibliotheken weisen zusätzliche erforderliche Abhängigkeiten von den AIO- und libgcc-Bibliotheken auf.

• Debian/Ubuntu:

  sudo apt-get install libaio1
  

  apt-get install libc6 libstdc++6 zlib1g libgcc1
  

• RHEL/CentOS/Fedora:

  sudo yum install libaio
  

  yum install glibc libstdc++ zlib libgcc
  

Hier sind die entsprechenden Bibliotheken, die der Connector benötigt:

Herstellen einer Verbindung zu Oracle OCI

Folgende Verbindungsarten stehen zur Verfügung:

• Oracle Server
• OracleTNS LDAP

Oracle Server

Nachdem Sie die entsprechenden Bibliotheken zu Ihrem PATH hinzugefügt haben, legen Sie zum Verbinden Folgendes fest:

• User: Die für die Authentifizierung bei der Oracle-Datenbank angegebene Benutzer-ID.
• Password: Das für die Authentifizierung bei der Oracle-Datenbank bereitgestellte Kennwort.
• Port: Der Port, der für die Verbindung mit dem Server verwendet wird, auf dem die Oracle-Datenbank gehostet wird.
• ServiceName: Der Dienstname der Oracle-Datenbank. Sie können diesen Wert erhalten, indem Sie global_name abfragen (select * from global_name) mithilfe der Oracle SQL*PLUS-Befehlszeile.
• Server: Der Host oder die IP-Adresse des Servers, auf dem die Oracle-Datenbank gehostet wird.

OracleTNS

Legen Sie vor dem Verbinden die folgenden Verbindungseigenschaften fest:

• User: Die für die Authentifizierung bei der Oracle-Datenbank angegebene Benutzer-ID.
• Password: Das für die Authentifizierung bei der Oracle-Datenbank bereitgestellte Kennwort.
• DataSource: Der Oracle Net Services Name, Connect Descriptor (auch bekannt als TNS Connect String) oder ein Verbindungsname, der die Datenbank identifiziert, mit der eine Verbindung hergestellt werden soll. Sie sollten diese Werte in Ihrer Datei tnsnames.ora finden können.

Zum Beispiel,

DataSource='(DESCRIPTION=(ADDRESS=(protocol_address_information))(CONNECT_DATA= (SERVICE_NAME=service_name)))'

LDAP

In diesem Schema müssen Sie sich beim LDAP -Server authentifizieren. Legen Sie zum Herstellen der Verbindung die folgenden Verbindungseigenschaften fest:

• User: Die für die Authentifizierung bei der Oracle-Datenbank angegebene Benutzer-ID.
• Password: Das für die Authentifizierung bei der Oracle-Datenbank bereitgestellte Kennwort.
• LDAPUri: Die LDAP URI, die für die Verbindung mit dem LDAP -Server verwendet wird.
• LDAPUser: Das Benutzerkonto für den LDAP -Server.
• LDAPPassword: Das Passwort für den LDAP -Benutzer.

Ihre Verbindungszeichenfolge sollte ungefähr wie folgt aussehen:

LDAPUri=ldap://myldap.com:389/SERVICE_EXMPL,cn=OracleContext,dc=example,dc=com; User=ORACLEUSER; Password=OracleUserPassword;

Beachten Sie, dass für diesen Verbindungstyp sowohl Ihr Oracle als auch LDAP -Benutzername und-Passwort erforderlich sind. Ihr Systemadministrator kann anonyme LDAP Anmeldungen zulassen. In diesem Fall sind Ihr LDAP-Benutzername und Ihr LDAP -Passwort nicht erforderlich.

Wichtige Hinweise

Konfigurationsdateien und ihre Pfade

• Alle Verweise auf das Hinzufügen von Konfigurationsdateien und deren Pfaden beziehen sich auf Dateien und Speicherorte auf dem Jitterbit-Agenten, auf dem der Connector installiert ist. Diese Pfade sind je nach Agent und Operationssystem entsprechend anzupassen. Wenn mehrere Agenten in einer Agentengruppe verwendet werden, werden auf jedem Agenten identische Dateien benötigt.

Erweiterte Funktionen

In diesem Abschnitt wird eine Auswahl erweiterter Funktionen des Oracle OCI-Connectors beschrieben.

SSL-Konfiguration

SSL-Konfiguration verwenden, um anzupassen, wie der Connector TLS/SSL-Zertifikatsverhandlungen handhabt. Sie können aus verschiedenen Zertifikatsformaten wählen; siehe SSLServerCert-Eigenschaft unter „Verbindungszeichenfolgenoptionen“ für weitere Informationen.

Proxy

So konfigurieren Sie den Connector mit privaten Agent-Proxy-Einstellungen, wählen Sie die Use Proxy Settings Kontrollkästchen auf dem Verbindungskonfigurationsbildschirm.

SSL-Konfiguration

Anpassen der SSL-Konfiguration

Standardmäßig versucht der Connector, SSL/TLS auszuhandeln, indem er das Zertifikat des Servers mit dem vertrauenswürdigen Zertifikatspeicher des Systems vergleicht.

Um ein anderes Zertifikat anzugeben, siehe SSLServerCert Eigenschaft für die verfügbaren Formate, um dies zu tun.

Erweiterte Konfigurationseigenschaften

Die erweiterten Konfigurationseigenschaften sind die verschiedenen Optionen, die zum Herstellen einer Verbindung verwendet werden können. Dieser Abschnitt enthält eine vollständige Liste der Optionen, die Sie konfigurieren können. Klicken Sie auf die Links, um weitere Einzelheiten zu erfahren.

Authentifizierung

Schema

Verschiedenes

Authentifizierung

Dieser Abschnitt enthält eine vollständige Liste der Authentifizierungseigenschaften, die Sie konfigurieren können.

Verbindungstyp

Verbindungseigenschaften, die zur Authentifizierung verwendet werden sollen. Akzeptierte Einträge sind Server, OracleTNS, LDAP.

Mögliche Werte

Server, OracleTNS, LDAP

Datentyp

string

Standardwert

Server

Hinweise

Zusammen mit Passwort und Benutzer wird dieses Feld verwendet, um Verbindungseigenschaften auszuwählen, die zur Authentifizierung gegenüber dem Server verwendet werden. „Server“ ist die Standardoption. Verwenden Sie die folgenden Optionen:

• Server: Legen Sie diese Einstellung fest, um eine Verbindung mit dem Server über seine Adresse, Port und seinen Dienstnamen herzustellen.
• OracleTNS: Legen Sie dies fest, um für die Verbindung mit dem Server TNS-Einträge zu verwenden.
• LDAP: Legen Sie diese Option fest, um eine Verbindung zum LDAP -Server herzustellen und die Oracle-Serververbindung mit dem vom LDAP -Server gespeicherten TNS-Eintrag aufzulösen.

Server

Der Host oder die IP des Servers, auf dem die Oracle-Datenbank gehostet wird.

Datentyp

string

Standardwert

""

Hinweise

Der Host oder die IP des Servers, auf dem die Oracle-Datenbank gehostet wird.

Port

Der Port, der für die Verbindung mit dem Server verwendet wird, auf dem die Oracle-Datenbank gehostet wird.

Datentyp

string

Standardwert

1521

Hinweise

Der Port, der für die Verbindung mit dem Server verwendet wird, auf dem die Oracle-Datenbank gehostet wird.

Dienstname

Der Dienstname der Oracle-Datenbank.

Datentyp

string

Standardwert

""

Hinweise

Der Dienstname der Oracle-Datenbank, beispielsweise XE.

Sie können diesen Wert erhalten, indem Sie global_name von der Oracle SQL-Befehlszeile aus abfragen.

Benutzer

Das zur Authentifizierung verwendete Oracle OCI-Benutzerkonto.

Datentyp

string

Standardwert

""

Hinweise

Zusammen mit Passwort, wird dieses Feld zur Authentifizierung gegenüber dem Oracle OCI-Server verwendet.

Passwort

Das zur Authentifizierung des Benutzers verwendete Passwort.

Datentyp

string

Standardwert

""

Hinweise

Der Benutzer Und Password werden zusammen zur Authentifizierung beim Server verwendet.

Datenquelle

Oracle Net Services-Name, Connect-Deskriptor (auch als TNS Connect String bekannt) oder eine einfache Connect-Benennung, die die Datenbank identifiziert, mit der eine Verbindung hergestellt werden soll.

Datentyp

string

Standardwert

""

Hinweise

Oracle Net Services-Name, Connect-Deskriptor (auch als TNS Connect String bekannt) oder eine einfache Connect-Benennung, die die Datenbank identifiziert, mit der eine Verbindung hergestellt werden soll.

LDAPUri

LDAP URI zum Verbinden mit dem LDAP -Server.

Datentyp

string

Standardwert

""

Hinweise

LDAP URI zum Verbinden mit dem LDAP -Server und zum Ermitteln des auf dem LDAP Server im TNS-Datensatzformat gespeicherten Dienstnamens von Oracle.

LDAPBenutzer

Das Benutzerkonto für den LDAP -Server.

Datentyp

string

Standardwert

""

Hinweise

Verwenden Sie es, wenn Ihr LDAP Server eine Autorisierung zum Binden benötigt. Lassen Sie es andernfalls leer.

LDAPPasswort

Das Kennwort für den LDAP Benutzer.

Datentyp

string

Standardwert

""

Hinweise

Verwenden Sie es, wenn Ihr LDAP Server eine Autorisierung zum Binden benötigt. Lassen Sie es andernfalls leer.

LDAPVersion

Die LDAP Version, die für die Verbindung mit dem Server und die Kommunikation mit diesem verwendet wird.

Datentyp

string

Standardwert

""

Hinweise

Setzen Sie diese Eigenschaft auf 2 oder 3. Der Connector stellt eine Verbindung zu einem Standard LDAP Client her, wie in RFC 1777, 2251 und anderen LDAP RFCs angegeben.

Geldbörse

Der Speicherort der Wallet des Clients, die das Operationssystem zum Einrichten einer sicheren TCPS-Verbindung benötigt.

Datentyp

string

Standardwert

""

Hinweise

Der Speicherort der Wallet des Clients, die das Operationssystem zum Einrichten einer sicheren TCPS-Verbindung benötigt.

Schema

Dieser Abschnitt enthält eine vollständige Liste der Schema, die Sie konfigurieren können.

Standort

Ein Pfad zum Verzeichnis, das die Schema enthält, die Tabellen, Ansichten und gespeicherte Prozeduren definieren.

Datentyp

string

Standardwert

%APPDATA%\OracleOci Data Provider\Schema

Hinweise

Der Pfad zu einem Verzeichnis, das die Schema für den Connector enthält (.rsd-Dateien für Tabellen und Ansichten, .rsb-Dateien für gespeicherte Prozeduren). Der Ordnerspeicherort kann ein relativer Pfad vom Speicherort der ausführbaren Datei sein. Der Location-Eigenschaft wird nur benötigt, wenn Sie Definitionen anpassen möchten (z. B. einen Spaltennamen ändern, eine Spalte ignorieren usw.) oder das Datenmodell mit neuen Tabellen, Ansichten oder gespeicherten Prozeduren erweitern möchten.

Wenn nichts angegeben wird, ist der Standardspeicherort „%APPDATA%\OracleOci Data Provider\Schema“ mit %APPDATA% wird auf das Konfigurationsverzeichnis des Benutzers eingestellt:

DurchsuchbareSchemas

Diese Eigenschaft beschränkt die gemeldeten Schemata auf eine Teilmenge der verfügbaren Schemata. Beispiel: BrowsableSchemas=SchemaA,SchemaB,SchemaC.

Datentyp

string

Standardwert

""

Hinweise

Das Auflisten der Schemata aus Datenbanken kann aufwändig sein. Die Bereitstellung einer Liste von Schemata in der Verbindungszeichenfolge verbessert die Leistung.

Tabellen

Diese Eigenschaft beschränkt die gemeldeten Tabellen auf eine Teilmenge der verfügbaren Tabellen. Beispiel: Tabellen=TabelleA,TabelleB,TabelleC.

Datentyp

string

Standardwert

""

Hinweise

Das Auflisten der Tabellen aus einigen Datenbanken kann teuer sein. Die Bereitstellung einer Liste von Tabellen in der Verbindungszeichenfolge verbessert die Leistung des Connectors.

Diese Eigenschaft kann auch als Alternative zum automatischen Auflisten von Ansichten verwendet werden, wenn Sie bereits wissen, mit welchen Sie arbeiten möchten, und es sonst zu viele wären.

Geben Sie die gewünschten Tabellen in einer durch Kommas getrennten Liste an. Jede Tabelle sollte ein gültiger SQL-Bezeichner sein, wobei alle Sonderzeichen mit eckigen Klammern, Anführungszeichen oder Backticks maskiert werden. Beispiel: Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space`.

Beachten Sie, dass Sie beim Herstellen einer Verbindung zu einer Datenquelle mit mehreren Schemata oder Katalogen den vollqualifizierten Namen der Tabelle in dieser Eigenschaft angeben müssen, wie im letzten Beispiel hier, um Mehrdeutigkeiten zwischen Tabellen zu vermeiden, die in mehreren Katalogen oder Schemata vorhanden sind.

Ansichten

Beschränkt die gemeldeten Ansichten auf eine Teilmenge der verfügbaren Tabellen. Beispiel: Ansichten=AnsichtA,AnsichtB,AnsichtC.

Datentyp

string

Standardwert

""

Hinweise

Das Auflisten der Ansichten aus einigen Datenbanken kann teuer sein. Die Bereitstellung einer Liste von Ansichten in der Verbindungszeichenfolge verbessert die Leistung des Connectors.

Diese Eigenschaft kann auch als Alternative zum automatischen Auflisten von Ansichten verwendet werden, wenn Sie bereits wissen, mit welchen Sie arbeiten möchten, und es sonst zu viele wären.

Geben Sie die gewünschten Ansichten in einer durch Kommas getrennten Liste an. Jede Ansicht sollte ein gültiger SQL-Bezeichner sein, wobei alle Sonderzeichen mit eckigen Klammern, Anführungszeichen oder Backticks maskiert werden. Beispiel: Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space`.

Beachten Sie, dass Sie beim Herstellen einer Verbindung zu einer Datenquelle mit mehreren Schemata oder Katalogen den vollqualifizierten Namen der Tabelle in dieser Eigenschaft angeben müssen, wie im letzten Beispiel hier, um Mehrdeutigkeiten zwischen Tabellen zu vermeiden, die in mehreren Katalogen oder Schemata vorhanden sind.

Synonyme einschließen

Fragen Sie Metadaten nach Synonymen ab, als wären sie die Originaltabellen.

Datentyp

bool

Standardwert

true

Hinweise

Standardmäßig ordnet der Connector Synonyme ihren übergeordneten Tabellen zu. Er fragt Spalten und ihre Primär-/Fremdschlüsselmetadaten ab, als wären sie die regulären Tabellen.

Wenn diese Eigenschaft auf „false“ gesetzt ist, listet der Connector keine Tabellen- und Ansichtssynonyme auf.

Wenn Sie diese Eigenschaft auf „false“ setzen, verbessert dies die Metadatenleistung. Erwägen Sie dies, wenn Sie Metadaten von Synonymen nicht automatisch anfordern müssen.

Metadatenbeschreibungen anzeigen

Steuert, ob Tabellen- und Spaltenbeschreibungen über die Plattform-Metadaten-APIs und sys_tables / sys_views / sys_tablecolumns zurückgegeben werden.

Datentyp

bool

Standardwert

false

Hinweise

Standardmäßig werden Tabellen- und Spaltenbeschreibungen nicht angezeigt, da Oracle OCI einen zusätzlichen Join in der Metaabfrage erfordert, der über das hinausgeht, was normalerweise zum Lesen von Systemansichten erforderlich ist, die die Objektkommentare beschreiben.

Wenn Sie diese Option aktivieren, werden Tabellen- und Spaltenbeschreibungen angezeigt. Dies kann Metadatenvorgänge bei großen Datensätzen verlangsamen.

Verwenden Sie DBAMetadataViews

Metadaten aus DBA_..-Systemansichten statt aus ALL_..-Systemansichten abfragen.

Datentyp

bool

Standardwert

false

Hinweise

Standardmäßig fragt der Connector Metadaten für die Objekte ab, auf die der aktuelle Benutzer zugreifen kann. Wenn der UseDBAMetadataViews-Eigenschaft auf „true“ gesetzt ist, Abfrage der Connector Metadaten für alle entsprechenden Objekte in der Datenbank ab.

Diese Option funktioniert nicht, wenn der aktuelle Benutzer nicht über ausreichende Berechtigungen zum Zugriff auf DBA_..-Systemansichten verfügt.

Verschiedenes

Dieser Abschnitt enthält eine vollständige Liste verschiedener Eigenschaften, die Sie konfigurieren können.

AllowPreparedStatement

Bereiten Sie eine Abfrage vor ihrer Ausführung vor.

Datentyp

bool

Standardwert

true

Hinweise

Wenn die AllowPreparedStatement-Eigenschaft auf „false“ gesetzt ist, werden Anweisungen bei jeder Ausführung analysiert. Das Setzen dieser Eigenschaft auf „false“ kann nützlich sein, wenn Sie viele verschiedene Abfragen nur einmal ausführen.

Wenn Sie dieselbe Abfrage wiederholt ausführen, erzielen Sie im Allgemeinen eine bessere Leistung, wenn Sie diese Eigenschaft auf dem Standardwert „true“ belassen. Durch die Vorbereitung der Abfrage wird vermieden, dass dieselbe Abfrage immer wieder neu kompiliert wird. Vorbereitete Anweisungen erfordern jedoch auch, dass der Connector die Verbindung aktiv und offen hält, während die Anweisung vorbereitet wird.

MaxLobSize

Das Volumen in Bytes oder UTF-8-Zeichen, das durch eine nicht parametrisierte SELECT- Abfrage Abfrage werden darf.

Datentyp

int

Standardwert

2000

Hinweise

Wenn die MaxLobSize Eigenschaft ist auf 0 oder einen negativen Wert eingestellt, stattdessen wird der Standardwert von 2000 Bytes verwendet.

MaxRows

Begrenzt die Anzahl der zurückgegebenen Zeilen, wenn in der Abfrage keine Aggregation oder GROUP BY verwendet wird. Dies hat Vorrang vor LIMIT-Klauseln.

Datentyp

int

Standardwert

-1

Hinweise

Begrenzt die Anzahl der zurückgegebenen Zeilen, wenn in der Abfrage keine Aggregation oder GROUP BY verwendet wird. Dies hat Vorrang vor LIMIT-Klauseln.

NativeFolder

Der Pfad zum Verzeichnis mit den nativen DLLs, mit denen der Anbieter arbeitet. Diese Eigenschaft ist nur auf den Plattformen Windows und macOS wirksam.

Datentyp

string

Standardwert

""

Hinweise

Der Pfad zum Verzeichnis, das die nativen DLLs enthält, mit denen der Connector arbeitet. Standardmäßig verwendet der Connector die Standardsystemrichtlinie zum Laden der dynamischen Bibliotheken. Wenden Sie den vollständigen Pfad oder den Pfad relativ zu Ihrer ausführbaren Datei an.

Andere

Diese versteckten Eigenschaften werden nur in bestimmten Anwendungsfällen verwendet.

Datentyp

string

Standardwert

""

Hinweise

Die unten aufgeführten Eigenschaften sind für bestimmte Anwendungsfälle verfügbar. Für normale Anwendungsfälle und Funktionen von Treiber sollten diese Eigenschaften nicht erforderlich sein.

Geben Sie mehrere Eigenschaften in einer durch Semikolon getrennten Liste an.

Integration und Formatierung

QueryPassthrough

Diese Option übergibt die Abfrage unverändert an den Oracle OCI-Server.

Datentyp

bool

Standardwert

true

Hinweise

Wenn dies festgelegt ist, werden Abfragen direkt an Oracle OCI weitergeleitet.

Zeitüberschreitung bei erneuter Verbindung

Die Ruhezeit in Sekunden, bevor bei einem Fehler wegen Überschreitung der maximalen Leerlaufzeit erneut versucht wird, die Verbindung zum Server wiederherzustellen.

Datentyp

int

Standardwert

1

Hinweise

Die ReconnectTries-Eigenschaft muss größer als 0 sein, damit dieser Wert irgendeine Auswirkung hat.

Versuche erneut verbinden

Die Anzahl der erneuten Verbindungsversuche mit dem Server, wenn der Server einen Fehler bei Überschreitung der maximalen Leerlaufzeit meldet.

Datentyp

int

Standardwert

0

Hinweise

Durch Festlegen dieses Wertes kann der Connector automatisch die Verbindung wiederherstellen, wenn vom Server die Fehlermeldung „ORA-02396: maximale Leerlaufzeit überschritten“ empfangen wird. Der Standardwert ist ReconnectTries Die Eigenschaft ist auf 0 gesetzt, was bedeutet, dass die Anfrage nicht wiederholt wird.