Crea connessione

Versione 4.0.23.4

Crea una connessione utilizzando la configurazione specificata.

Richiesta

POST /connessioni
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.

Risposta

200: connessione

Tipo di dati
Descrizione
(oggetto)
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
Espandi definizione dialetto...
name
string
Il nome del dialetto
etichetta
string
Etichetta leggibile della connessione
assistenza_stima_costo
boolean
Indica se il dialetto supporta le stime dei costi delle query
stile_stima_costo
string
In che modo il dialetto gestisce la stima dei costi
indici_tabella_permanenti
string
Colonne indice PDT
chiavi_ordinamento_permanenti
string
Colonne di ordinamento PDT
permanente_tabella_distkey
string
Colonna distkey PDT
flussi_di_supporto
boolean
Supporta i risultati di streaming
Automatic_run_sql_runner_snippets
boolean
Gli snippet SQL Runner devono essere eseguiti automaticamente
test_connessione
stringa[]
supporto_induttore
boolean
È supportato dall'induttore (ad es. generate da sql)
supporta_più_database
boolean
È possibile accedere a più database da una connessione utilizzando questo dialetto
tabelle_persistenti_derived_
boolean
Indica se il dialetto supporta la creazione di tabelle derivate permanenti per consentire a Looker
assistenza_has_ssl
boolean
Il database ha il supporto SSL client configurabile tramite la stringa JDBC?
snippet
Espandi definizione snippet...
name
string
Nome dello snippet
etichetta
string
Etichetta dello snippet
sql
string
Testo SQL dello 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"
Espandi definizione DBConnectionOverride...
context
string
Contesto in cui eseguire l'override ('pdt' è l'unico valore consentito)
host
string
Nome/indirizzo host del server
porta
string
Numero di porta sul server
nome utente
string
Nome utente per l'autenticazione del server
password
string
(Sola lettura) Password per l'autenticazione del server
ha_password
boolean
Indica se la password viene sostituita o meno in questo contesto.
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
schema
string
Nome schema
jdbc_additional_params
string
Parametri aggiuntivi da aggiungere alla stringa di connessione JDBC
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"
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.

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

409: Risorsa già esistente

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

422: Errore di convalida

Tipo di dati
Descrizione
messaggio
string
Error details (Dettagli errore)
Espandi definizione ValidationErrorDetails...
campo
string
Campo con errore
codice
string
Codice di errore
messaggio
string
Messaggio informativo sull'errore
documentazione_url
string
Link alla documentazione
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

Esempi