EnterpriseDB -Verbindungsdetails
Einführung
Connector-Version
Diese Dokumentation basiert auf Version 23.0.9039 des Connectors.
Erste Schritte
Unterstützung für EnterpriseDB -Version
Der Connector ermöglicht standardbasierten Zugriff auf EnterpriseDB Postgres Advanced Server Version 11 und höher.
Herstellen einer Verbindung
Herstellen einer Verbindung zu EnterpriseDB
Die folgenden Verbindungseigenschaften sind erforderlich, um eine Verbindung zu Daten herzustellen.
User: Der Benutzer, der zur Authentifizierung beim EnterpriseDB -Server verwendet wird.Password: Das Passwort, das zur Authentifizierung beim EnterpriseDB -Server verwendet wird.Server: Der Host oder die IP des Servers, auf dem die EnterpriseDB -Datenbank gehostet wird.Port: Der Port des Servers, auf dem die EnterpriseDB -Datenbank gehostet wird.
Optional können Sie außerdem Folgendes festlegen:
Database: Die Standarddatenbank, mit der eine Verbindung zum EnterpriseDB -Server hergestellt wird. Wenn diese Option nicht festgelegt ist, wird die Standarddatenbank des Benutzers verwendet.
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 EnterpriseDB -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 EnterpriseDB -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.
| EnterpriseDB | 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. |
Database | Der Name der EnterpriseDB -Datenbank. |
User | Das zur Authentifizierung verwendete EnterpriseDB Benutzerkonto. |
Password | Das zur Authentifizierung des Benutzers verwendete Kennwort. |
Port | Die Port des EnterpriseDB Servers. |
UseSSL | Ob SSL aktiviert ist. |
Visibility | Sichtbarkeitsbeschränkungen werden verwendet, um freigegebene Metadaten für Tabellen zu filtern, denen für den aktuellen Benutzer Berechtigungen zugewiesen wurden. |
| 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. |
IgnoredSchemas | Sichtbarkeitsbeschränkungsfilter, der verwendet wird, um die Liste der Schemata durch Metadatenabfragen auszublenden. Beispiel: „information_schema, pg_catalog“. Bei Schemanamen muss die Groß-/Kleinschreibung beachtet werden. |
| Eigenschaft | Beschreibung |
|---|---|
AllowPreparedStatement | Bereiten Sie eine Abfrage vor ihrer Ausführung vor. |
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 EnterpriseDB -Server. |
Timeout | Der Wert in Sekunden, bis der Timeout-Fehler auftritt und der Operation abgebrochen wird. |
TimeZone | Benachrichtigt den Server beim Öffnen der Verbindung mit der Abfrage SET TIMEZONE über die Zeitzone auf dem Client. |
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. |
Database | Der Name der EnterpriseDB -Datenbank. |
User | Das zur Authentifizierung verwendete EnterpriseDB Benutzerkonto. |
Password | Das zur Authentifizierung des Benutzers verwendete Kennwort. |
Port | Die Port des EnterpriseDB Servers. |
UseSSL | Ob SSL aktiviert ist. |
Visibility | Sichtbarkeitsbeschränkungen werden verwendet, um freigegebene Metadaten für Tabellen zu filtern, denen für den aktuellen Benutzer Berechtigungen zugewiesen wurden. |
Server
Der Host oder die IP-Adresse des Servers.
Datentyp
string
Standardwert
localhost
Hinweise
Der Host oder die IP des EDB Postgres Advanced Server, der die Datenbank hostet. Wenn nicht festgelegt, wird der Standardwert „localhost“ verwendet.
Datenbank
Der Name der EnterpriseDB Datenbank.
Datentyp
string
Standardwert
""
Hinweise
Die Datenbank, mit der bei der Verbindung zum EnterpriseDB Server eine Verbindung hergestellt werden soll. Wenn keine Datenbank angegeben ist, wird die Standarddatenbank des Benutzers verwendet.
Benutzer
Das zur Authentifizierung verwendete EnterpriseDB -Benutzerkonto.
Datentyp
string
Standardwert
""
Hinweise
Zusammen mit Passwort, wird dieses Feld zur Authentifizierung gegenüber dem EnterpriseDB -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.
Port
Die Port des EnterpriseDB Servers.
Datentyp
string
Standardwert
5444
Hinweise
Die Port des Servers Hosting der EnterpriseDB Datenbank. Wenn nicht angegeben, wird die Standard Port 5444 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.
Sichtbarkeit
Sichtbarkeitsbeschränkungen werden verwendet, um freigegebene Metadaten für Tabellen zu filtern, denen für den aktuellen Benutzer Berechtigungen erteilt wurden.
Datentyp
string
Standardwert
""
Hinweise
Beispielsweise beschränkt der Filter „SELECT,INSERT“ die Sichtbarkeit von Metadaten nur für die Tabellen, auf die der aktuelle Benutzer für SELECT- und INSERT-Operationen zugreifen kann. Unterstützte Berechtigungswerte sind SELECT, INSERT, UPDATE, DELETE, REFERENCES.
Standardmäßig wird die Sichtbarkeitsfilterung nicht angewendet. Bei Filterwerten wird nicht zwischen Groß- und Kleinschreibung unterschieden.
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 (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.
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. |
IgnoredSchemas | Sichtbarkeitsbeschränkungsfilter, der verwendet wird, um die Liste der Schemata durch Metadatenabfragen auszublenden. Beispiel: „information_schema, pg_catalog“. Bei Schemanamen muss die Groß-/Kleinschreibung beachtet werden. |
Standort
Ein Pfad zum Verzeichnis, das die Schema enthält, die Tabellen, Ansichten und gespeicherte Prozeduren definieren.
Datentyp
string
Standardwert
%APPDATA%\EnterpriseDB 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%\ EnterpriseDB 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.
Ignorierte Schemata
Sichtbarkeitsbeschränkungsfilter, der verwendet wird, um die Liste der Schemata durch Metadatenabfragen auszublenden. Beispiel: „information_schema, pg_catalog“. Schemanamen unterscheiden zwischen Groß- und Kleinschreibung.
Datentyp
string
Standardwert
""
Hinweise
Standardmäßig werden keine Einschränkungen angewendet.
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. |
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 EnterpriseDB -Server. |
Timeout | Der Wert in Sekunden, bis der Timeout-Fehler auftritt und der Operation abgebrochen wird. |
TimeZone | Benachrichtigt den Server beim Öffnen der Verbindung mit der Abfrage SET TIMEZONE über die Zeitzone auf dem Client. |
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.
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, fragt der Connector den EnterpriseDB -Server nach den Typen der einzelnen Tabellen und Ansichten 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 EnterpriseDB -Server.
Datentyp
bool
Standardwert
false
Hinweise
Wenn dies festgelegt ist, werden Abfragen direkt an EnterpriseDB 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
Benachrichtigt den Server beim Öffnen der Verbindung mit der Standardabfrage SET Abfrage über die Zeitzone auf dem Client.
Datentyp
string
Standardwert
""
Hinweise
Der Server speichert die Zeit mit Zeitzone und den Zeitstempel mit Zeitzone in UTC. Wenn der Server einen Wert ohne explizit angegebene Zeitzone akzeptiert, verwendet er TimeZone für die entsprechende Anpassung an UTC.
Wenn TimeZone Eigenschaft ist nicht festgelegt, der Anbieter verwendet die lokale Zeitzone des Clients. Das Festlegen dieser Eigenschaft kann nützlich sein, wenn der Server in eine bestimmte Zeitzone konvertieren muss, die sich von der lokalen Zeit des Clients unterscheidet.