CockroachDB -Verbindungsdetails
Einführung
Connector-Version
Diese Dokumentation basiert auf Version 23.0.9039 des Connectors.
Erste Schritte
CockroachDB Versionsunterstützung
Der Connector ermöglicht einen standardbasierten Zugriff auf Cockroach DB Version 2.0 und höher.
Herstellen einer Verbindung
Verbindung zu CockroachDB herstellen
Stellen Sie Folgendes ein, um eine Verbindung zu Daten herzustellen.
Server: Der Host oder die IP-Adresse des Servers.Port: Die Port des CockroachDB -Servers. Wenn nicht angegeben, ist der Port 26257.Database: Der Name der Cockroach-Datenbank. Wenn nicht angegeben, stellt der Connector eine Verbindung zur Standarddatenbank des Benutzers her.User: Das zur Authentifizierung verwendete Cockroach DB-Benutzerkonto.Password: Das zur Authentifizierung des Benutzers verwendete Passwort.
Optimieren des Datenzugriffs
Optimieren des Datenzugriffs
Sie können die folgenden Eigenschaften verwenden, um mehr Kontrolle über die von CockroachDB zurückgegebenen Daten zu erhalten:
AllowPreparedStatement: Auf „true“ setzen, um die Vorbereitung einer Abfrage vor ihrer Ausführung zu ermöglichen.
Durch die Vorbereitung der Abfrage wird vermieden, dass die gleiche Abfrage immer wieder neu kompiliert werden muss. Allerdings muss die Verbindung während der Vorbereitung der Anweisung offen gelassen werden.TimeZone: Die für die aktuelle Sitzung zu verwendende Zeitzone.UseSSL: Dies bestimmt, ob der Connector versucht, TLS/SSL-Verbindungen zum Server auszuhandeln.
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 CockroachDB -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.
Client-SSL-Zertifikate
Der CockroachDB -Connector unterstützt auch das Festlegen von Client-Zertifikaten. Legen Sie Folgendes fest, um eine Verbindung mithilfe eines Client-Zertifikats herzustellen.
SSLClientCert: Der Name des Zertifikatspeichers für das Client-Zertifikat.SSLClientCertType: Der Typ des Schlüsselspeichers, der das TLS/SSL-Clientzertifikat enthält.SSLClientCertPassword: Das Passwort für das TLS/SSL-Client-Zertifikat.SSLClientCertSubject: Der Betreff des TLS/SSL-Client-Zertifikats.
Datentypzuordnung
Datentypzuordnungen
Der Connector ordnet Typen aus der Datenquelle dem entsprechenden im Schema verfügbaren Datentyp zu. Die folgende Tabelle dokumentiert diese Zuordnungen.
| CockroachDB | Schema |
|---|---|
abstime | Zeichenfolge |
aclitem | Zeichenfolge |
bigint | lang |
bigserial | lang |
bit varying | Zeichenfolge |
bit | Zeichenfolge |
boolean | |
box | Zeichenfolge |
bytea | binär |
char | Zeichenfolge |
character varying | Zeichenfolge |
character | Zeichenfolge |
cid | Zeichenfolge |
cidr | Zeichenfolge |
circle | Zeichenfolge |
date | Datum |
daterange | Zeichenfolge |
double precision | schweben |
gtsvector | Zeichenfolge |
inet | Zeichenfolge |
int2vector | Zeichenfolge |
int4range | Zeichenfolge |
int8range | Zeichenfolge |
integer | int |
json | Zeichenfolge |
jsonb | binär |
line | Zeichenfolge |
lseg | Zeichenfolge |
macaddr8 | Zeichenfolge |
macaddr | Zeichenfolge |
money | Dezimal |
name | Zeichenfolge |
numeric | Dezimal |
numrange | Zeichenfolge |
oid | Zeichenfolge |
oidvector | Zeichenfolge |
path | Zeichenfolge |
pg_dependencies | Zeichenfolge |
pg_lsn | Zeichenfolge |
pg_ndistinct | Zeichenfolge |
pg_node_tree | Zeichenfolge |
point | Zeichenfolge |
polygon | Zeichenfolge |
real | schweben |
refcursor | Zeichenfolge |
regclass | Zeichenfolge |
regconfig | Zeichenfolge |
regdictionary | Zeichenfolge |
regnamespace | Zeichenfolge |
regoper | Zeichenfolge |
regoperator | Zeichenfolge |
regproc | Zeichenfolge |
regprocedure | Zeichenfolge |
regrole | Zeichenfolge |
regtype | Zeichenfolge |
reltime | Zeichenfolge |
serial | int |
smallint | int |
smallserial | int |
smgr | Zeichenfolge |
text | Zeichenfolge |
tid | Zeichenfolge |
time with time zone | Zeichenfolge |
time without time zone | Zeit |
timestamp with time zone | Datum/Uhrzeit |
timestamp without time zone | Datum/Uhrzeit |
tinterval | Zeichenfolge |
tsquery | Zeichenfolge |
tsrange | Zeichenfolge |
tstzrange | Zeichenfolge |
tsvector | Zeichenfolge |
txid_snapshot | Zeichenfolge |
uuid | Zeichenfolge |
xid | Zeichenfolge |
xml | Zeichenfolge |
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 |
|---|---|
Server | Der Host oder die IP-Adresse des Servers. |
Port | Die Port des CockroachDB Servers. |
Database | Der Name der Cockroach-Datenbank. |
User | Das zur Authentifizierung verwendete CockroachDB -Benutzerkonto. |
Password | Das zur Authentifizierung des Benutzers verwendete Kennwort. |
UseSSL | Ob SSL aktiviert ist. |
Cluster | Der Name des CockroachDB Clusters. |
| Eigenschaft | Beschreibung |
|---|---|
SSLClientCert | Der TLS/SSL-Client-Zertifikatspeicher für die SSL-Client-Authentifizierung (bidirektionales SSL). |
SSLClientCertType | Der Typ des Schlüsselspeichers, der das TLS/SSL-Client-Zertifikat enthält. |
SSLClientCertPassword | Das Passwort für das TLS/SSL-Client-Zertifikat. |
SSLClientCertSubject | Der Betreff des TLS/SSL-Client-Zertifikats. |
SSLServerCert | Das vom Server zu akzeptierende Zertifikat bei einer Verbindung per TLS/SSL. |
| 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 | Ermöglicht die Vorbereitung einer Abfrage vor ihrer Ausführung. |
FetchResultSetMetadata | Dieses Feld legt fest, ob der Anbieter Metadaten zum Schema und Tabellennamen für vom Server zurückgegebene Ergebnismengenspalten abruft. |
IncludeTableTypes | Wenn auf „true“ gesetzt, Abfrage der Anbieter die Typen der einzelnen Tabellen und Ansichten ab. |
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 CockroachDB -Server. |
Timeout | Der Wert in Sekunden, bis der Timeout-Fehler auftritt und der Operation abgebrochen wird. |
TimeZone | Die Zeitzone für die aktuelle Sitzung. |
Authentifizierung
Dieser Abschnitt enthält eine vollständige Liste der Authentifizierungseigenschaften, die Sie konfigurieren können.
| Eigenschaft | Beschreibung |
|---|---|
Server | Der Host oder die IP-Adresse des Servers. |
Port | Die Port des CockroachDB Servers. |
Database | Der Name der Cockroach-Datenbank. |
User | Das zur Authentifizierung verwendete CockroachDB -Benutzerkonto. |
Password | Das zur Authentifizierung des Benutzers verwendete Kennwort. |
UseSSL | Ob SSL aktiviert ist. |
Cluster | Der Name des CockroachDB Clusters. |
Server
Der Host oder die IP-Adresse des Servers.
Datentyp
string
Standardwert
localhost
Hinweise
Der Host oder die IP des Servers, auf dem die CockroachDB Datenbank gehostet wird. Wenn nicht festgelegt, wird der Standardwert „localhost“ verwendet.
Port
Die Port des CockroachDB Servers.
Datentyp
int
Standardwert
26257
Hinweise
Die Port des Servers hostet die CockroachDB Datenbank. Wenn nicht angegeben, wird die Standard Port 26257 verwendet.
Datenbank
Der Name der Cockroach-Datenbank.
Datentyp
string
Standardwert
""
Hinweise
Die Datenbank, mit der eine Verbindung zum CockroachDB Server hergestellt werden soll. Wenn keine Datenbank angegeben ist, wird die Standarddatenbank verwendet.
Benutzer
Das zur Authentifizierung verwendete CockroachDB Benutzerkonto.
Datentyp
string
Standardwert
""
Hinweise
Zusammen mit Passwort, wird dieses Feld zur Authentifizierung gegenüber dem CockroachDB -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.
Verwenden Sie SSL
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.
Cluster
Der Name des CockroachDB Clusters.
Datentyp
string
Standardwert
""
Hinweise
Der Cluster, mit dem eine Verbindung zum CockroachDB Server hergestellt werden soll. Nicht standardmäßig angegeben.
SSL
Dieser Abschnitt enthält eine vollständige Liste der SSL-Eigenschaften, die Sie konfigurieren können.
| Eigenschaft | Beschreibung |
|---|---|
SSLClientCert | Der TLS/SSL-Client-Zertifikatspeicher für die SSL-Client-Authentifizierung (bidirektionales SSL). |
SSLClientCertType | Der Typ des Schlüsselspeichers, der das TLS/SSL-Client-Zertifikat enthält. |
SSLClientCertPassword | Das Passwort für das TLS/SSL-Client-Zertifikat. |
SSLClientCertSubject | Der Betreff des TLS/SSL-Client-Zertifikats. |
SSLServerCert | Das vom Server zu akzeptierende Zertifikat bei einer Verbindung per TLS/SSL. |
SSLClientCert
Der TLS/SSL-Client-Zertifikatspeicher für die SSL-Client-Authentifizierung (bidirektionales SSL).
Datentyp
string
Standardwert
""
Hinweise
Der Name des Zertifikatspeichers für das Client-Zertifikat.
Der SSLClientCertType Feld gibt den Typ des durch angegebenen Zertifikatspeichers an SSLClientCert. Wenn der Store kennwortgeschützt ist, geben Sie das Kennwort in SSLClientCertPassword an.
SSLClientCert wird in Verbindung mit SSLClientCertSubject verwendet, um Client-Zertifikate anzugeben. Wenn SSLClientCert hat einen Wert und SSLClientCertSubject gesetzt ist, wird eine Suche nach einem Zertifikat eingeleitet. Siehe SSLClientCertSubject für weitere Informationen.
Die Bezeichnungen der Zertifikatsspeicher sind plattformabhängig.
Nachfolgend sind die Bezeichnungen der gebräuchlichsten Benutzer- und Maschinen-Zertifikatspeicher in Windows aufgeführt:
| Eigenschaft | Beschreibung |
|---|---|
MY | Ein Zertifikatsspeicher, der persönliche Zertifikate mit den zugehörigen privaten Schlüsseln enthält. |
CA | Zertifikate der Zertifizierungsstelle. |
ROOT | Stammzertifikate. |
SPC | Zertifikate von Softwareherstellern. |
In Java ist der Zertifikatsspeicher normalerweise eine Datei, die Zertifikate und optionale private Schlüssel enthält.
Wenn der Zertifikatsspeichertyp PFXFile ist, muss diese Eigenschaft auf den Namen der Datei gesetzt werden. Wenn der Typ PFXBlob ist, muss die Eigenschaft auf den binären Inhalt einer PFX-Datei gesetzt werden (z. B. PKCS12-Zertifikatsspeicher).
SSLClientCertType
Der Typ des Schlüsselspeichers, der das TLS/SSL-Clientzertifikat enthält.
Mögliche Werte
USER, MACHINE, PFXFILE, PFXBLOB, JKSFILE, JKSBLOB, PEMKEY_FILE, PEMKEY_BLOB, PUBLIC_KEY_FILE, PUBLIC_KEY_BLOB, SSHPUBLIC_KEY_FILE, SSHPUBLIC_KEY_BLOB, P7BFILE, PPKFILE, XMLFILE, XMLBLOB
Datentyp
string
Standardwert
USER
Hinweise
Diese Eigenschaft kann einen der folgenden Werte annehmen:
| Eigenschaft | Beschreibung |
|---|---|
USER - default | Unter Windows gibt dies an, dass es sich bei dem Zertifikatspeicher um einen Zertifikatspeicher handelt, der dem aktuellen Benutzer gehört. Beachten Sie, dass dieser Speichertyp in Java nicht verfügbar ist. |
MACHINE | Unter Windows gibt dies an, dass es sich bei dem Zertifikatspeicher um einen Maschinenspeicher handelt. Beachten Sie, dass dieser Speichertyp in Java nicht verfügbar ist. |
PFXFILE | Der Zertifikatsspeicher ist der Name einer PFX-Datei (PKCS12), die Zertifikate enthält. |
PFXBLOB | Der Zertifikatsspeicher ist eine Zeichenfolge (Base-64-codiert), die einen Zertifikatsspeicher im PFX-Format (PKCS12) darstellt. |
JKSFILE | Der Zertifikatsspeicher ist der Name einer Java Key Store (JKS)-Datei, die Zertifikate enthält. Beachten Sie, dass dieser Speichertyp nur in Java verfügbar ist. |
JKSBLOB | Der Zertifikatsspeicher ist eine Zeichenfolge (base-64-codiert), die einen Zertifikatsspeicher im JKS-Format darstellt. Beachten Sie, dass dieser Speichertyp nur in Java verfügbar ist. |
PEMKEY_FILE | Der Zertifikatsspeicher ist der Name einer PEM-codierten Datei, die einen privaten Schlüssel und ein optionales Zertifikat enthält. |
PEMKEY_BLOB | Der Zertifikatsspeicher ist eine Zeichenfolge (base64-codiert), die einen privaten Schlüssel und ein optionales Zertifikat enthält. |
PUBLIC_KEY_FILE | Der Zertifikatsspeicher ist der Name einer Datei, die ein PEM- oder DER-codiertes öffentliches Schlüsselzertifikat enthält. |
PUBLIC_KEY_BLOB | Der Zertifikatsspeicher ist eine Zeichenfolge (Base-64-codiert), die ein PEM- oder DER-codiertes öffentliches Schlüsselzertifikat enthält. |
SSHPUBLIC_KEY_FILE | Der Zertifikatsspeicher ist der Name einer Datei, die einen öffentlichen Schlüssel im SSH-Stil enthält. |
SSHPUBLIC_KEY_BLOB | Der Zertifikatsspeicher ist eine Zeichenfolge (Base-64-codiert), die einen öffentlichen Schlüssel im SSH-Stil enthält. |
P7BFILE | Der Zertifikatsspeicher ist der Name einer PKCS7-Datei, die Zertifikate enthält. |
PPKFILE | Der Zertifikatsspeicher ist der Name einer Datei, die einen privaten PuTTY-Schlüssel (PPK) enthält. |
XMLFILE | Der Zertifikatsspeicher ist der Name einer Datei, die ein Zertifikat im XML-Format enthält. |
XMLBLOB | Der Zertifikatsspeicher ist eine Zeichenfolge, die ein Zertifikat im XML-Format enthält. |
SSLClientCertPassword
Das Passwort für das TLS/SSL-Client-Zertifikat.
Datentyp
string
Standardwert
""
Hinweise
Wenn der Zertifikatspeicher von einem Typ ist, der ein Passwort erfordert, wird diese Eigenschaft verwendet, um dieses Passwort zum Öffnen des Zertifikatspeichers anzugeben.
SSLClientCertSubject
Der Betreff des TLS/SSL-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. Beispiel: „CN=www.server.com, OU=test, C=US, E=support@company.com“. Die allgemeinen 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.
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 (Hexadezimalwerte 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.
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%\CockroachDB 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%\ CockroachDB 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 | Ermöglicht die Vorbereitung einer Abfrage vor ihrer Ausführung. |
FetchResultSetMetadata | Dieses Feld legt fest, ob der Anbieter Metadaten zum Schema und Tabellennamen für vom Server zurückgegebene Ergebnismengenspalten abruft. |
IncludeTableTypes | Wenn auf „true“ gesetzt, Abfrage der Anbieter die Typen der einzelnen Tabellen und Ansichten ab. |
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 CockroachDB -Server. |
Timeout | Der Wert in Sekunden, bis der Timeout-Fehler auftritt und der Operation abgebrochen wird. |
TimeZone | Die Zeitzone für die aktuelle Sitzung. |
AllowPreparedStatement
Ermöglicht die Vorbereitung einer Abfrage vor ihrer Ausführung.
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.
FetchResultSetMetadata
In diesem Feld wird festgelegt, ob der Anbieter Metadaten zum Schema und Tabellennamen für die vom Server zurückgegebenen Ergebnismengenspalten abruft.
Datentyp
bool
Standardwert
false
Hinweise
Standardmäßig fordert der Connector vom Server keine detaillierten Informationen zu Ergebnismengenspalten wie Tabellennamen oder Schema an. Dies erfordert die Ausgabe zusätzlicher Metadatenabfragen über den Connector und kann in einigen Szenarien die Abfrage erheblich beeinträchtigen. Erwägen Sie, diese Eigenschaft auf True zu setzen, wenn Sie solche detaillierten beschreibenden Informationen für die Ergebnismengenspalten benötigen.
Tabellentypen einschließen
Wenn der Wert auf „true“ gesetzt ist, Abfrage der Anbieter die Typen der einzelnen Tabellen und Ansichten ab.
Datentyp
bool
Standardwert
false
Hinweise
Wenn der Wert auf „true“ gesetzt ist, Abfrage.
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 CockroachDB -Server.
Datentyp
bool
Standardwert
false
Hinweise
Wenn dies festgelegt ist, werden Abfragen direkt an CockroachDB weitergeleitet.
Zeitüberschreitung
Der Wert in Sekunden, bis der Timeout-Fehler auftritt und der Operation abgebrochen wird.
Datentyp
int
Standardwert
30
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.
Zeitzone
Die Zeitzone für die aktuelle Sitzung.
Datentyp
string
Standardwert
""
Hinweise
Wenn die TimeZone-Eigenschaft nicht festgelegt ist, verwendet der Connector die Zeitzone des Clientsystems. Das Festlegen dieser Eigenschaft kann nützlich sein, wenn der Server die Werte „Zeit mit Zeitzone“ und „Zeitstempel mit Zeitzone“ in eine andere Zeitzone als die Systemzeitzone des Clients konvertieren muss.