Verbindung erstellen

Version 4.0.23.6 (neueste Version)

Erstellen Sie eine Verbindung mit der angegebenen Konfiguration.

Anfrage

POST /connections
Datentyp
Beschreibung
Anfrage
HTTPRequest
body
HTTP-Text
HTTPBody-Definition maximieren...
body
Verbindung
DBConnection-Definition maximieren...
kann
Objekt
Vorgänge, die der aktuelle Nutzer für dieses Objekt ausführen kann
name
String
Name der Verbindung. Wird auch als eindeutige Kennung verwendet
Dialekt
SQL-Dialektdetails (schreibgeschützt)
Snippets
PDT_Aktiviert
boolean
True, wenn PDTs für diese Verbindung aktiviert sind
Host
String
Hostname/Adresse des Servers oder String „localhost“, wenn eine Verbindung über einen SSH-Tunnel hergestellt wird.
Port
String
Portnummer auf dem Server. Wenn die Verbindung über einen SSH-Tunnel läuft, ist der lokale Port mit dem SSH-Tunnel verknüpft.
Nutzername
String
Nutzername für die Serverauthentifizierung
Passwort
String
(Nur Schreibzugriff) Passwort für die Serverauthentifizierung
Verwendet_OAuth
boolean
Gibt an, ob die Verbindung OAuth zur Authentifizierung verwendet.
Zertifikat
String
(Nur Schreibzugriff) Base64-codierter Zertifikattext für die Serverauthentifizierung (sofern für den Dialekt geeignet).
Dateityp
String
(nur Schreibzugriff) Zertifikatschlüsseltyp – .json oder .p12
Datenbank
String
Datenbankname
db_timezone
String
Zeitzone der Datenbank
Abfragezeitzone
String
In Abfragen zu verwendende Zeitzone
schema
String
Schemaname
max_connections
integer
Maximale Anzahl gleichzeitiger Verbindungen
Max_billing_ Gigabyte
String
Maximale Größe der Abfrage in GB (nur BigQuery, kann ein „user_attribute“-Name sein)
ssl
boolean
SSL/TLS beim Herstellen einer Verbindung zum Server verwenden
Bestätigung "ssl"
boolean
SSL überprüfen
tmp_db_name
String
Name der temporären Datenbank (falls verwendet)
jdbc_additional_params
String
Zusätzliche Parameter, die dem JDBC-Verbindungsstring hinzugefügt werden sollen
Billard
integer
Zeitlimit für Verbindungspool in Sekunden
Dialektname
String
(Lesen/Schreiben) SQL-Dialektname
support_data_studio_link
boolean
Mit der Datenbankverbindung können Sie in Open Data Studio
erstellt am
String
Erstellungsdatum für diese Verbindung
user_id
String
ID des Nutzers, der diese Verbindungskonfiguration zuletzt geändert hat
Beispiel
boolean
Ist das eine Beispielverbindung?
nutzer_db_credentials
boolean
(Funktion mit eingeschränktem Zugriff) Sind pro db-Anmeldedaten des Nutzers aktiviert. Wenn Sie diese Option aktivieren, werden zuvor festgelegter Nutzername und dieses Passwort entfernt
Nutzer_Attributfelder
String[]
Wartung Cron
String
Cronstring, der angibt, wann Wartung wie PDT-Triggerprüfungen und Drops durchgeführt werden sollen
letzter_regen_at
String
Unix-Zeitstempel zu Beginn der letzten abgeschlossenen PAT-Prüfung
Last_Reap_AT
String
Unix-Zeitstempel zu Beginn des letzten abgeschlossenen PAT-Reap-Prozesses
SQL-Runner_Precache-Tabellen
boolean
Tabellen im SQL-Runner vorab im Cache speichern
SQL-Schreibvorgang_mit_Infoschema
boolean
Fetch Information Schema For SQL Writing
Nach_Verbindung_Anweisungen
String
SQL-Anweisungen (durch Semikolon getrennt), die nach dem Herstellen einer Verbindung zur Datenbank auszuführen sind. Erfordert die Lizenzfunktion "custom_after_connect_statements".
ptt_context_override
db_connection_override für diese Verbindung im Wartungskontext „pdt“
managed
boolean
Wird diese Verbindung von Looker erstellt und verwaltet?
Benutzerdefinierter_lokaler_Port
integer
Dieses Feld gilt nur für Verbindungen über einen SSH-Tunnel. Der Wert dieses Felds wäre der lokale Port, der mit dem SSH-Tunnel verknüpft ist, sofern er manuell konfiguriert wurde. Geben Sie andernfalls NULL ein oder schließen Sie dieses Feld aus.
tunnel_id
String
Die ID des SSH-Tunnels, den diese Verbindung verwendet
verwendet_tns
boolean
TNS-Verbindungen (Transparent Network Substrate) aktivieren
PPDT_Nebenläufigkeit
integer
Maximale Anzahl von Threads, die zur parallelen Erstellung von PATs verwendet werden sollen
Kontextkommentar deaktivieren
boolean
Wenn „disable_context_comment“ auf „true“ gesetzt ist, wird der Kommentar nicht zu SQL hinzugefügt
OAuth-Anwendungs-ID
String
Eine externe OAuth-Anwendung zur Authentifizierung bei der Datenbank
Always_retry_failed_builds
boolean
Bei „true“ werden Fehler-PDTs in jedem Regeneratorzyklus wiederholt.
Kostenschätzung_aktiviert
boolean
Wenn der Wert „true“ ist, wird die Kostenschätzung für Abfragen in der explorativen Datenanalyse angezeigt.
pdt_api_control_enabled
boolean
PAT-Builds für diese Verbindung können über die API gestartet und abgebrochen werden.

Antwort

200: Verbindung

Datentyp
Beschreibung
(Objekt)
kann
Objekt
Vorgänge, die der aktuelle Nutzer für dieses Objekt ausführen kann
name
String
Name der Verbindung. Wird auch als eindeutige Kennung verwendet
Dialekt
SQL-Dialektdetails (schreibgeschützt)
Dialektdefinition wird maximiert...
name
String
Der Name des Dialekts
Label
String
Das für Menschen lesbare Label der Verbindung
Unterstützen_Kostenschätzung
boolean
Ob der Dialekt Abfragekostenschätzungen unterstützt
Kostenschätzung
String
Wie der Dialekt die Kostenschätzung verarbeitet
persistente Tabellenindexe
String
PAT-Indexspalten
persistente_Sortierschlüssel
String
Sortiert von PAT-Sortierschlüsseln
persistenter_Tabellenschlüssel
String
PAT-Diskrepanzspalte
unterstützt_streaming
boolean
Unterstützt Streamingergebnisse
automatisch_sql_runner_snippets ausführen
boolean
Sollen SQL Runner-Snippets automatisch ausgeführt werden
Verbindungstests
String[]
unterstützt_inducer
boolean
Wird vom Inducer unterstützt (d.h. von SQL generieren)
Unterstützt_mehrere_Datenbanken
boolean
Kann über diesen Dialekt über eine Verbindung auf mehrere Datenbanken zugegriffen werden
unterstützt_persistente_abgeleitete_Tabellen
boolean
Informationen darüber, ob der Dialekt das Erstellen persistenter abgeleiteter Tabellen in Looker unterstützt
has_ssl_support
boolean
Kann die Client-SSL-Unterstützung in der Datenbank explizit über den JDBC-String konfiguriert werden?
Snippets
Snippet-Definition maximieren...
name
String
Name des Snippets.
Label
String
Label des Snippets
sql
String
SQL-Text des Snippets
PDT_Aktiviert
boolean
True, wenn PDTs für diese Verbindung aktiviert sind
Host
String
Hostname/Adresse des Servers oder String „localhost“, wenn eine Verbindung über einen SSH-Tunnel hergestellt wird.
Port
String
Portnummer auf dem Server. Wenn die Verbindung über einen SSH-Tunnel läuft, ist der lokale Port mit dem SSH-Tunnel verknüpft.
Nutzername
String
Nutzername für die Serverauthentifizierung
Passwort
String
(Nur Schreibzugriff) Passwort für die Serverauthentifizierung
Verwendet_OAuth
boolean
Gibt an, ob die Verbindung OAuth zur Authentifizierung verwendet.
Zertifikat
String
(Nur Schreibzugriff) Base64-codierter Zertifikattext für die Serverauthentifizierung (sofern für den Dialekt geeignet).
Dateityp
String
(nur Schreibzugriff) Zertifikatschlüsseltyp – .json oder .p12
Datenbank
String
Datenbankname
db_timezone
String
Zeitzone der Datenbank
Abfragezeitzone
String
In Abfragen zu verwendende Zeitzone
schema
String
Schemaname
max_connections
integer
Maximale Anzahl gleichzeitiger Verbindungen
Max_billing_ Gigabyte
String
Maximale Größe der Abfrage in GB (nur BigQuery, kann ein „user_attribute“-Name sein)
ssl
boolean
SSL/TLS beim Herstellen einer Verbindung zum Server verwenden
Bestätigung "ssl"
boolean
SSL überprüfen
tmp_db_name
String
Name der temporären Datenbank (falls verwendet)
jdbc_additional_params
String
Zusätzliche Parameter, die dem JDBC-Verbindungsstring hinzugefügt werden sollen
Billard
integer
Zeitlimit für Verbindungspool in Sekunden
Dialektname
String
(Lesen/Schreiben) SQL-Dialektname
support_data_studio_link
boolean
Mit der Datenbankverbindung können Sie in Open Data Studio
erstellt am
String
Erstellungsdatum für diese Verbindung
user_id
String
ID des Nutzers, der diese Verbindungskonfiguration zuletzt geändert hat
Beispiel
boolean
Ist das eine Beispielverbindung?
nutzer_db_credentials
boolean
(Funktion mit eingeschränktem Zugriff) Sind pro db-Anmeldedaten des Nutzers aktiviert. Wenn Sie diese Option aktivieren, werden zuvor festgelegter Nutzername und dieses Passwort entfernt
Nutzer_Attributfelder
String[]
Wartung Cron
String
Cronstring, der angibt, wann Wartung wie PDT-Triggerprüfungen und Drops durchgeführt werden sollen
letzter_regen_at
String
Unix-Zeitstempel zu Beginn der letzten abgeschlossenen PAT-Prüfung
Last_Reap_AT
String
Unix-Zeitstempel zu Beginn des letzten abgeschlossenen PAT-Reap-Prozesses
SQL-Runner_Precache-Tabellen
boolean
Tabellen im SQL-Runner vorab im Cache speichern
SQL-Schreibvorgang_mit_Infoschema
boolean
Fetch Information Schema For SQL Writing
Nach_Verbindung_Anweisungen
String
SQL-Anweisungen (durch Semikolon getrennt), die nach dem Herstellen einer Verbindung zur Datenbank auszuführen sind. Erfordert die Lizenzfunktion "custom_after_connect_statements".
ptt_context_override
db_connection_override für diese Verbindung im Wartungskontext „pdt“
DBConnectionOverride-Definition maximieren...
context
String
Kontext, in dem die Überschreibung erfolgen soll (der einzige zulässige Wert ist „pdt“)
Host
String
Hostname/Adresse des Servers
Port
String
Portnummer auf Server
Nutzername
String
Nutzername für die Serverauthentifizierung
Passwort
String
(Nur Schreibzugriff) Passwort für die Serverauthentifizierung
has_password
boolean
Gibt an, ob das Passwort in diesem Kontext überschrieben wird
Zertifikat
String
(Nur Schreibzugriff) Base64-codierter Zertifikattext für die Serverauthentifizierung (sofern für den Dialekt geeignet).
Dateityp
String
(nur Schreibzugriff) Zertifikatschlüsseltyp – .json oder .p12
Datenbank
String
Datenbankname
schema
String
Schemaname
jdbc_additional_params
String
Zusätzliche Parameter, die dem JDBC-Verbindungsstring hinzugefügt werden sollen
Nach_Verbindung_Anweisungen
String
SQL-Anweisungen (durch Semikolon getrennt), die nach dem Herstellen einer Verbindung zur Datenbank auszuführen sind. Erfordert die Lizenzfunktion "custom_after_connect_statements".
managed
boolean
Wird diese Verbindung von Looker erstellt und verwaltet?
Benutzerdefinierter_lokaler_Port
integer
Dieses Feld gilt nur für Verbindungen über einen SSH-Tunnel. Der Wert dieses Felds wäre der lokale Port, der mit dem SSH-Tunnel verknüpft ist, sofern er manuell konfiguriert wurde. Geben Sie andernfalls NULL ein oder schließen Sie dieses Feld aus.
tunnel_id
String
Die ID des SSH-Tunnels, den diese Verbindung verwendet
verwendet_tns
boolean
TNS-Verbindungen (Transparent Network Substrate) aktivieren
PPDT_Nebenläufigkeit
integer
Maximale Anzahl von Threads, die zur parallelen Erstellung von PATs verwendet werden sollen
Kontextkommentar deaktivieren
boolean
Wenn „disable_context_comment“ auf „true“ gesetzt ist, wird der Kommentar nicht zu SQL hinzugefügt
OAuth-Anwendungs-ID
String
Eine externe OAuth-Anwendung zur Authentifizierung bei der Datenbank
Always_retry_failed_builds
boolean
Bei „true“ werden Fehler-PDTs in jedem Regeneratorzyklus wiederholt.
Kostenschätzung_aktiviert
boolean
Wenn der Wert „true“ ist, wird die Kostenschätzung für Abfragen in der explorativen Datenanalyse angezeigt.
pdt_api_control_enabled
boolean
PAT-Builds für diese Verbindung können über die API gestartet und abgebrochen werden.

400: Ungültige Anfrage

Datentyp
Beschreibung
(Objekt)
nachricht
String
Fehlerdetails
Dokumentations-URL
String
Link zur Dokumentation

404: Nicht gefunden

Datentyp
Beschreibung
(Objekt)
nachricht
String
Fehlerdetails
Dokumentations-URL
String
Link zur Dokumentation

409: Ressource ist bereits vorhanden

Datentyp
Beschreibung
(Objekt)
nachricht
String
Fehlerdetails
Dokumentations-URL
String
Link zur Dokumentation

422: Validierungsfehler

Datentyp
Beschreibung
nachricht
String
Fehlerdetails
ValidationErrorDetail-Definition maximieren...
Feld
String
Feld mit Fehler
Code
String
Fehlercode
nachricht
String
Fehlermeldung
Dokumentations-URL
String
Link zur Dokumentation
Dokumentations-URL
String
Link zur Dokumentation

429: Zu viele Anfragen

Datentyp
Beschreibung
(Objekt)
nachricht
String
Fehlerdetails
Dokumentations-URL
String
Link zur Dokumentation

Beispiele