Testa la configurazione della connessione

Versione 4.0.23.6 (più recente)

Testare una configurazione di connessione.

Tieni presente che la proprietà "dialetto" di una connessione ha una proprietà "connection_tests" che elenca i tipi specifici di test supportati dalla connessione.

Questa API ha una limitazione di frequenza.

I test non supportati nella richiesta verranno ignorati.

Richiesta

PUT /Connessioni/test
Tipo di dati
Descrizione
Richiesta
HTTPRequest
body
HTTPBody
Espandi definizione HTTPBody...
body
Connessione
Espandi definizione DBConnection...
può
oggetto
Operazioni che l'utente corrente può eseguire su questo oggetto
name
string
Il nome della connessione. Utilizzato anche come identificatore univoco
dialetto
Dettagli (di sola lettura) del dialetto SQL
snippet
pdts_enabled
boolean
True se le PDT sono abilitate su questa connessione
host
string
Nome/indirizzo dell'host del server; o la stringa "localhost" in caso di connessione su un tunnel SSH.
porta
string
Numero di porta sul server. Se la connessione avviene tramite un tunnel SSH, la porta locale associata al tunnel SSH.
nome utente
string
Nome utente per l'autenticazione del server
password
string
(Sola lettura) Password per l'autenticazione del server
utilizza_oauth
boolean
Indica se la connessione utilizza OAuth per l'autenticazione.
certificato
string
(Solo scrittura) Corpo del certificato con codifica Base64 per l'autenticazione del server (se appropriato per il dialetto).
tipo_file
string
(Solo scrittura) Tipo di file chiave certificato .json o .p12
database
string
Nome database
db_timezone
string
Fuso orario del database
fuso orario query
string
Fuso orario da utilizzare nelle query
schema
string
Nome schema
Numero massimo di connessioni
integer
Numero massimo di connessioni simultanee da utilizzare
max_fatturazione_gigabyte
string
Dimensione massima della query in GB (solo BigQuery, può essere un nome di attributo utente)
ssl
boolean
Usa SSL/TLS per la connessione al server
verifica_ssl
boolean
Verifica l'SSL
Nome_tmp_db
string
Nome del database temporaneo (se utilizzato)
jdbc_additional_params
string
Parametri aggiuntivi da aggiungere alla stringa di connessione JDBC
timeout_pool
integer
Timeout del pool di connessioni, in secondi
nome_dialetto
string
(Lettura/Scrittura) Nome del dialetto SQL
support_data_studio_link
boolean
La connessione al database è in grado di supportare l'esplorazione di Data Data Open
creata_alle
string
Data di creazione per questa connessione
ID_utente
string
ID dell'utente che ha modificato questa configurazione di connessione l'ultima volta
esempio
boolean
Si tratta di un esempio di connessione?
credenziali_utente_db
boolean
(Funzionalità di accesso limitato) Sono abilitate le credenziali per database utente. L'attivazione rimuoverà i nomi utente e le password impostati in precedenza
campi_attributo_utente
stringa[]
manutenzione_cron
string
Stringa cron che specifica quando devono essere eseguite operazioni di manutenzione, ad esempio controlli e cali dei trigger PDT
ultimo_regen_at
string
Timestamp Unix all'inizio dell'ultimo processo di controllo dei trigger PDT completato
ultima_raccolta
string
Timestamp Unix all'inizio dell'ultimo processo di PDT Reap completato
tabelle_sql_runner_precache_table
boolean
Pre-memorizzazione delle tabelle nelle cache in SQL Runner
scrittura_sql_with_info_schema
boolean
Recupera lo schema di informazioni per la scrittura SQL
istruzioni_dopo_connessione
string
Istruzioni SQL (separate da punto e virgola) da emettere dopo la connessione al database. Richiede una funzionalità di licenza "custom_after_connect_statements"
sostituzione_contesto_pdt
db_connection_override per questa connessione nel contesto di manutenzione "pdt"
gestita
boolean
Questa connessione è stata creata e gestita da Looker
porta_locale_personalizzata
integer
Questo campo è applicabile solo alle connessioni su un tunnel SSH. Il valore di questo campo corrisponde alla porta locale associata al tunnel SSH, se configurato manualmente. In caso contrario, inserisci NULL o escludi questo campo.
id_tunnel
string
L'ID del tunnel SSH utilizzato da questa connessione
utilizza_tns
boolean
Abilita connessioni TNS (Transparent Network Substrate)
pdt_concurrency
integer
Numero massimo di thread da utilizzare per creare PDT in parallelo
disattiva_commento_contesto
boolean
Quando disabled_context_comment è true, il commento non verrà aggiunto a SQL
ID_applicazione_oauth
string
Un'applicazione OAuth esterna da utilizzare per l'autenticazione nel database
build_ sempre_provata_errore
boolean
Quando il valore è true, le PDT di errore verranno tentate di nuovo ogni ciclo del rigeneratore
costo_stima_abilitato
boolean
Se true, la stima dei costi delle query verrà visualizzata in Explore.
pdt_api_control_enabled
boolean
Le operazioni di creazione di PDT su questa connessione possono essere avviate e annullate tramite l'API.
della query
Query HTTP
Espandi definizione HTTPQuery in corso...
test
stringa[]

Risposta

200: risultati dei test

Tipo di dati
Descrizione
può
oggetto
Operazioni che l'utente corrente può eseguire su questo oggetto
stringa_connessione
string
Stringa di connessione JDBC. (completato solo nel test "connect")
messaggio
string
Messaggio del risultato del test
name
string
Nome del test
stato
string
Codice risultato del test

400: Richiesta errata

Tipo di dati
Descrizione
(oggetto)
messaggio
string
Error details (Dettagli errore)
documentazione_url
string
Link alla documentazione

404: Non trovata

Tipo di dati
Descrizione
(oggetto)
messaggio
string
Error details (Dettagli errore)
documentazione_url
string
Link alla documentazione

429: Troppe richieste

Tipo di dati
Descrizione
(oggetto)
messaggio
string
Error details (Dettagli errore)
documentazione_url
string
Link alla documentazione