Presto Verbindungsdetails

Einführung

Connector-Version

Diese Dokumentation basiert auf Version 23.0.8936 des Connectors.

Erste Schritte

Unterstützung der Presto-Version

Teradata/Presto v0.194 und früher, Prestosql/Presto v345 und früher, Prestodb/Presto v0.242 und früher werden unterstützt.

Herstellen einer Verbindung

Verbinden Sie sich mit Presto

Setzen Sie die Server Und Port Verbindungseigenschaften zum Herstellen einer Verbindung, zusätzlich zu allen möglicherweise erforderlichen Authentifizierungseigenschaften.

Sichere Presto Verbindungen

Um TLS/SSL im Connector zu aktivieren, setzen Sie UseSSL auf wahr.

Authentifizieren bei Presto

Presto kann entweder über LDAP oder Kerberos authentifiziert werden. Wenn der Presto-Server keine Authentifizierung eingerichtet hat, lassen Sie AuthScheme auf NONE (Standard) gesetzt. Um sich mit LDAP oder Kerberos zu authentifizieren, führen Sie die folgenden Schritte aus:

LDAP

Um sich mit LDAP zu authentifizieren, legen Sie die folgenden Verbindungseigenschaften fest:

AuthScheme: Stellen Sie dies auf LDAP ein.
User: Der Benutzername, mit dem in LDAP authentifiziert wird.
Password: Das mit dem verknüpfte Passwort User mit dem Sie die Authentifizierung gegenüber LDAP durchführen.

Kerberos

Siehe Verwenden von Kerberos für Einzelheiten zur Authentifizierung mit Kerberos.

Kerberos verwenden

Kerberos

Um sich mit Kerberos bei Presto zu authentifizieren, setzen Sie AuthScheme Zu KERBEROS.

Für die Authentifizierung bei Presto über Kerberos müssen Sie Authentifizierungseigenschaften definieren und auswählen, wie Kerberos Authentifizierungstickets abrufen soll.

Abrufen von Kerberos-Tickets

Kerberos-Tickets werden verwendet, um die Identität des Anforderers zu authentifizieren. Durch die Verwendung von Tickets anstelle von formellen Logins/Passwörtern entfällt die Notwendigkeit, Passwörter lokal zu speichern oder über ein Netzwerk zu senden. Benutzer werden erneut authentifiziert (Tickets werden aktualisiert), wenn sie sich an ihrem lokalen Computer anmelden oder kinit USER in der Eingabeaufforderung.

Der Connector bietet drei Möglichkeiten, das erforderliche Kerberos-Ticket abzurufen, je nachdem, ob das KRB5CCNAME und/oder KerberosKeytabFile Variablen sind in Ihrer Umfeld vorhanden.

MIT Kerberos-Anmeldeinformations-Cache-Datei

Mit dieser Option können Sie den MIT Kerberos Ticket Manager verwenden oder kinit Befehl zum Abrufen von Tickets. Mit dieser Option ist es nicht erforderlich, den User oder Password Verbindungseigenschaften.

Diese Option erfordert, dass KRB5CCNAME wurde in Ihrem System erstellt.

So aktivieren Sie den Ticketabruf über MIT Cerberos Credential Cache Files:

Stellen Sie sicher, dass KRB5CCNAME Variable ist in Ihrer Umfeld vorhanden.
Satz KRB5CCNAME zu einem Pfad, der auf Ihre Anmeldeinformations-Cachedatei verweist. (Beispiel: C:\krb_cache\krb5cc_0 oder /tmp/krb5cc_0.) Die Anmeldeinformations-Cachedatei wird erstellt, wenn Sie den MIT Kerberos Ticket Manager zum Generieren Ihres Tickets verwenden.
So erhalten Sie ein Ticket:
1. Öffnen Sie die Anwendung MIT Kerberos Ticket Manager.
2. Klicken Sie auf Get Ticket.
3. Geben Sie Ihren Hauptnamen und Ihr Passwort ein.
4. Klicken Sie auf OK.
Wenn das Ticket erfolgreich abgerufen wurde, werden die Ticketinformationen im Kerberos Ticket Manager angezeigt und in der Anmeldeinformations-Cache-Datei gespeichert.

Der Connector verwendet die Cache-Datei, um das Kerberos-Ticket für die Verbindung mit Presto abzurufen.

Hinweis

Wenn Sie nichts bearbeiten möchten KRB5CCNAME, Sie können verwenden KerberosTicketCache-Eigenschaft, um den Dateipfad manuell festzulegen. Nachdem dies festgelegt wurde, verwendet der Connector die angegebene Cache-Datei, um das Kerberos-Ticket für die Verbindung mit Presto abzurufen.

Keytab-Datei

Wenn in Ihrer Umfeld die KRB5CCNAME Umfeld, Sie können ein Kerberos-Ticket mithilfe einer Keytab-Datei abrufen.

Um diese Methode zu verwenden, setzen Sie die User Eigenschaft auf den gewünschten Benutzernamen und legen Sie die KerberosKeytabFile-Eigenschaft auf einen Dateipfad, der auf die mit dem Benutzer verknüpfte Keytab-Datei verweist.

Benutzer und Passwort

Wenn in Ihrer Umfeld die KRB5CCNAME Umfeld und die KerberosKeytabFile-Eigenschaft nicht festgelegt wurde, können Sie ein Ticket mithilfe einer Benutzer- und Passwortkombination abrufen.

Um diese Methode zu verwenden, legen Sie die-Eigenschaft fest User Und Password Eigenschaften für die Benutzer-/Passwortkombination, die Sie zur Authentifizierung bei Presto verwenden.

Cross-Realm-Authentifizierung aktivieren

Komplexere Kerberos-Umgebungen können eine Cross-Realm-Authentifizierung erfordern, wenn mehrere Realms und KDC-Server verwendet werden. Beispielsweise können sie einen Realm/KDC für die Benutzerauthentifizierung und einen anderen Realm/KDC zum Abrufen des Servicetickets verwenden.

Um diese Art der Cross-Realm-Authentifizierung zu aktivieren, setzen Sie das KerberosRealm Und KerberosKDC Eigenschaften auf die Werte, die für die Benutzerauthentifizierung erforderlich sind. Setzen Sie außerdem die KerberosServiceRealm Und KerberosServiceKDC Eigenschaften auf die Werte, die zum Erhalt des Servicetickets erforderlich sind.

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 Presto Connectors detailliert beschrieben.

Benutzerdefinierte Ansichten

Der Connector ermöglicht Ihnen die Definition virtueller Tabellen, sogenannter benutzerdefinierter Ansichten, deren Inhalt durch eine vorkonfigurierte Abfrage bestimmt wird. Diese Ansichten sind nützlich, wenn Sie die an die Treiber gesendeten Abfragen nicht direkt steuern können. Siehe Benutzerdefinierte Ansichten für einen Überblick über das Erstellen und Konfigurieren benutzerdefinierter Ansichten.

SSL-Konfiguration

Verwenden Sie SSL-Konfiguration, 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 mithilfe der Privater Agent Proxy-Einstellungen, wählen Sie die Use Proxy Settings Kontrollkästchen auf dem Verbindungskonfigurationsbildschirm.

Abfrageverarbeitung

Der Connector verlagert möglichst viel der Verarbeitung der SELECT-Anweisung auf Presto und verarbeitet dann den Rest der Abfrage im Speicher (clientseitig).

Siehe Abfrageverarbeitung für weitere Informationen.

Benutzerdefinierte Ansichten

Mit dem Presto-Connector können Sie eine virtuelle Tabelle definieren, deren Inhalt durch eine vorkonfigurierte Abfrage bestimmt wird. Diese werden als benutzerdefinierte Ansichten bezeichnet und sind in Situationen nützlich, in denen Sie die an den Treiber gesendete Abfrage nicht direkt steuern können, z. B. wenn Sie den Treiber von Jitterbit verwenden. Die benutzerdefinierten Ansichten können verwendet werden, um Prädikate zu definieren, die immer angewendet werden. Wenn Sie in der Abfrage an die Ansicht zusätzliche Prädikate angeben, werden diese mit der bereits als Teil der Ansicht definierten Abfrage kombiniert.

Es gibt zwei Möglichkeiten, benutzerdefinierte Ansichten zu erstellen:

Erstellen Sie eine Konfigurationsdatei im JSON-Format, die die gewünschten Ansichten definiert.
DDL-Anweisungen.

Definieren von Ansichten mithilfe einer Konfigurationsdatei

Benutzerdefinierte Ansichten werden in einer JSON-formatierten Konfigurationsdatei namens UserDefinedViews.json. Der Connector erkennt die in dieser Datei angegebenen Ansichten automatisch.

Sie können auch mehrere Ansichtsdefinitionen haben und diese mit steuern UserDefinedViews Verbindungseigenschaft. Wenn Sie diese Eigenschaft verwenden, werden vom Connector nur die angegebenen Ansichten angezeigt.

Diese Konfigurationsdatei für benutzerdefinierte Ansichten ist wie folgt formatiert:

Jedes Stammelement definiert den Namen einer Ansicht.
Jedes Stammelement enthält ein untergeordnetes Element namens query, das die benutzerdefinierte SQL- Abfrage für die Ansicht enthält.

Zum Beispiel:

{
    "MyView": {
        "query": "SELECT * FROM [Hive].[Default].Customers WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Verwenden Sie die UserDefinedViews Verbindungseigenschaft, um den Speicherort Ihrer JSON-Konfigurationsdatei anzugeben. Beispiel:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Definieren von Ansichten mit DDL-Anweisungen

Der Connector kann das Schema auch über DDL-Anweisungen wie CREATE LOCAL VIEW, ALTER LOCAL VIEW und DROP LOCAL VIEW erstellen und ändern.

Erstellen einer Ansicht

Um eine neue Ansicht mit DDL-Anweisungen zu erstellen, geben Sie den Ansichtsnamen und die Abfrage wie folgt an:

CREATE LOCAL VIEW`[MeinAnsichtsname] `AS SELECT * FROM Customers LIMIT 20;

Wenn keine JSON-Datei vorhanden ist, erstellt der obige Code eine. Die Ansicht wird dann in der JSON-Konfigurationsdatei erstellt und ist nun erkennbar. Der Speicherort der JSON-Datei wird durch angegeben UserDefinedViews Verbindungseigenschaft.

Ändern einer Ansicht

Um eine vorhandene Ansicht zu ändern, geben Sie den Namen der vorhandenen Ansicht zusammen mit der neuen Abfrage an, die Sie stattdessen verwenden möchten:

ALTER LOCAL VIEW`[MeinAnsichtsname] `AS SELECT * FROM Customers WHERE TimeModified > '3/1/2020';

Die Ansicht wird dann in der JSON-Konfigurationsdatei aktualisiert.

Löschen einer Ansicht

Um eine vorhandene Ansicht zu löschen, geben Sie den Namen eines vorhandenen Schema neben der neuen Abfrage an, die Sie stattdessen verwenden möchten.

DROP LOCAL VIEW [MyViewName]

Dadurch wird die Ansicht aus der JSON-Konfigurationsdatei entfernt. Sie kann nicht mehr abgefragt werden.

Schema für benutzerdefinierte Ansichten

Benutzerdefinierte Ansichten werden im angezeigt UserViews Schema standardmäßig. Dies geschieht, um zu vermeiden, dass der Name der Ansicht mit einer tatsächlichen Entität im Datenmodell kollidiert. Sie können den Namen des für UserViews verwendeten Schema ändern, indem Sie festlegen UserViewsSchemaName Eigentum.

Arbeiten mit benutzerdefinierten Ansichten

Beispielsweise eine SQL-Anweisung mit einer benutzerdefinierten Ansicht namens UserViews.RCustomers listet nur Kunden in Raleigh auf:

SELECT * FROM Customers WHERE City = 'Raleigh';

Ein Beispiel für eine Abfrage an den Treiber:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Daraus ergibt sich die effektive Abfrage an die Quelle:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Dies ist ein sehr einfaches Beispiel für eine Abfrage an eine benutzerdefinierte Ansicht, die tatsächlich eine Kombination aus der Abfrage und der Ansichtsdefinition ist. Es ist möglich, diese Abfragen in viel komplexeren Mustern zusammenzustellen. Alle SQL-Operationen sind in beiden Abfragen zulässig und werden bei Bedarf kombiniert.

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 Presto-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.

Datenmodell

Der Presto-Connector modelliert die Presto REST- APIs als relationale Tabellen und gespeicherte Prozeduren, auf die mit Standard-SQL zugegriffen werden kann. Dies ermöglicht den Zugriff von standardbasierten Tools.

Die Tabellendefinitionen werden dynamisch abgerufen. Wenn Sie eine Verbindung herstellen, stellt der Connector eine Verbindung zu Presto her und ruft die Liste der Tabellen und die Metadaten für die Tabellen ab, indem er den Presto REST-Server abfragt. Alle Änderungen an den Remotedaten werden sofort in Ihren Abfragen widergespiegelt.

Systemtabellen

Sie können die in diesem Abschnitt beschriebenen Systemtabellen Abfrage, um auf Schema, Informationen zur Datenquellenfunktionalität und Statistiken zu Operation Charge.

Schematabellen

Die folgenden Tabellen geben Datenbankmetadaten für Presto zurück:

sys_catalogs: Listet die verfügbaren Datenbanken auf.
sys_schemas: Listet die verfügbaren Schemata auf.
sys_tables: Listet die verfügbaren Tabellen und Ansichten auf.
sys_tablecolumns: Beschreibt die Spalten der verfügbaren Tabellen und Ansichten.
sys_procedures: Beschreibt die verfügbaren gespeicherten Prozeduren.
sys_procedureparameters: Beschreibt Parameter gespeicherter Prozeduren.
sys_keycolumns: Beschreibt die Primär- und Fremdschlüssel.
sys_indexes: Beschreibt die verfügbaren Indizes.

Datenquellentabellen

Die folgenden Tabellen enthalten Informationen dazu, wie eine Verbindung zur Datenquelle hergestellt und diese Abfrage wird:

sys_connection_props: Gibt Informationen zu den verfügbaren Verbindungseigenschaften zurück.
sys_sqlinfo: Beschreibt die SELECT-Abfragen, die der Connector an die Datenquelle auslagern kann.

Abfrageinformationstabellen

Die folgende Tabelle gibt Abfrage für Datenänderungsabfragen zurück, einschließlich Charge:

Systemidentität: Gibt Informationen zu Charge oder einzelnen Updates zurück.

Sys_catalogs

Listet die verfügbaren Datenbanken auf.

Die folgende Abfrage ruft alle durch die Verbindungszeichenfolge ermittelten Datenbanken ab:

SELECT * FROM sys_catalogs

Spalten

Name	Typ	Beschreibung
`CatalogName`	`String`	Der Datenbankname.

Sys_schemas

Listet die verfügbaren Schemas auf.

Die folgende Abfrage ruft alle verfügbaren Schemas ab:

SELECT * FROM sys_schemas

Spalten

Name	Typ	Beschreibung
`CatalogName`	`String`	Der Datenbankname.
`SchemaName`	`String`	Der Schema.

Sys_tables

Listet die verfügbaren Tabellen auf.

Die folgende Abfrage ruft die verfügbaren Tabellen und Ansichten ab:

SELECT * FROM sys_tables

Spalten

Name	Typ	Beschreibung
`CatalogName`	`String`	Die Datenbank, die die Tabelle oder Ansicht enthält.
`SchemaName`	`String`	Das Schema, das die Tabelle oder Ansicht enthält.
`TableName`	`String`	Der Name der Tabelle oder Ansicht.
`TableType`	`String`	Der Tabellentyp (Tabelle oder Ansicht).
`Description`	`String`	Eine Beschreibung der Tabelle oder Ansicht.
`IsUpdateable`	`Boolean`	Ob die Tabelle aktualisiert werden kann.

Sys_tablecolumns

Beschreibt die Spalten der verfügbaren Tabellen und Ansichten.

Die folgende Abfrage gibt die Spalten und Datentypen für die Tabelle [Hive].[Default].Customers zurück:

SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='Customers' AND CatalogName='Hive' AND SchemaName='Default'

Spalten

Name	Typ	Beschreibung
`CatalogName`	`String`	Der Name der Datenbank, die die Tabelle oder Ansicht enthält.
`SchemaName`	`String`	Das Schema, das die Tabelle oder Ansicht enthält.
`TableName`	`String`	Der Name der Tabelle oder Ansicht, die die Spalte enthält.
`ColumnName`	`String`	Der Spaltenname.
`DataTypeName`	`String`	Der Name des Datentyps.
`DataType`	`Int32`	Eine Ganzzahl, die den Datentyp angibt. Dieser Wert wird zur Laufzeit basierend auf der Umfeld bestimmt.
`Length`	`Int32`	Die Speichergröße der Spalte.
`DisplaySize`	`Int32`	Die normale Maximalbreite der angegebenen Spalte in Zeichen.
`NumericPrecision`	`Int32`	Die maximale Anzahl von Ziffern in numerischen Daten. Die Spaltenlänge in Zeichen für Zeichen- und Datums-/Uhrzeitdaten.
`NumericScale`	`Int32`	Die Spaltenskala oder Anzahl der Ziffern rechts vom Dezimalpunkt.
`IsNullable`	`Boolean`	Ob die Spalte Null enthalten kann.
`Description`	`String`	Eine kurze Beschreibung der Spalte.
`Ordinal`	`Int32`	Die Sequenznummer der Spalte.
`IsAutoIncrement`	`String`	Ob der Spaltenwert in festen Schritten zugewiesen wird.
`IsGeneratedColumn`	`String`	Ob die Spalte generiert wird.
`IsHidden`	`Boolean`	Ob die Spalte ausgeblendet ist.
`IsArray`	`Boolean`	Ob die Spalte ein Array ist.
`IsReadOnly`	`Boolean`	Ob die Spalte schreibgeschützt ist.
`IsKey`	`Boolean`	Gibt an, ob ein von sys_tablecolumns zurückgegebenes Feld der Primärschlüssel der Tabelle ist.

Sys_procedures

Listet die verfügbaren gespeicherten Prozeduren auf.

Die folgende Abfrage ruft die verfügbaren gespeicherten Prozeduren ab:

SELECT * FROM sys_procedures

Spalten

Name	Typ	Beschreibung
`CatalogName`	`String`	Die Datenbank, die die gespeicherte Prozedur enthält.
`SchemaName`	`String`	Das Schema, das die gespeicherte Prozedur enthält.
`ProcedureName`	`String`	Der Name der gespeicherten Prozedur.
`Description`	`String`	Eine Beschreibung der gespeicherten Prozedur.
`ProcedureType`	`String`	Der Typ der Prozedur, z. B. PROZEDUR oder FUNKTION.

Sys_procedureparameters

Beschreibt Parameter gespeicherter Prozeduren.

Die folgende Abfrage gibt Informationen zu allen Eingabeparametern für die gespeicherte Prozedur CreateTable zurück:

SELECT * FROM sys_procedureparameters WHERE ProcedureName='CreateTable' AND Direction=1 OR Direction=2

Spalten

Name	Typ	Beschreibung
`CatalogName`	`String`	Der Name der Datenbank, die die gespeicherte Prozedur enthält.
`SchemaName`	`String`	Der Name des Schema, das die gespeicherte Prozedur enthält.
`ProcedureName`	`String`	Der Name der gespeicherten Prozedur, die den Parameter enthält.
`ColumnName`	`String`	Der Name des gespeicherten Prozedurparameters.
`Direction`	`Int32`	Eine Ganzzahl, die dem Typ des Parameters entspricht: Eingabe (1), Eingabe/Ausgabe (2) oder Ausgabe (4). Parameter vom Typ Eingabe/Ausgabe können sowohl Eingabe- als auch Ausgabeparameter sein.
`DataTypeName`	`String`	Der Name des Datentyps.
`DataType`	`Int32`	Eine Ganzzahl, die den Datentyp angibt. Dieser Wert wird zur Laufzeit basierend auf der Umfeld bestimmt.
`Length`	`Int32`	Die Anzahl der für Zeichendaten zulässigen Zeichen. Die Anzahl der für numerische Daten zulässigen Ziffern.
`NumericPrecision`	`Int32`	Die maximale Genauigkeit für numerische Daten. Die Spaltenlänge in Zeichen für Zeichen- und Datums-/Uhrzeitdaten.
`NumericScale`	`Int32`	Die Anzahl der Ziffern rechts vom Dezimalkomma in numerischen Daten.
`IsNullable`	`Boolean`	Ob der Parameter Null enthalten kann.
`IsRequired`	`Boolean`	Ob der Parameter zur Ausführung der Prozedur erforderlich ist.
`IsArray`	`Boolean`	Ob der Parameter ein Array ist.
`Description`	`String`	Die Beschreibung des Parameters.
`Ordinal`	`Int32`	Der Index des Parameters.

Sys_keycolumns

Beschreibt die Primär- und Fremdschlüssel.

Die folgende Abfrage ruft den Primärschlüssel für die Tabelle [Hive].[Default].Customers ab:

SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='Customers' AND CatalogName='Hive' AND SchemaName='Default'

Spalten

Name	Typ	Beschreibung
`CatalogName`	`String`	Der Name der Datenbank, die den Schlüssel enthält.
`SchemaName`	`String`	Der Name des Schema, das den Schlüssel enthält.
`TableName`	`String`	Der Name der Tabelle, die den Schlüssel enthält.
`ColumnName`	`String`	Der Name der Schlüsselspalte.
`IsKey`	`Boolean`	Ob die Spalte ein Primärschlüssel in der Tabelle ist, auf die im Feld „TableName“ verwiesen wird.
`IsForeignKey`	`Boolean`	Ob die Spalte ein Fremdschlüssel ist, auf den im Feld TableName verwiesen wird.
`PrimaryKeyName`	`String`	Der Name des Primärschlüssels.
`ForeignKeyName`	`String`	Der Name des Fremdschlüssels.
`ReferencedCatalogName`	`String`	Die Datenbank, die den Primärschlüssel enthält.
`ReferencedSchemaName`	`String`	Das Schema, das den Primärschlüssel enthält.
`ReferencedTableName`	`String`	Die Tabelle, die den Primärschlüssel enthält.
`ReferencedColumnName`	`String`	Der Spaltenname des Primärschlüssels.

Sys_foreignkeys

Beschreibt die Fremdschlüssel.

Die folgende Abfrage ruft alle Fremdschlüssel ab, die auf andere Tabellen verweisen:

SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'

Spalten

Name	Typ	Beschreibung
`CatalogName`	`String`	Der Name der Datenbank, die den Schlüssel enthält.
`SchemaName`	`String`	Der Name des Schema, das den Schlüssel enthält.
`TableName`	`String`	Der Name der Tabelle, die den Schlüssel enthält.
`ColumnName`	`String`	Der Name der Schlüsselspalte.
`PrimaryKeyName`	`String`	Der Name des Primärschlüssels.
`ForeignKeyName`	`String`	Der Name des Fremdschlüssels.
`ReferencedCatalogName`	`String`	Die Datenbank, die den Primärschlüssel enthält.
`ReferencedSchemaName`	`String`	Das Schema, das den Primärschlüssel enthält.
`ReferencedTableName`	`String`	Die Tabelle, die den Primärschlüssel enthält.
`ReferencedColumnName`	`String`	Der Spaltenname des Primärschlüssels.
`ForeignKeyType`	`String`	Gibt an, ob der Fremdschlüssel ein Importschlüssel (zeigt auf andere Tabellen) oder ein Exportschlüssel (referenziert von anderen Tabellen) ist.

Sys_primarykeys

Beschreibt die Primärschlüssel.

Die folgende Abfrage ruft die Primärschlüssel aus allen Tabellen und Ansichten ab:

SELECT * FROM sys_primarykeys

Spalten

Name	Typ	Beschreibung
`CatalogName`	`String`	Der Name der Datenbank, die den Schlüssel enthält.
`SchemaName`	`String`	Der Name des Schema, das den Schlüssel enthält.
`TableName`	`String`	Der Name der Tabelle, die den Schlüssel enthält.
`ColumnName`	`String`	Der Name der Schlüsselspalte.
`KeySeq`	`String`	Die Sequenznummer des Primärschlüssels.
`KeyName`	`String`	Der Name des Primärschlüssels.

Sys_indexes

Beschreibt die verfügbaren Indizes. Durch das Filtern nach Indizes können Sie selektivere Abfragen mit schnelleren Abfrage schreiben.

Die folgende Abfrage ruft alle Indizes ab, die keine Primärschlüssel sind:

SELECT * FROM sys_indexes WHERE IsPrimary='false'

Spalten

Name	Typ	Beschreibung
`CatalogName`	`String`	Der Name der Datenbank, die den Index enthält.
`SchemaName`	`String`	Der Name des Schema, das den Index enthält.
`TableName`	`String`	Der Name der Tabelle, die den Index enthält.
`IndexName`	`String`	Der Indexname.
`ColumnName`	`String`	Der Name der mit dem Index verknüpften Spalte.
`IsUnique`	`Boolean`	Wahr, wenn der Index eindeutig ist. Andernfalls falsch.
`IsPrimary`	`Boolean`	Wahr, wenn der Index ein Primärschlüssel ist. Andernfalls falsch.
`Type`	`Int16`	Ein ganzzahliger Wert, der dem Indextyp entspricht: Statistik (0), gruppiert (1), gehasht (2) oder Sonstiges (3).
`SortOrder`	`String`	Die Sortierreihenfolge: A für aufsteigend oder D für absteigend.
`OrdinalPosition`	`Int16`	Die Sequenznummer der Spalte im Index.

Sys_connection_props

Gibt Informationen zu den verfügbaren Verbindungseigenschaften und den in der Verbindungszeichenfolge festgelegten Eigenschaften zurück.

Bei der Abfrage dieser Tabelle sollte die Konfigurationsverbindungszeichenfolge verwendet werden:

jdbc:cdata:presto:config:

Mit dieser Verbindungszeichenfolge können Sie diese Tabelle ohne eine gültige Verbindung Abfrage.

Die folgende Abfrage ruft alle Verbindungseigenschaften ab, die in der Verbindungszeichenfolge festgelegt oder über einen Standardwert gesetzt wurden:

SELECT * FROM sys_connection_props WHERE Value <> ''

Spalten

Name	Typ	Beschreibung
`Name`	`String`	Der Name der Verbindungseigenschaft.
`ShortDescription`	`String`	Eine kurze Beschreibung.
`Type`	`String`	Der Datentyp der Verbindungseigenschaft.
`Default`	`String`	Der Standardwert, sofern nicht explizit einer festgelegt wurde.
`Values`	`String`	Eine durch Kommas getrennte Liste möglicher Werte. Wenn ein anderer Wert angegeben wird, wird ein Validierungsfehler ausgegeben.
`Value`	`String`	Der von Ihnen festgelegte Wert oder ein vorkonfigurierter Standard.
`Required`	`Boolean`	Ob für die Immobilie eine Anschlusspflicht besteht.
`Category`	`String`	Die Kategorie der Verbindungseigenschaft.
`IsSessionProperty`	`String`	Ob die Eigenschaft eine Sitzungseigenschaft ist, die zum Speichern von Informationen zur aktuellen Verbindung verwendet wird.
`Sensitivity`	`String`	Die Vertraulichkeitsstufe der Eigenschaft. Diese gibt Aufschluss darüber, ob die Eigenschaft in Protokollierungs- und Authentifizierungsformularen verschleiert wird.
`PropertyName`	`String`	Eine verkürzte Form des Verbindungseigenschaftsnamens in Camel-Case-Schreibweise.
`Ordinal`	`Int32`	Der Index des Parameters.
`CatOrdinal`	`Int32`	Der Index der Parameterkategorie.
`Hierarchy`	`String`	Zeigt zugehörige abhängige Eigenschaften an, die zusammen mit dieser festgelegt werden müssen.
`Visible`	`Boolean`	Informiert, ob die Eigenschaft in der Verbindungs-Benutzeroberfläche sichtbar ist.
`ETC`	`String`	Verschiedene sonstige Informationen zum Objekt.

Sys_sqlinfo

Beschreibt die SELECT- Abfrage, die der Connector an die Datenquelle auslagern kann.

Entdecken der SELECT-Funktionen der Datenquelle

Nachfolgend sehen Sie einen Beispieldatensatz mit SQL-Funktionen. Einige Aspekte der SELECT-Funktionalität werden in einer durch Kommas getrennten Liste zurückgegeben, sofern sie unterstützt werden. Andernfalls enthält die Spalte NO.

Name	Beschreibung	Mögliche Werte
`AGGREGATE_FUNCTIONS`	Unterstützte Aggregatfunktionen.	`AVG`, `COUNT`, `MAX`, `MIN`, `SUM`, `DISTINCT`
`COUNT`	Ob die COUNT-Funktion unterstützt wird.	`YES`, `NO`
`IDENTIFIER_QUOTE_OPEN_CHAR`	Das öffnende Zeichen, das zum Escapen eines Bezeichners verwendet wird.	`[`
`IDENTIFIER_QUOTE_CLOSE_CHAR`	Das abschließende Zeichen, das zum Escapen eines Bezeichners verwendet wird.	`]`
`SUPPORTED_OPERATORS`	Eine Liste unterstützter SQL-Operatoren.	`=`, `>`, `<`, `>=`, `<=`, `<>`, `!=`, `LIKE`, `NOT LIKE`, `IN`, `NOT IN`, `IS NULL`, `IS NOT NULL`, `AND`, `OR`
`GROUP_BY`	Ob GROUP BY unterstützt wird und wenn ja, in welchem Umfang.	`NO`, `NO_RELATION`, `EQUALS_SELECT`, `SQL_GB_COLLATE`
`STRING_FUNCTIONS`	Unterstützte String-Funktionen.	`LENGTH`, `CHAR`, `LOCATE`, `REPLACE`, `SUBSTRING`, `RTRIM`, `LTRIM`, `RIGHT`, `LEFT`, `UCASE`, `SPACE`, `SOUNDEX`, `LCASE`, `CONCAT`, `ASCII`, `REPEAT`, `OCTET`, `BIT`, `POSITION`, `INSERT`, `TRIM`, `UPPER`, `REGEXP`, `LOWER`, `DIFFERENCE`, `CHARACTER`, `SUBSTR`, `STR`, `REVERSE`, `PLAN`, `UUIDTOSTR`, `TRANSLATE`, `TRAILING`, `TO`, `STUFF`, `STRTOUUID`, `STRING`, `SPLIT`, `SORTKEY`, `SIMILAR`, `REPLICATE`, `PATINDEX`, `LPAD`, `LEN`, `LEADING`, `KEY`, `INSTR`, `INSERTSTR`, `HTML`, `GRAPHICAL`, `CONVERT`, `COLLATION`, `CHARINDEX`, `BYTE`
`NUMERIC_FUNCTIONS`	Unterstützte numerische Funktionen.	`ABS`, `ACOS`, `ASIN`, `ATAN`, `ATAN2`, `CEILING`, `COS`, `COT`, `EXP`, `FLOOR`, `LOG`, `MOD`, `SIGN`, `SIN`, `SQRT`, `TAN`, `PI`, `RAND`, `DEGREES`, `LOG10`, `POWER`, `RADIANS`, `ROUND`, `TRUNCATE`
`TIMEDATE_FUNCTIONS`	Unterstützte Datums-/Uhrzeitfunktionen.	`NOW`, `CURDATE`, `DAYOFMONTH`, `DAYOFWEEK`, `DAYOFYEAR`, `MONTH`, `QUARTER`, `WEEK`, `YEAR`, `CURTIME`, `HOUR`, `MINUTE`, `SECOND`, `TIMESTAMPADD`, `TIMESTAMPDIFF`, `DAYNAME`, `MONTHNAME`, `CURRENT_DATE`, `CURRENT_TIME`, `CURRENT_TIMESTAMP`, `EXTRACT`
`REPLICATION_SKIP_TABLES`	Zeigt an, dass während der Replikation Tabellen übersprungen wurden.
`REPLICATION_TIMECHECK_COLUMNS`	Ein Zeichenfolgenarray mit einer Liste von Spalten, die (in der angegebenen Reihenfolge) zur Überprüfung verwendet werden, ob sie während der Replikation als geänderte Spalte verwendet werden sollen.
`IDENTIFIER_PATTERN`	Zeichenfolgenwert, der angibt, welche Zeichenfolge für einen Bezeichner gültig ist.
`SUPPORT_TRANSACTION`	Gibt an, ob der Anbieter Transaktionen wie Commit und Rollback unterstützt.	`YES`, `NO`
`DIALECT`	Gibt den zu verwendenden SQL-Dialekt an.
`KEY_PROPERTIES`	Gibt die Eigenschaften an, die die einheitliche Datenbank identifizieren.
`SUPPORTS_MULTIPLE_SCHEMAS`	Gibt an, ob für den Anbieter mehrere Schemas vorhanden sein können.	`YES`, `NO`
`SUPPORTS_MULTIPLE_CATALOGS`	Gibt an, ob für den Anbieter mehrere Kataloge vorhanden sein können.	`YES`, `NO`
`DATASYNCVERSION`	Die für den Zugriff auf diesen Treiber erforderliche Data Sync-Version.	`Standard`, `Starter`, `Professional`, `Enterprise`
`DATASYNCCATEGORY`	Die Kategorie „Datensynchronisierung“ dieses Treiber.	`Source`, `Destination`, `Cloud Destination`
`SUPPORTSENHANCEDSQL`	Ob erweiterte SQL-Funktionen über das hinaus, was die API bietet, unterstützt werden.	`TRUE`, `FALSE`
`SUPPORTS_BATCH_OPERATIONS`	Ob Charge Operationen unterstützt werden.	`YES`, `NO`
`SQL_CAP`	Alle unterstützten SQL-Funktionen für diesen Treiber.	`SELECT`, `INSERT`, `DELETE`, `UPDATE`, `TRANSACTIONS`, `ORDERBY`, `OAUTH`, `ASSIGNEDID`, `LIMIT`, `LIKE`, `BULKINSERT`, `COUNT`, `BULKDELETE`, `BULKUPDATE`, `GROUPBY`, `HAVING`, `AGGS`, `OFFSET`, `REPLICATE`, `COUNTDISTINCT`, `JOINS`, `DROP`, `CREATE`, `DISTINCT`, `INNERJOINS`, `SUBQUERIES`, `ALTER`, `MULTIPLESCHEMAS`, `GROUPBYNORELATION`, `OUTERJOINS`, `UNIONALL`, `UNION`, `UPSERT`, `GETDELETED`, `CROSSJOINS`, `GROUPBYCOLLATE`, `MULTIPLECATS`, `FULLOUTERJOIN`, `MERGE`, `JSONEXTRACT`, `BULKUPSERT`, `SUM`, `SUBQUERIESFULL`, `MIN`, `MAX`, `JOINSFULL`, `XMLEXTRACT`, `AVG`, `MULTISTATEMENTS`, `FOREIGNKEYS`, `CASE`, `LEFTJOINS`, `COMMAJOINS`, `WITH`, `LITERALS`, `RENAME`, `NESTEDTABLES`, `EXECUTE`, `BATCH`, `BASIC`, `INDEX`
`PREFERRED_CACHE_OPTIONS`	Ein Zeichenfolgenwert gibt die bevorzugten Cacheoptionen an.
`ENABLE_EF_ADVANCED_QUERY`	Gibt an, ob der Treiber erweiterte Abfragen aus dem Entity Framework direkt unterstützt. Wenn nicht, werden die Abfragen clientseitig verarbeitet.	`YES`, `NO`
`PSEUDO_COLUMNS`	Ein Zeichenfolgenarray, das die verfügbaren Pseudospalten angibt.
`MERGE_ALWAYS`	Wenn der Wert „true“ ist, wird der Merge-Modus in der Datensynchronisierung zwangsweise ausgeführt.	`TRUE`, `FALSE`
`REPLICATION_MIN_DATE_QUERY`	Eine Abfrage zum Zurückgeben des Startdatums und der Startzeit der Replikation.
`REPLICATION_MIN_FUNCTION`	Ermöglicht einem Anbieter, den Formelnamen anzugeben, der zum Ausführen eines serverseitigen Minimums verwendet werden soll.
`REPLICATION_START_DATE`	Ermöglicht einem Anbieter, ein Replikationsstartdatum anzugeben.
`REPLICATION_MAX_DATE_QUERY`	Eine Abfrage zum Zurückgeben des Enddatums und der Endzeit der Replikation.
`REPLICATION_MAX_FUNCTION`	Ermöglicht einem Anbieter, den Formelnamen anzugeben, der zur Ausführung eines serverseitigen Max. verwendet werden soll.
`IGNORE_INTERVALS_ON_INITIAL_REPLICATE`	Eine Liste von Tabellen, bei denen das Aufteilen der Replikation in Blöcke bei der ersten Replikation übersprungen wird.
`CHECKCACHE_USE_PARENTID`	Gibt an, ob die CheckCache-Anweisung für die übergeordnete Schlüsselspalte ausgeführt werden soll.	`TRUE`, `FALSE`
`CREATE_SCHEMA_PROCEDURES`	Gibt gespeicherte Prozeduren an, die zum Generieren von Schema verwendet werden können.

Die folgende Abfrage ruft die Operatoren ab, die in der WHERE-Klausel verwendet werden können:

SELECT * FROM sys_sqlinfo WHERE Name = 'SUPPORTED_OPERATORS'

Beachten Sie, dass einzelne Tabellen unterschiedliche Einschränkungen oder Anforderungen an die WHERE-Klausel haben können; siehe Datenmodell Abschnitt für weitere Informationen.

Spalten

Name	Typ	Beschreibung
`NAME`	`String`	Eine Komponente der SQL-Syntax oder eine Funktion, die auf dem Server verarbeitet werden kann.
`VALUE`	`String`	Details zum unterstützten SQL bzw. zur SQL-Syntax.

Systemidentität

Gibt Informationen zu versuchten Änderungen zurück.

Die folgende Abfrage ruft die IDs der geänderten Zeilen in einer Operation Charge:

SELECT * FROM sys_identity

Spalten

Name	Typ	Beschreibung
`Id`	`String`	Die von einer Operation zurückgegebene, von der Datenbank generierte ID.
`Batch`	`String`	Eine Kennung für den Charge. 1 für einen einzelnen Operation.
`Operation`	`String`	Das Ergebnis der Operation im Charge: EINGEFÜGT, AKTUALISIERT oder GELÖSCHT.
`Message`	`String`	SUCCESS oder eine Fehlermeldung, wenn das Update im Charge fehlgeschlagen ist.

Systeminformationen

Beschreibt die verfügbaren Systeminformationen.

Die folgende Abfrage ruft alle Spalten ab:

SELECT * FROM sys_information

Spalten

Name	Typ	Beschreibung
`Product`	`String`	Der Name des Produkts.
`Version`	`String`	Die Versionsnummer des Produkts.
`Datasource`	`String`	Der Name der Datenquelle, mit der das Produkt eine Verbindung herstellt.
`NodeId`	`String`	Die eindeutige Kennung der Maschine, auf der das Produkt installiert ist.
`HelpURL`	`String`	Die URL zur Hilfedokumentation des Produkts.
`License`	`String`	Die Lizenzinformationen für das Produkt. (Wenn diese Informationen nicht verfügbar sind, kann das Feld leer gelassen oder als „N/A“ markiert werden.)
`Location`	`String`	Der Dateipfad, in dem die Produktbibliothek gespeichert ist.
`Environment`	`String`	Die Version der Umfeld oder Rumtine, unter der das Produkt derzeit ausgeführt wird.
`DataSyncVersion`	`String`	Die zur Verwendung dieses Connectors erforderliche Synchronisierungsebene.
`DataSyncCategory`	`String`	Die Kategorie der Synchronisierungsfunktionalität (z. B. Quelle, Ziel).

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`	Das zur Authentifizierung verwendete Schema. Akzeptierte Einträge sind Keine, Kerberos und LDAP. Keine ist die Standardeinstellung.
`Server`	Der Host oder die IP-Adresse des Presto REST-Servers.
`Port`	Der Port für den Presto REST-Server.
`User`	Das zur Authentifizierung verwendete Presto-Benutzerkonto.
`Password`	Das zur Authentifizierung des Benutzers verwendete Kennwort.
`PrestoKind`	Gibt an, ob die verbundene Instanz Trino ist oder nicht.
`UseSSL`	Gibt an, ob SSL aktiviert ist.

Kerberos

Eigenschaft	Beschreibung
`KerberosKDC`	Der Kerberos Key Distribution Center (KDC)-Dienst, der zur Authentifizierung des Benutzers verwendet wird.
`KerberosRealm`	Der Kerberos-Bereich, der zur Authentifizierung des Benutzers verwendet wird.
`KerberosSPN`	Der Service Principal Name (SPN) für den Kerberos-Domänencontroller.
`KerberosKeytabFile`	Die Keytab-Datei, die Ihre Paare aus Kerberos-Prinzipalen und verschlüsselten Schlüsseln enthält.
`KerberosServiceRealm`	Der Kerberos-Bereich des Dienstes.
`KerberosServiceKDC`	Das Kerberos-KDC des Dienstes.
`KerberosTicketCache`	Der vollständige Dateipfad zu einer Cachedatei für MIT Kerberos-Anmeldeinformationen.

SSL

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.

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.
`Catalog`	Der Name des zu verwendenden Katalogs.
`Schema`	Das Schema der Presto-Datenbank.

Verschiedenes

Eigenschaft	Beschreibung
`SessionProperties`	Sitzungseigenschaften, die für das System und für Kataloge festgelegt werden sollen, angegeben als Liste von Key-Value Paaren und durch Kommas getrennt. Beispielsweise setzt abc=xyz, example.foo=bar die Systemeigenschaft abc auf den Wert xyz und die Eigenschaft foo für den Katalog example auf den Wert bar.
`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.
`PseudoColumns`	Diese Eigenschaft gibt an, ob Pseudospalten als Spalten in die Tabelle aufgenommen werden sollen oder nicht.
`QueryPassthrough`	Diese Option übergibt die Abfrage unverändert an den Presto-Server.
`SortColumns`	Gibt an, ob Spalten alphabetisch sortiert werden sollen.
`Timeout`	Der Wert in Sekunden, bis der Timeout-Fehler auftritt und der Operation abgebrochen wird.
`UserDefinedViews`	Ein Dateipfad, der auf die JSON-Konfigurationsdatei verweist, die Ihre benutzerdefinierten Ansichten enthält.

Authentifizierung

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

Eigenschaft	Beschreibung
`AuthScheme`	Das zur Authentifizierung verwendete Schema. Akzeptierte Einträge sind Keine, Kerberos und LDAP. Keine ist die Standardeinstellung.
`Server`	Der Host oder die IP-Adresse des Presto REST-Servers.
`Port`	Der Port für den Presto REST-Server.
`User`	Das zur Authentifizierung verwendete Presto-Benutzerkonto.
`Password`	Das zur Authentifizierung des Benutzers verwendete Kennwort.
`PrestoKind`	Gibt an, ob die verbundene Instanz Trino ist oder nicht.
`UseSSL`	Gibt an, ob SSL aktiviert ist.

AuthScheme

Das zur Authentifizierung verwendete Schema. Akzeptierte Einträge sind Keine, Kerberos und LDAP. Keine ist die Standardeinstellung.

Mögliche Werte

None, Kerberos, LDAP

Datentyp

string

Standardwert

None

Hinweise

Dieses Feld wird zur Authentifizierung gegenüber dem Server verwendet. Verwenden Sie die folgenden Optionen, um Ihr Authentifizierungsschema auszuwählen:

Keine: Es wird keine Authentifizierung durchgeführt, Standard.
Kerberos: Legen Sie diese Option fest, um Kerberos zur Authentifizierung zu verwenden.
LDAP: Legen Sie diese Option fest, um LDAP zur Authentifizierung zu verwenden.

Kerberos

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

Eigenschaft	Beschreibung
`KerberosKDC`	Der Kerberos Key Distribution Center (KDC)-Dienst, der zur Authentifizierung des Benutzers verwendet wird.
`KerberosRealm`	Der Kerberos-Bereich, der zur Authentifizierung des Benutzers verwendet wird.
`KerberosSPN`	Der Service Principal Name (SPN) für den Kerberos-Domänencontroller.
`KerberosKeytabFile`	Die Keytab-Datei, die Ihre Paare aus Kerberos-Prinzipalen und verschlüsselten Schlüsseln enthält.
`KerberosServiceRealm`	Der Kerberos-Bereich des Dienstes.
`KerberosServiceKDC`	Das Kerberos-KDC des Dienstes.
`KerberosTicketCache`	Der vollständige Dateipfad zu einer Cachedatei für MIT Kerberos-Anmeldeinformationen.

KerberosKDC

Der Kerberos Key Distribution Center (KDC)-Dienst, der zur Authentifizierung des Benutzers verwendet wird.

Datentyp

string

Standardwert

""

Hinweise

Die Kerberos-Eigenschaften werden bei Verwendung von SPNEGO oder Windows Authentifizierung verwendet. Der Connector fordert Sitzungstickets und temporäre Sitzungsschlüssel vom Kerberos-KDC-Dienst an. Der Kerberos-KDC-Dienst befindet sich üblicherweise am selben Standort wie der Domänencontroller.

Wenn Kerberos KDC nicht angegeben ist, versucht der Connector, diese Eigenschaften automatisch an den folgenden Standorten zu erkennen:

KRB5 Config File (krb5.ini/krb5.conf): Wenn die Umfeld KRB5_CONFIG gesetzt ist und die Datei existiert, ruft der Connector den KDC aus der angegebenen Datei ab. Andernfalls versucht er, basierend auf dem Operationssystem vom Standard-MIT-Speicherort zu lesen: C:\ProgramData\MIT\Kerberos5\krb5.ini (Windows) oder /etc/krb5.conf (Linux).
Java System Properties: Verwenden der Systemeigenschaften java.security.krb5.realm Und java.security.krb5.kdc.
Domain Name and Host: Wenn Kerberos Realm und Kerberos KDC nicht von einem anderen Standort abgeleitet werden konnten, leitet der Connector sie vom konfigurierten Domänennamen und Host ab.

Notiz

Die Windows Authentifizierung wird nur in JRE 1.6 und höher unterstützt.

KerberosRealm

Der Kerberos-Bereich, der zur Authentifizierung des Benutzers verwendet wird.

Datentyp

string

Standardwert

""

Hinweise

Die Kerberos-Eigenschaften werden bei Verwendung von SPNEGO oder Windows-Authentifizierung verwendet. Der Kerberos-Bereich wird verwendet, um den Benutzer mit dem Kerberos Key Distribution Service (KDC) zu authentifizieren. Der Kerberos-Bereich kann von einem Administrator als beliebige Zeichenfolge konfiguriert werden, basiert jedoch üblicherweise auf dem Domänennamen.

Wenn kein Kerberos-Bereich angegeben ist, versucht der Connector, diese Eigenschaften automatisch an den folgenden Standorten zu erkennen:

KRB5 Config File (krb5.ini/krb5.conf): Wenn die Umfeld KRB5_CONFIG gesetzt ist und die Datei existiert, erhält der Connector den Standardbereich aus der angegebenen Datei. Andernfalls versucht er, basierend auf dem Operationssystem vom MIT-Standardspeicherort zu lesen: C:\ProgramData\MIT\Kerberos5\krb5.ini (Windows) oder /etc/krb5.conf (Linux)
Java System Properties: Verwenden der Systemeigenschaften java.security.krb5.realm Und java.security.krb5.kdc.
Domain Name and Host: Wenn der Kerberos-Bereich und der Kerberos-KDC nicht von einem anderen Standort abgeleitet werden konnten, leitet der Connector sie vom benutzerkonfigurierten Domänennamen und Host ab. Dies kann in einigen Windows Umgebungen funktionieren.

Hinweis

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.
`Catalog`	Der Name des zu verwendenden Katalogs.
`Schema`	Das Schema der Presto-Datenbank.

Standort

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

Datentyp

string

Standardwert

%APPDATA%\Presto 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%\ Presto 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

Schema

Das Schema der Presto Datenbank.

Datentyp

string

Standardwert

""

Hinweise

Das Schema der Presto Datenbank.

Verschiedenes

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

Eigenschaft	Beschreibung
`SessionProperties`	Sitzungseigenschaften, die für das System und für Kataloge festgelegt werden sollen, angegeben als Liste von Key-Value Paaren und durch Kommas getrennt. Beispielsweise setzt abc=xyz, example.foo=bar die Systemeigenschaft abc auf den Wert xyz und die Eigenschaft foo für den Katalog example auf den Wert bar.
`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.
`PseudoColumns`	Diese Eigenschaft gibt an, ob Pseudospalten als Spalten in die Tabelle aufgenommen werden sollen oder nicht.
`QueryPassthrough`	Diese Option übergibt die Abfrage unverändert an den Presto-Server.
`SortColumns`	Gibt an, ob Spalten alphabetisch sortiert werden sollen.
`Timeout`	Der Wert in Sekunden, bis der Timeout-Fehler auftritt und der Operation abgebrochen wird.
`UserDefinedViews`	Ein Dateipfad, der auf die JSON-Konfigurationsdatei verweist, die Ihre benutzerdefinierten Ansichten enthält.

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.

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.

BenutzerdefinierteAnsichten

Ein Dateipfad, der auf die JSON-Konfigurationsdatei verweist, die Ihre benutzerdefinierten Ansichten enthält.

Datentyp

string

Standardwert

""

Hinweise

Benutzerdefinierte Ansichten werden in einer JSON-formatierten Konfigurationsdatei namens UserDefinedViews.json. Der Connector erkennt die in dieser Datei angegebenen Ansichten automatisch.

Sie können auch mehrere Ansichtsdefinitionen haben und diese mit steuern UserDefinedViews Verbindungseigenschaft. Wenn Sie diese Eigenschaft verwenden, werden vom Connector nur die angegebenen Ansichten angezeigt.

Diese Konfigurationsdatei für benutzerdefinierte Ansichten ist wie folgt formatiert:

Jedes Stammelement definiert den Namen einer Ansicht.
Jedes Stammelement enthält ein untergeordnetes Element namens query, das die benutzerdefinierte SQL- Abfrage für die Ansicht enthält.

Zum Beispiel:

{
    "MyView": {
        "query": "SELECT * FROM [Hive].[Default].Customers WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Verwenden Sie UserDefinedViews Verbindungseigenschaft zur Angabe des Speicherorts Ihrer JSON-Konfigurationsdatei. Beispiel:

"UserDefinedViews", C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json

Beachten Sie, dass der angegebene Pfad nicht in Anführungszeichen steht.