Zum Inhalt springen

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.

Authentifizierung

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.

SSL

Eigenschaft Beschreibung
SSLServerCert Das vom Server zu akzeptierende Zertifikat bei einer Verbindung per TLS/SSL.

SSH

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.

Schema

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.

Verschiedenes

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.