Impostazioni amministratore - Connessioni

Per accedere alla pagina Connessioni, apri il menu Admin e, in Database, scegli Connections.

Visualizzazione delle connessioni

Nella pagina Connessioni, puoi visualizzare le connessioni al tuo database e gli indirizzi IP necessari per consentire il traffico di rete. Se la capacità di creare un nuovo database è stata abilitata per la tua istanza, puoi anche aggiungere una nuova connessione.

Scheda Database

La scheda Database mostra le informazioni di base sulle connessioni ai database che hai definito. Mostra anche le connessioni gestite da Looker che hai creato, se è stata abilitata la possibilità di creare un nuovo database per la tua istanza. Puoi anche verificare lo stato di queste connessioni e modificarle nella scheda Database.

Puoi fare clic su Indirizzi IP pubblici per visualizzare l'elenco di indirizzi IP necessari per consentire il traffico di rete dalla tua istanza di Looker. Tutto il traffico di rete da Looker proviene da uno degli indirizzi IP elencati, in base all'area geografica in cui è ospitata l'istanza di Looker. Proibire il traffico al tuo database, tranne che da questi e da altri indirizzi IP attendibili, è un modo semplice per limitare l'accesso ai dati.

Nella tabella seguente sono descritti gli elementi della scheda Database:

Colonna Descrizione
Nome Il nome della connessione scelto da te utilizzato nel parametro LookML di connection. Quando test la connessione, Looker visualizza l'elenco dei controlli di stato sotto il nome della connessione.
Database Il nome del database su cui Looker eseguirà query quando usa questa connessione.
Server SSH Il nome della configurazione del server SSH utilizzata per creare un tunnel SSH al tuo database. Questa colonna mostra solo se la scheda Server SSH è abilitata per la tua istanza di Looker.
SSL Se utilizzi o meno la crittografia SSL per proteggere i dati che viaggiano da Looker al tuo database, esistono altre opzioni sicure oltre a SSL.
Tipo Il dialetto SQL della connessione al database.
Azioni Azioni che puoi eseguire per una connessione: testa una connessione, modificala, visualizzane altre, vai a un elenco di link alla pagina Esplorazioni o elimina la connessione. Se è stata attivata la possibilità di creare un nuovo database per la tua istanza, puoi anche aggiungere dati da un'origine dati aggiuntiva a qualsiasi connessione gestita da Looker.

Scheda Server SSH

L'opzione SSH Server (Server SSH) è disponibile se è stato eseguito il deployment dell'istanza nell'infrastruttura Kubernetes e solo se è stata abilitata la possibilità di aggiungere informazioni di configurazione del server SSH alla tua istanza di Looker. Se questa opzione non è abilitata per la tua istanza di Looker e desideri abilitarla, contatta un esperto delle vendite di Google Cloud o apri una richiesta di assistenza.

Looker sceglie automaticamente la porta localhost quando crei i tunnel SSH; al momento non puoi specificare la porta localhost.

Le connessioni SSH ai database PrestoDB o Trino potrebbero richiedere una configurazione del database aggiuntiva. Quando è abilitato SSL, il database PrestoDB o Trino è in ascolto per impostazione predefinita sulla porta 443. Per stabilire il tunnel SSH, Looker deve impostare la porta localhost su 443, che è già in uso da parte di Looker. La configurazione del tunnel SSH avrà esito negativo. Per risolvere il problema, configura il database PrestoDB o Trino in modo che rimanga su una porta diversa dalla porta 443 quando è abilitato SSL.

La scheda SSH Servers (Server SSH) elenca le configurazioni di server SSH che hai aggiunto, indica lo stato delle connessioni ai server SSH ed elenca le connessioni del database utilizzando ciascun server SSH. Nella scheda SSH Servers (Server SSH), puoi anche testare una connessione a un server SSH e aggiungere o modificare le configurazioni dei server SSH.

Nella tabella seguente sono descritti gli elementi della scheda SSH Servers (Server SSH):

Colonna Descrizione
Nome server Il nome della configurazione del server SSH che hai scelto per la connessione al tuo database.
Connessioni Un elenco delle connessioni ai database che si connettono al server SSH. Se fai clic su una connessione al database, si apre la pagina Modifica connessione relativa alla connessione al database.
Menu Opzioni Azioni che puoi eseguire per una configurazione del server SSH: verifica le connessioni a un server SSH, aggiungi una connessione al database a un server SSH, modifica una configurazione del server SSH o elimina una configurazione del server SSH.

Aggiunta o modifica di una configurazione del server SSH

Per aggiungere una nuova configurazione di server SSH:

  1. Nella scheda SSH Server (Server SSH), fai clic su Add Server (Aggiungi server).
  2. Nel campo Server senza nome nell'angolo in alto a destra, inserisci un nome per la configurazione del server SSH.
  3. Fai clic su Scarica chiave per scaricare la chiave pubblica in un file di testo. Assicurati di salvare questo file per un utilizzo futuro.
  4. Nel campo Server Username (Nome utente del server), inserisci il nome utente che Looker utilizzerà per connettersi al server SSH.
  5. Nel campo Server IP Address or Username (Indirizzo IP o nome host del server), inserisci l'indirizzo IP o il nome host del server SSH.
  6. Nel campo Server Port (Porta server), inserisci il numero di porta da utilizzare per la connessione al server SSH.
  7. Aggiungi la chiave pubblica scaricata al file della chiave autorizzata sul tuo server SSH. Per ulteriori informazioni e un esempio, consulta la pagina Documentazione sull'utilizzo di un server SSH.
  8. Assicurati che gli indirizzi IP di Looker siano aggiunti alla lista consentita sul server SSH in modo che Looker possa connettersi al server SSH.
  9. Fai clic su Testa e richiedi l'impronta per verificare la tua connessione al server SSH.
  10. Visualizza la nuova configurazione SSH. In questa schermata puoi anche scaricare o visualizzare la chiave pubblica e visualizzare l'impronta univoca della configurazione server SSH.

Per modificare la configurazione di un server SSH esistente, fai clic sul menu con tre opzioni Opzioni nella riga del server SSH desiderato e scegli Dettagli server.

Test delle connessioni a un server SSH

Per testare tutte le connessioni ai database di un server SSH:

  1. Fai clic sul menu con tre puntini nella riga del server SSH desiderato.
  2. Scegli Test Connections (Prova connessioni).

Looker testerà tutte le connessioni al database utilizzando quel server SSH e mostrerà un segno di spunta verde accanto al nome del server e tutte le connessioni a cui è superato il test di connessione. Un'icona con un punto esclamativo rosso indica che la connessione non è riuscita per il test.

Aggiunta di una connessione di database a un server SSH

Per aggiungere una nuova connessione al database utilizzando un server SSH:

  1. Fai clic sul menu con tre puntini nella riga del server SSH desiderato.
  2. Scegli Aggiungi connessione.

Looker visualizza la pagina Connection Settings (Impostazioni di connessione), con il server SSH elencato nel campo SSH Server (Server SSH).

Eliminazione di una configurazione del server SSH

Per eliminare la configurazione di un server SSH:

  1. Fai clic sul menu con tre puntini nella riga del server SSH da eliminare.
  2. Scegli Elimina server.

Test delle connessioni

Looker ti consente di testare le connessioni esistenti per assicurarti che funzionino correttamente. Puoi anche testare le connessioni man mano che le aggiungi, come descritto nella pagina della documentazione Connessione di Looker al tuo database.

Ogni test di connessione include un elenco di controlli dello stato per indicarti se Looker può utilizzare correttamente la connessione al database.

I potenziali problemi sono indicati in giallo, mentre gli errori vengono visualizzati in rosso. Se una connessione "passa", viene visualizzata in verde.

Le connessioni ai database che utilizzano OAuth, come Snowflake e Google BigQuery, richiedono l'accesso degli utenti. Se non hai eseguito l'accesso al tuo account utente OAuth quando testi una di queste connessioni, Looker mostrerà un avviso con un link Log (Accedi). Fai clic sul link per inserire le credenziali OAuth o consentire a Looker di accedere ai dati del tuo account OAuth.

Puoi controllare lo stato di:

  • Una sola connessione facendo clic su Prova a destra
  • Tutte le connessioni facendo clic sul pulsante Prova tutte le connessioni nella parte superiore della pagina.

Due controlli sono una causa comune di confusione:

  • Possibilità di trovare schema temporaneo
  • Può utilizzare tabelle derivate permanenti

Non è necessario superare questi controlli affinché Looker funzioni. Tuttavia, è necessario passare per utilizzare le tabelle derivate permanenti, che sono una funzionalità di modellazione molto utile.

Aggiungere connessioni

Per aggiungere una nuova connessione al database, segui i passaggi descritti nella pagina della documentazione su come collegare Looker al database.

Modifica dei collegamenti

Per modificare una connessione esistente, fai clic sul pulsante Modifica a destra di ogni connessione. Verrà visualizzata la stessa pagina che utilizzi per creare una connessione (descritta nella pagina della documentazione Connessione di Looker al tuo database), ma con le informazioni pertinenti già compilate. Apporta le modifiche necessarie, quindi fai clic su Aggiorna connessione.

Azioni disponibili per tutte le connessioni

Tutte le connessioni offrono queste opzioni dal menu a discesa a ingranaggio all'estrema destra di ogni connessione:

Opzione Descrizione
SQL Runner Questa opzione ti consente di accedere a SQL Runner di Looker con la connessione e lo schema appropriati già selezionati.
Esplora Questa opzione ti consente di visualizzare un elenco di opzioni di esplorazione di base, generate automaticamente, per la tua connessione. Questi valori non si basano sui modelli di dati personalizzati, ma consentono alcuni report rapidi sui dati non elaborati nelle tabelle della connessione. Questa soluzione è in genere utile solo per farsi un'idea dei contenuti della tabella prima della definizione del modello, anziché ai fini dell'analisi effettiva dei dati.
Elimina Per eliminare una connessione esistente, fai clic sul menu a discesa a forma di ingranaggio all'estrema destra di una connessione e seleziona Elimina. Ti verrà data la possibilità di confermare l'eliminazione, ma non potrai annullare l'operazione. L'eliminazione accidentale di una connessione comporta la disattivazione delle query che la utilizzano. Tuttavia, se ricrei una nuova connessione con lo stesso nome, la funzionalità verrà ripristinata.

Azioni disponibili per alcune connessioni

A seconda del dialetto di connessione, il menu a discesa dell'ingranaggio a destra della connessione può offrire le seguenti opzioni aggiuntive:

Opzione Descrizione
Mostra tabelle Questa opzione ti porta a una pagina Explore di Looker in cui puoi creare report Looker in base ai metadati della tua connessione. Anche se questa opzione inizia con il nome dello schema, il nome della tabella e il conteggio delle colonne selezionati, puoi manipolarli come qualsiasi altro report di Looker.
Mostra database Questa opzione ti porta a una pagina Explore di Looker in cui puoi creare report Looker in base ai metadati della tua connessione. Anche se questa opzione inizia con il nome dello schema, il nome del catalogo, il conteggio della tabella e il conteggio delle colonne, puoi manipolarlo come qualsiasi altro report di Looker.
Mostra processi Questa opzione ti porta a una pagina Explore di Looker che ti consente di creare report Looker in base ai processi in esecuzione su questa connessione, al loro stato, alla loro durata e ad altre informazioni. Ciò può essere utile per determinare la causa se Looker è lento o se una query non è in esecuzione.
Mostra log eventi PDT Questa opzione ti porta a una pagina Explore di Looker che ti consente di creare report Looker in base all'attività della tabella derivata per questa connessione. I campi disponibili sono descritti in modo più dettagliato nella pagina della documentazione Tabelle derivate permanenti.