IBM DB2 Verbindungsdetails
Einführung
Connector-Version
Diese Dokumentation basiert auf Version 23.0.9039 des Connectors.
Erste Schritte
DB2 Versionsunterstützung
Kompatibel mit DRDA-Gateway-Protokollversion 5 und höher. Kann auch eine Verbindung zum auf dem DB2 Server bereitgestellten DRDA-Gateway herstellen.
Herstellen einer Verbindung
Verbunden mit DB2
Legen Sie zum Verbinden die folgenden Eigenschaften fest:
Server
: Der Name des Servers, auf dem DB2 ausgeführt wird.Port
: Der Port, auf dem der DB2 -Server lauscht.Database
: Der Name der DB2 -Datenbank.
Authentifizieren gegenüber DB2
Der Connector unterstützt die direkte Authentifizierung bei DB2 mit Benutzeranmeldeinformationen sowie die Authentifizierung mit dem API Schlüssel einer in DB2 integrierten Anwendung wie beispielsweise Watson Query.
DB2 Benutzeranmeldeinformationen
Satz AuthScheme
Zu USRIDPWD
. Geben Sie die folgenden Anmeldeinformationen an:
User
: Der Benutzername eines Benutzers mit Zugriff auf die Datenbank.Password
: Das Passwort eines Benutzers mit Zugriff auf die Datenbank.
ICH BIN
Der Connector unterstützt die Authentifizierung beim DB2 -Server mithilfe des API Schlüssels einer Anwendung, die eine Verbindung mit ihm herstellt, beispielsweise Watson Query.
Satz AuthScheme
Zu IBMIAMAuth
. Geben Sie die folgenden Anmeldeinformationen an:
User
: Die IBMid oder Service-ID, die an einen Benutzer des DB2 -Servers gebunden ist.Password
: Der mit der Anwendung verknüpfte API Schlüssel, der Zugriff auf die DB2 -Datenbank benötigt.
Unterstützte CCSIDs
Der Connector ist mit DB2 -Instanzen mit den folgenden CCSIDs kompatibel. Wenn Ihr DB2 Server andere als die aufgelisteten CCSIDs verwendet, können Fehler aufgrund ungültiger Zeichensätze auftreten.
- 37
- 273
- 277
- 278
- 280
- 284
- 285
- 290
- 297
- 300
- 301
- 367
- 420
- 437
- 500
- 524
- 737
- 775
- 806
- 813
- 819
- 833
- 834
- 835
- 836
- 837
- 838
- 850
- 852
- 855
- 856
- 857
- 858
- 859
- 860
- 861
- 862
- 863
- 864
- 865
- 866
- 868
- 869
- 870
- 871
- 874
- 875
- 878
- 897
- 912
- 913
- 914
- 915
- 916
- 918
- 920
- 921
- 922
- 923
- 924
- 927
- 930
- 932
- 933
- 935
- 937
- 939
- 942
- 943
- 947
- 948
- 949
- 950
- 951
- 954
- 964
- 970
- 971
- 1006
- 1025
- 1026
- 1027
- 1041
- 1043
- 1046
- 1047
- 1051
- 1088
- 1089
- 1097
- 1098
- 1112
- 1114
- 1115
- 1122
- 1123
- 1124
- 1140
- 1141
- 1142
- 1143
- 1144
- 1145
- 1146
- 1147
- 1148
- 1149
- 1163
- 1200
- 1208
- 1250
- 1251
- 1252
- 1253
- 1254
- 1255
- 1256
- 1257
- 1258
- 1275
- 1280
- 1282
- 1283
- 1284
- 1285
- 1286
- 1351
- 1362
- 1363
- 1364
- 1370
- 1371
- 1380
- 1381
- 1382
- 1383
- 1385
- 1386
- 1388
- 1390
- 1392
- 1399
- 5026
- 5035
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 DB2 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.
Eigenschaft | Beschreibung |
---|---|
AuthScheme | Der Authentifizierungsmechanismus, den der Anbieter zur Authentifizierung bei DB2 verwendet. |
Server | Der Name des DB2 Servers. |
Port | Der Port, der für die Verbindung mit dem Server verwendet wird, auf dem sich die DB2 Datenbank befindet. |
Database | Der Name der DB2 Datenbank. |
User | Ein Datenbankbenutzer. |
Password | Das Passwort des Benutzers. |
UseSSL | Dieses Feld legt fest, ob SSL aktiviert ist. |
AlternateServers | Mit dieser Eigenschaft können Sie zusätzlich zu dem unter „Server“ und „Port“ konfigurierten Server mehrere weitere Server angeben. Geben Sie sowohl einen Servernamen als auch einen Port an; trennen Sie die Server durch Kommas. |
Eigenschaft | Beschreibung |
---|---|
SSLServerCert | Das vom Server zu akzeptierende Zertifikat bei einer Verbindung per TLS/SSL. |
Eigenschaft | Beschreibung |
---|---|
SSHAuthMode | Die beim Aufbau eines SSH-Tunnels zum Dienst verwendete Authentifizierungsmethode. |
SSHClientCert | Ein Zertifikat, das zur Authentifizierung des SSH-Benutzers verwendet werden soll. |
SSHClientCertPassword | Das Passwort des SSHClientCert-Schlüssels, falls vorhanden. |
SSHClientCertSubject | Der Betreff des SSH-Client-Zertifikats. |
SSHClientCertType | Der Typ des privaten SSHClientCert-Schlüssels. |
SSHServer | Der SSH-Server. |
SSHPort | Der SSH- Port. |
SSHUser | Der SSH-Benutzer. |
SSHPassword | Das SSH-Passwort. |
SSHServerFingerprint | Der Fingerabdruck des SSH-Servers. |
UseSSH | Ob die DB2 -Verbindung über SSH getunnelt werden soll. Verwenden Sie SSH. |
Eigenschaft | Beschreibung |
---|---|
Location | Ein Pfad zum Verzeichnis, das die Schema enthält, die Tabellen, Ansichten und gespeicherte Prozeduren definieren. |
BrowsableSchemas | Diese Eigenschaft beschränkt die gemeldeten Schemata auf eine Teilmenge der verfügbaren Schemata. Beispiel: BrowsableSchemas=SchemaA, SchemaB, SchemaC. |
Tables | Diese Eigenschaft beschränkt die gemeldeten Tabellen auf eine Teilmenge der verfügbaren Tabellen. Beispiel: Tabellen=TabelleA, TabelleB, TabelleC. |
Views | Beschränkt die gemeldeten Ansichten auf eine Teilmenge der verfügbaren Tabellen. Beispiel: Ansichten=AnsichtA, AnsichtB, AnsichtC. |
Eigenschaft | Beschreibung |
---|---|
AllowPreparedStatement | Bereiten Sie eine Abfrage vor ihrer Ausführung vor. |
CharBitDataAsString | Ein Boolescher Wert, der angibt, ob Parameter, Ergebnisdaten und Schema für iDB2CharBitData- und iDB2VarCharBitData-Objekte als String-Werte oder als Byte-Array-Werte behandelt werden. |
CharBitDataCcsid | Ein Int32-Wert, der angibt, welche CCSID zum Übersetzen der Typen iDB2CharBitData und iDB2VarCharBitData verwendet wird, wenn die Eigenschaft CharBitDataAsString auf true gesetzt ist. Diese Eigenschaft wird ignoriert, wenn CharBitDataAsString auf false gesetzt ist. |
TruncateString | Diese Eigenschaft gibt an, ob Zeichen abgeschnitten werden sollen, wenn INSERT oder UPDATE mit einer Zeichenfolge ausgeführt wird, die die Spaltengröße überschreitet. |
Schema | Das Schema, das standardmäßig verwendet wird. |
IgnoreCase | Ob die Groß-/Kleinschreibung bei Bezeichnern ignoriert werden soll. |
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. |
Other | Diese versteckten Eigenschaften werden nur in bestimmten Anwendungsfällen verwendet. |
QueryPassthrough | Diese Option übergibt die Abfrage unverändert an den DB2 -Server. |
SwitchMode | Mit dieser Eigenschaft können Sie einen Umschaltmodus angeben, um einen Server aus „AlternateServers“ als aktiven Server auszuwählen. |
SwitchStrategy | Mit dieser Eigenschaft können Sie eine Umschaltstrategie angeben, um einen Server aus „AlternateServers“ als aktiven Server auszuwählen. |
Timeout | Der Wert in Sekunden, bis der Timeout-Fehler auftritt und der Operation abgebrochen wird. |
Authentifizierung
Dieser Abschnitt enthält eine vollständige Liste der Authentifizierungseigenschaften, die Sie konfigurieren können.
Eigenschaft | Beschreibung |
---|---|
AuthScheme | Der Authentifizierungsmechanismus, den der Anbieter zur Authentifizierung bei DB2 verwendet. |
Server | Der Name des DB2 Servers. |
Port | Der Port, der für die Verbindung mit dem Server verwendet wird, auf dem sich die DB2 Datenbank befindet. |
Database | Der Name der DB2 Datenbank. |
User | Ein Datenbankbenutzer. |
Password | Das Passwort des Benutzers. |
UseSSL | Dieses Feld legt fest, ob SSL aktiviert ist. |
AlternateServers | Mit dieser Eigenschaft können Sie zusätzlich zu dem unter „Server“ und „Port“ konfigurierten Server mehrere weitere Server angeben. Geben Sie sowohl einen Servernamen als auch einen Port an; trennen Sie die Server durch Kommas. |
AuthScheme
Der Authentifizierungsmechanismus, den der Anbieter zur Authentifizierung bei DB2 verwendet.
Mögliche Werte
USRIDPWD
, EUSRIDPWD
, IBMIAMAuth
Datentyp
string
Standardwert
USRIDPWD
Hinweise
-
USRIDPWD: Stellen Sie dies ein, um Benutzer-ID und Passwort zur Authentifizierung zu verwenden.
-
EUSRIDPWD: Stellen Sie dies ein, um verschlüsselte Benutzer-ID und verschlüsseltes Passwort zur Authentifizierung zu verwenden.
-
IBMIAMAuth: Stellen Sie dies ein, um Benutzer-ID und Passwort (API-Schlüssel) zur Verbindung mit Watson Query zu verwenden.
Server
Der Name des DB2 Servers.
Datentyp
string
Standardwert
""
Hinweise
Diese Eigenschaft sollte auf den Namen oder die Netzwerkadresse des Servers festgelegt werden, auf dem die DB2 Datenbank gehostet wird.
Port
Der Port, der für die Verbindung mit dem Server verwendet wird, auf dem die DB2 Datenbank gehostet wird.
Datentyp
string
Standardwert
50000
Hinweise
Der Port, der für die Verbindung mit dem Server verwendet wird, auf dem die DB2 Datenbank gehostet wird.
Datenbank
Der Name der DB2 Datenbank.
Datentyp
string
Standardwert
""
Hinweise
Der Name der DB2 -Datenbank, die auf dem angegebenen Server läuft. Um eine Verbindung zur Datenbank herzustellen, müssen Sie außerdem einen Benutzer angeben und Passwort für einen Benutzer, der zum Zugriff auf die Datenbank berechtigt ist.
Benutzer
Ein Datenbankbenutzer.
Datentyp
string
Standardwert
""
Hinweise
Der Benutzername eines Benutzers, der zum Zugriff auf die Datenbank berechtigt ist.
Passwort
Das Passwort des Benutzers.
Datentyp
string
Standardwert
""
Hinweise
Das zur Authentifizierung bei der Datenbank bereitgestellte Passwort.
Verwenden Sie SSL
Dieses Feld legt fest, ob SSL aktiviert ist.
Datentyp
bool
Standardwert
false
Hinweise
Dieses Feld legt fest, ob der Connector versucht, TLS/SSL-Verbindungen mit dem Server auszuhandeln. Standardmäßig prüft der Connector das Zertifikat des Servers anhand des vertrauenswürdigen Zertifikatspeichers des Systems. Um ein anderes Zertifikat anzugeben, legen Sie SSLServerCert fest.
AlternativeServer
Mit dieser Eigenschaft können Sie zusätzlich zu dem unter „Server“ und „Port“ konfigurierten Server mehrere weitere Server angeben. Geben Sie sowohl einen Servernamen als auch einen Port an. Trennen Sie die Server durch Kommas.
Datentyp
string
Standardwert
""
Hinweise
Mit dieser Eigenschaft können Sie zusätzlich zu dem in Server konfigurierten Server weitere Server angeben und Port. Sie müssen alle Server mit angeben AlternateServers
, Server und Port.
Geben Sie in sowohl einen Servernamen als auch einen Port an AlternateServers
; Server durch Komma trennen. Beispiel:
Server=localhost;Port=27017;AlternateServers=localhost:27018,localhost:27019;
SSL
Dieser Abschnitt enthält eine vollständige Liste der SSL-Eigenschaften, die Sie konfigurieren können.
Eigenschaft | Beschreibung |
---|---|
SSLServerCert | Das vom Server zu akzeptierende Zertifikat bei einer Verbindung per TLS/SSL. |
SSLServerCert
Das vom Server zu akzeptierende Zertifikat bei einer Verbindung über TLS/SSL.
Datentyp
string
Standardwert
""
Hinweise
Bei Verwendung einer TLS/SSL-Verbindung kann diese Eigenschaft verwendet werden, um das vom Server zu akzeptierende TLS/SSL-Zertifikat anzugeben. Jedes andere Zertifikat, dem der Computer nicht vertraut, wird abgelehnt.
Diese Eigenschaft kann folgende Formen annehmen:
Beschreibung | Beispiel |
---|---|
Ein vollständiges PEM-Zertifikat (Beispiel der Kürze halber gekürzt) | -----BEGIN CERTIFICATE----- MIIChTCCAe4CAQAwDQYJKoZIhv......Qw== -----END CERTIFICATE----- |
Ein Pfad zu einer lokalen Datei, die das Zertifikat enthält | C:\\cert.cer |
Der öffentliche Schlüssel (Beispiel der Kürze halber gekürzt) | -----BEGIN RSA PUBLIC KEY----- MIGfMA0GCSq......AQAB -----END RSA PUBLIC KEY----- |
Der MD5-Fingerabdruck (Hex-Werte können auch durch Leerzeichen oder Doppelpunkte getrennt sein) | ecadbdda5a1529c58a1e9e09828d70e4 |
Der SHA1-Fingerabdruck (Hex-Werte können auch durch Leerzeichen oder Doppelpunkte getrennt sein) | 34a929226ae0819f2ec14b4a3d904f801cbb150d |
Wenn nicht angegeben, wird jedes vom Computer vertrauenswürdige Zertifikat akzeptiert.
Zertifikate werden vom Computer basierend auf dem Trust Store des Systems als vertrauenswürdig validiert. Der verwendete Trust Store ist der für das System angegebene Wert „javax.net.ssl.trustStore“. Wenn für diese Eigenschaft kein Wert angegeben ist, wird der Standard-Trust Store von Java verwendet (z. B. JAVA_HOME\lib\security\cacerts).
Verwenden Sie „*“, um anzugeben, dass alle Zertifikate akzeptiert werden. Beachten Sie, dass dies aus Sicherheitsgründen nicht empfohlen wird.
SSH
Dieser Abschnitt enthält eine vollständige Liste der SSH-Eigenschaften, die Sie konfigurieren können.
Eigenschaft | Beschreibung |
---|---|
SSHAuthMode | Die beim Aufbau eines SSH-Tunnels zum Dienst verwendete Authentifizierungsmethode. |
SSHClientCert | Ein Zertifikat, das zur Authentifizierung des SSH-Benutzers verwendet werden soll. |
SSHClientCertPassword | Das Passwort des SSHClientCert-Schlüssels, falls vorhanden. |
SSHClientCertSubject | Der Betreff des SSH-Client-Zertifikats. |
SSHClientCertType | Der Typ des privaten SSHClientCert-Schlüssels. |
SSHServer | Der SSH-Server. |
SSHPort | Der SSH- Port. |
SSHUser | Der SSH-Benutzer. |
SSHPassword | Das SSH-Passwort. |
SSHServerFingerprint | Der Fingerabdruck des SSH-Servers. |
UseSSH | Ob die DB2 -Verbindung über SSH getunnelt werden soll. Verwenden Sie SSH. |
SSHAuthMode
Die Authentifizierungsmethode, die beim Aufbau eines SSH-Tunnels zum Dienst verwendet wird.
Mögliche Werte
None
, Password
, Public_Key
Datentyp
string
Standardwert
Password
Hinweise
- Keine: Es wird keine Authentifizierung durchgeführt. Der aktuelle Benutzer-Wert wird ignoriert und die Verbindung wird als anonym angemeldet.
- Passwort: Der Connector verwendet die Werte von Benutzer und Passwort, um den Benutzer zu authentifizieren.
- Public_Key: Der Connector verwendet die Werte von Benutzer und SSHClientCert, um den Benutzer zu authentifizieren. SSHClientCert muss ein privater Schlüssel verfügbar sein, damit diese Authentifizierungsmethode erfolgreich ist.
SSHClientCert
Ein Zertifikat, das zur Authentifizierung des SSH-Benutzers verwendet werden soll.
Datentyp
string
Standardwert
""
Hinweise
SSHClientCert
muss einen gültigen privaten Schlüssel enthalten, um die Authentifizierung mit öffentlichem Schlüssel zu verwenden. Ein öffentlicher Schlüssel ist optional. Wenn keiner enthalten ist, generiert der Connector ihn aus dem privaten Schlüssel. Der Connector sendet den öffentlichen Schlüssel an den Server und die Verbindung wird zugelassen, wenn der Benutzer den öffentlichen Schlüssel autorisiert hat.
Der SSHClientCertType Feld gibt den Typ des durch angegebenen Schlüsselspeichers an SSHClientCert
. Wenn der Store kennwortgeschützt ist, geben Sie das Kennwort in SSHClientCertPassword an.
Einige Arten von Schlüsselspeichern sind Container, die mehrere Schlüssel enthalten können. Standardmäßig wählt der Connector den ersten Schlüssel im Speicher aus, Sie können jedoch mit SSHClientCertSubject einen bestimmten Schlüssel angeben.
SSHClientCertPassword
Das Passwort des SSHClientCert-Schlüssels, falls vorhanden.
Datentyp
string
Standardwert
""
Hinweise
Diese Eigenschaft wird nur bei der Authentifizierung gegenüber SFTP-Servern mit SSHAuthMode verwendet auf PublicKey und SSHClientCert gesetzt auf einen privaten Schlüssel gesetzt.
SSHClientCertSubject
Der Betreff des SSH-Client-Zertifikats.
Datentyp
string
Standardwert
*
Hinweise
Beim Laden eines Zertifikats wird der Betreff verwendet, um das Zertifikat im Speicher zu lokalisieren.
Wenn keine genaue Übereinstimmung gefunden wird, wird der Speicher nach Betreffs durchsucht, die den Wert der Eigenschaft enthalten.
Wenn immer noch keine Übereinstimmung gefunden wird, wird die Eigenschaft auf eine leere Zeichenfolge gesetzt und kein Zertifikat ausgewählt.
Der spezielle Wert „*“ wählt das erste Zertifikat im Zertifikatspeicher aus.
Der Betreff des Zertifikats ist eine durch Kommas getrennte Liste von Distinguished Name-Feldern und-Werten. Zum Beispiel „CN=www.server.com, OU=test, C=US, E=example@jbexample.com“. Allgemeine Felder und ihre Bedeutungen werden unten angezeigt.
Feld | Bedeutung |
---|---|
CN | Allgemeiner Name. Dies ist normalerweise ein Host wie www.server.com. |
O | Organisation |
OU | Organisationseinheit |
L | Ort |
S | Staat |
C | Land |
E | Email Adresse |
Wenn ein Feldwert ein Komma enthält, muss es in Anführungszeichen gesetzt werden.
SSHClientCertType
Der Typ des privaten SSHClientCert-Schlüssels.
Mögliche Werte
USER
, MACHINE
, PFXFILE
, PFXBLOB
, JKSFILE
, JKSBLOB
, PEMKEY_FILE
, PEMKEY_BLOB
, PPKFILE
, PPKBLOB
, XMLFILE
, XMLBLOB
Datentyp
string
Standardwert
PEMKEY_FILE
Hinweise
Diese Eigenschaft kann einen der folgenden Werte annehmen:
Typen | Beschreibung | Zulässige Blob-Werte |
---|---|---|
MASCHINE/BENUTZER | Auf dieser Plattform nicht verfügbar. | Blob-Werte werden nicht unterstützt. |
JKSFILE/JKSBLOB | Eine Java Schlüsselspeicher Datei. Muss sowohl ein Zertifikat als auch einen privaten Schlüssel enthalten. Nur in Java verfügbar. | Nur base64 |
PFXFILE/PFXBLOB | Eine Datei im PKCS12-Format (.pfx). Muss sowohl ein Zertifikat als auch einen privaten Schlüssel enthalten. | nur base64 |
PEMKEY_FILE/PEMKEY_BLOB | Eine Datei im PEM-Format. Muss einen privaten RSA-, DSA- oder OPENSSH-Schlüssel enthalten. Kann optional ein Zertifikat enthalten, das zum privaten Schlüssel passt. | Base64 oder einfacher Text. Zeilenumbrüche können durch Leerzeichen ersetzt werden, wenn der Blob als Text bereitgestellt wird. |
PPKFILE/PPKBLOB | Ein privater Schlüssel im PuTTY-Format, erstellt mit puttygen Werkzeug. | nur Base64 |
XMLFILE/XMLBLOB | Ein XML-Schlüssel im von der .NET RSA-Klasse generierten Format: RSA.ToXmlString(true) . | Base64 oder einfacher Text. |
SSH-Server
Der SSH-Server.
Datentyp
string
Standardwert
""
Hinweise
Der SSH-Server.
SSH-Port
Der SSH- Port.
Datentyp
string
Standardwert
22
Hinweise
Der SSH- Port.
SSHBenutzer
Der SSH-Benutzer.
Datentyp
string
Standardwert
""
Hinweise
Der SSH-Benutzer.
SSH-Passwort
Das SSH-Passwort.
Datentyp
string
Standardwert
""
Hinweise
Das SSH-Passwort.
SSHServerFingerprint
Der SSH-Server-Fingerabdruck.
Datentyp
string
Standardwert
""
Hinweise
Der SSH-Server-Fingerabdruck.
Verwenden Sie SSH
Gibt an, ob die DB2 -Verbindung über SSH getunnelt werden soll. Verwenden Sie SSH.
Datentyp
bool
Standardwert
false
Hinweise
Standardmäßig versucht der Connector, eine direkte Verbindung zu DB2 herzustellen. Wenn diese Option aktiviert ist, stellt der Connector stattdessen eine SSH-Verbindung mit dem SSHServer her und tunneln Sie die Verbindung zu DB2 dadurch.
Schema
Dieser Abschnitt enthält eine vollständige Liste der Schema, die Sie konfigurieren können.
Eigenschaft | Beschreibung |
---|---|
Location | Ein Pfad zum Verzeichnis, das die Schema enthält, die Tabellen, Ansichten und gespeicherte Prozeduren definieren. |
BrowsableSchemas | Diese Eigenschaft beschränkt die gemeldeten Schemata auf eine Teilmenge der verfügbaren Schemata. Beispiel: BrowsableSchemas=SchemaA, SchemaB, SchemaC. |
Tables | Diese Eigenschaft beschränkt die gemeldeten Tabellen auf eine Teilmenge der verfügbaren Tabellen. Beispiel: Tabellen=TabelleA, TabelleB, TabelleC. |
Views | Beschränkt die gemeldeten Ansichten auf eine Teilmenge der verfügbaren Tabellen. Beispiel: Ansichten=AnsichtA, AnsichtB, AnsichtC. |
Standort
Ein Pfad zum Verzeichnis, das die Schema enthält, die Tabellen, Ansichten und gespeicherte Prozeduren definieren.
Datentyp
string
Standardwert
%APPDATA%\DB2 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
Die Eigenschaft wird nur benötigt, wenn Sie Definitionen anpassen (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%\ DB2 Data Provider\Schema" mit %APPDATA%
wird auf das Konfigurationsverzeichnis des Benutzers eingestellt:
Plattform | %APPDATA% |
---|---|
Windows | Der Wert der Umfeld APPDATA |
Mac | ~/Bibliothek/Anwendungsunterstützung |
Linux | ~/.config |
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.
Verschiedenes
Dieser Abschnitt enthält eine vollständige Liste verschiedener Eigenschaften, die Sie konfigurieren können.
Eigenschaft | Beschreibung |
---|---|
AllowPreparedStatement | Bereiten Sie eine Abfrage vor ihrer Ausführung vor. |
CharBitDataAsString | Ein Boolescher Wert, der angibt, ob Parameter, Ergebnisdaten und Schema für iDB2CharBitData- und iDB2VarCharBitData-Objekte als String-Werte oder als Byte-Array-Werte behandelt werden. |
CharBitDataCcsid | Ein Int32-Wert, der angibt, welche CCSID zum Übersetzen der Typen iDB2CharBitData und iDB2VarCharBitData verwendet wird, wenn die Eigenschaft CharBitDataAsString auf true gesetzt ist. Diese Eigenschaft wird ignoriert, wenn CharBitDataAsString auf false gesetzt ist. |
TruncateString | Diese Eigenschaft gibt an, ob Zeichen abgeschnitten werden sollen, wenn INSERT oder UPDATE mit einer Zeichenfolge ausgeführt wird, die die Spaltengröße überschreitet. |
Schema | Das Schema, das standardmäßig verwendet wird. |
IgnoreCase | Ob die Groß-/Kleinschreibung bei Bezeichnern ignoriert werden soll. |
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. |
Other | Diese versteckten Eigenschaften werden nur in bestimmten Anwendungsfällen verwendet. |
QueryPassthrough | Diese Option übergibt die Abfrage unverändert an den DB2 -Server. |
SwitchMode | Mit dieser Eigenschaft können Sie einen Umschaltmodus angeben, um einen Server aus „AlternateServers“ als aktiven Server auszuwählen. |
SwitchStrategy | Mit dieser Eigenschaft können Sie eine Umschaltstrategie angeben, um einen Server aus „AlternateServers“ als aktiven Server auszuwählen. |
Timeout | Der Wert in Sekunden, bis der Timeout-Fehler auftritt und der Operation abgebrochen wird. |
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.
CharBitDataAsString
Ein Boolescher Wert, der angibt, ob Parameter, Ergebnisdaten und Schema für iDB2CharBitData- und iDB2VarCharBitData-Objekte als Zeichenfolgenwerte oder als Byte-Array-Werte behandelt werden.
Datentyp
bool
Standardwert
false
Hinweise
Wenn diese Eigenschaft auf „true“ gesetzt wird, kann die Anwendung die Daten als übersetzte Zeichenfolgen statt als Byte-Array abrufen. Der Standardwert ist „false“.
CharBitDataCcsid
Ein Int32-Wert, der angibt, welche CCSID zum Übersetzen der Typen iDB2CharBitData und iDB2VarCharBitData verwendet wird, wenn die Eigenschaft CharBitDataAsString auf true gesetzt ist. Diese Eigenschaft wird ignoriert, wenn CharBitDataAsString auf false gesetzt ist.
Datentyp
int
Standardwert
-1
Hinweise
Der Standardwert ist -1 und gibt an, dass die CCSID des Host für die Übersetzung verwendet wird. Der Link zur DB2 CCSID-Liste lautet: https://www.ibm.com/docs/en/db2/11.5?topic=miexdc-ccsids-encoding-names
Der Link zur DB2 iSeries/AS400 CCSID-Liste lautet: https://www.ibm.com/docs/en/i/7.5?topic=information-ccsid-values-defined-i
Zeichenfolge abschneiden
Diese Eigenschaft gibt an, ob Zeichen abgeschnitten werden sollen, wenn INSERT oder UPDATE mit einer Zeichenfolge ausgeführt wird, die die Spaltengröße überschreitet.
Datentyp
bool
Standardwert
false
Hinweise
Der Standardwert ist „False“, was bedeutet, dass der Treiber eine Ausnahme auslöst, wenn ein Zeichenfolgenwert die Spaltengröße überschreitet.
Schema
Das Schema, das standardmäßig verwendet wird.
Datentyp
string
Standardwert
""
Hinweise
Durch Festlegen dieser Eigenschaft können Sie SQL-Befehle ausführen, ohne den Schema angeben zu müssen.
Groß-/Kleinschreibung ignorieren
Gibt an, ob die Groß-/Kleinschreibung in Bezeichnern ignoriert werden soll.
Datentyp
bool
Standardwert
false
Hinweise
Wenn IgnoreCase auf false (Standard) gesetzt ist, werden SQL-Bezeichner in derselben Schreibweise an DB2 gesendet, in der sie in der Abfrage vorkommen. Beispielsweise wird SELECT * FROM Table als SELECT * FROM "Table" gesendet.
Wenn IgnoreCase auf true gesetzt ist, werden SQL-Bezeichner vor dem Senden an DB2 in Großbuchstaben umgewandelt. Beispielsweise wird SELECT * FROM Table als SELECT * FROM "TABLE" gesendet.
Diese Eigenschaft wird nur wirksam, wenn QueryPassThrough auf „false“ gesetzt ist.
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.
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
Eigenschaft | Beschreibung |
---|---|
DefaultColumnSize | Legt die Standardlänge von Zeichenfolgefeldern fest, wenn die Datenquelle keine Spaltenlänge in den Metadaten bereitstellt. Der Standardwert ist 2000. |
ConvertDateTimeToGMT | Bestimmt, ob Datums-/Uhrzeitwerte in GMT statt in die lokale Zeit des Computers konvertiert werden sollen. |
RecordToFile=filename | Protokolliert den zugrunde liegenden Socket-Datenübertragungsvorgang in die angegebene Datei. |
QueryPassthrough
Diese Option übergibt die Abfrage unverändert an den DB2 -Server.
Datentyp
bool
Standardwert
false
Hinweise
Wenn dies festgelegt ist, werden Abfragen direkt an DB2 weitergeleitet.
SwitchMode
Mit dieser Eigenschaft können Sie einen Umschaltmodus angeben, um einen Server aus AlternateServers als aktiven Server auszuwählen.
Mögliche Werte
None
, Failover
, LoadBalance
Datentyp
string
Standardwert
Failover
Hinweise
Es stehen drei Umschaltmodi zur Verfügung: Keine: Immer den Standardserver verwenden. Failover: Wenn auf den aktiven Server nicht zugegriffen werden kann, wird ein anderer Server in AlternativeServer wird als aktiver Server verwendet. LoadBalance: Diese Option beinhaltet die Funktion „Failover“. Darüber hinaus wird der aktive Server auch nach dem Festschreiben einer Transaktion geändert.
SwitchMode angeben:
SwitchMode=Failover;
Strategie wechseln
Mit dieser Eigenschaft können Sie eine Umschaltstrategie angeben, um einen Server aus AlternateServers als aktiven Server auszuwählen.
Mögliche Werte
Sequence
, Random
, BestResponse
Datentyp
string
Standardwert
sequence
Hinweise
Es stehen drei Umschaltstrategien zur Verfügung: Reihenfolge: Immer den nächsten Server in AlternativeServer verwenden als aktiver Server. Zufällig: Verwenden Sie einen zufälligen Server in AlternateServers als aktiven Server. BestResponse: Immer den Server mit der kürzesten Antwortzeit verwenden.
SwitchStrategy angeben:
SwitchStrategy=Random;
Zeitüberschreitung
Der Wert in Sekunden, bis der Timeout-Fehler auftritt und der Operation abgebrochen wird.
Datentyp
int
Standardwert
60
Hinweise
Wenn Timeout
= 0, Operationen werden nicht abgebrochen. Die Operationen werden ausgeführt, bis sie erfolgreich abgeschlossen sind oder bis ein Fehler auftritt.
Wenn Timeout
abläuft und der Operation noch nicht abgeschlossen ist, löst der Connector eine Ausnahme aus.