Verbindungskonfiguration testen

Version 4.0.23.4

Verbindungskonfiguration testen

Das Attribut „dialect“ einer Verbindung hat das Attribut „connection_tests“, in dem die von der Verbindung unterstützten Testtypen aufgelistet sind.

Für diese API gilt eine Ratenbegrenzung.

Nicht unterstützte Tests in der Anfrage werden ignoriert.

Anfrage

PUT/g/connections/test
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.
Abfrage
HTTP-Abfrage
HTTPQuery-Definition maximieren...
Tests
String[]

Antwort

200: Testergebnisse

Datentyp
Beschreibung
kann
Objekt
Vorgänge, die der aktuelle Nutzer für dieses Objekt ausführen kann
Verbindungsstring
String
JDBC-Verbindungsstring. (wird nur im Test „connect“ eingefügt)
nachricht
String
Ergebnisnachricht des Tests
name
String
Name des Tests
Status
String
Ergebniscode des Tests

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

429: Zu viele Anfragen

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