Impostazioni amministratore - Connessioni

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

Visualizzazione delle connessioni

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

Scheda Database

La scheda Database mostra informazioni di base sulle connessioni al database che hai definito. Vengono mostrate anche le connessioni gestite da Looker che hai creato, se la possibilità di creare un nuovo database è stata attivata per la tua istanza. Puoi anche verificare lo stato e modificare la configurazione di queste connessioni dalla scheda Database.

Puoi fare clic su Indirizzi IP pubblici per visualizzare l'elenco degli indirizzi IP necessari per consentire il traffico di rete dalla tua istanza di Looker. Tutto il traffico di rete di Looker proviene da uno degli indirizzi IP elencati, in base alla regione in cui è ospitata l'istanza di Looker. Vietare il traffico verso il tuo database, ad eccezione di questi e di altri indirizzi IP attendibili, è un modo per limitare l'accesso ai dati.

La tabella seguente descrive gli elementi della scheda Database:

Colonna Descrizione
Nome Il nome della connessione scelto da te, utilizzato nel parametro LookML connection. Quando testi la connessione, Looker mostra l'elenco dei controlli dello stato sotto il nome della connessione.
Database Il nome del database a cui eseguirà query Looker quando utilizza questa connessione.
Ambito Indica se la connessione può essere utilizzata con tutti i progetti o solo con un progetto specifico.
Server SSH Il nome della configurazione del server SSH utilizzata per creare un tunnel SSH al database. Questa colonna viene visualizzata solo se la scheda Server SSH è abilitata nell'istanza di Looker.
SSL Se utilizzi o meno la crittografia SSL per proteggere i dati in transito tra Looker e il tuo database (oltre a SSL sono disponibili altre opzioni di sicurezza).
Tipo Il dialetto SQL della connessione al database.
Azioni Azioni che puoi intraprendere per una connessione: testare una connessione, modificare una connessione, visualizzare altre informazioni su una connessione, passare a un elenco di link alle esplorazioni della connessione o eliminare una connessione. Se per la tua istanza è stata attivata la possibilità di creare un nuovo database, puoi anche aggiungere dati da un'altra origine dati a qualsiasi connessione gestita da Looker.

Scheda Server SSH

L'opzione Server SSH è disponibile se è stato eseguito il deployment dell'istanza nell'infrastruttura Kubernetes e solo se è stata concessa 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 vuoi abilitarla, contatta un esperto del team di vendita Google Cloud o apri una richiesta di assistenza.

Looker sceglie automaticamente la porta localhost durante la creazione dei tunnel SSH. Non puoi specificare la porta localhost.

Le connessioni SSH ai database PrestoDB o Trino potrebbero richiedere una configurazione aggiuntiva del database. Quando SSL è abilitato, 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 Looker. Di conseguenza, la configurazione del tunnel SSH non andrà a buon fine. Per risolvere il problema, configura il database PrestoDB o Trino in modo che sia in ascolto su una porta diversa dalla porta 443 quando è attivato SSL.

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

La tabella seguente descrive gli elementi della scheda SSH Servers (Server SSH):

Colonna Descrizione
Nome server Il nome della configurazione del server SSH, scelta da te, utilizzata per connetterti al database.
Connessioni Un elenco delle connessioni al database che si connettono al server SSH. Se fai clic su una connessione al database, si apre la pagina Modifica connessione per quella connessione.
Menu Opzioni con tre puntini Azioni che puoi eseguire per una configurazione del server SSH: testare le connessioni a un server SSH, aggiungere una connessione al database a un server SSH, modificare una configurazione del server SSH o eliminare una configurazione del server SSH.

Aggiunta o modifica di una configurazione del server SSH

Per aggiungere una nuova configurazione del server SSH:

  1. Nella scheda SSH Server (Server SSH), fai clic su 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 uso futuro.
  4. Nel campo Nome utente del server, inserisci il nome utente che verrà utilizzato da Looker per connettersi al server SSH.
  5. Nel campo Indirizzo IP o nome host del server, inserisci l'indirizzo IP o il nome host del server SSH.
  6. Nel campo Porta server, inserisci il numero di porta utilizzato per connetterti al server SSH.
  7. Aggiungi la chiave pubblica scaricata al file delle chiavi autorizzate sul server SSH. Per ulteriori informazioni e un esempio, consulta la pagina della documentazione Utilizzo di un server SSH.
  8. Assicurati che gli indirizzi IP di Looker appropriati siano aggiunti alla lista consentita sul server SSH in modo che Looker possa connettersi al server SSH.
  9. Fai clic su Testa e richiedi impronta per verificare la connessione al server SSH.
  10. Visualizza la nuova configurazione SSH. In questa schermata puoi anche scaricare o visualizzare la chiave pubblica e l'impronta univoca della configurazione del server SSH.

Per modificare una configurazione del server SSH esistente, fai clic sul menu Opzioni con tre puntini nella riga del server SSH selezionato e scegli Dettagli server.

Testare le connessioni a un server SSH

Per testare tutte le connessioni del database a un server SSH:

  1. Fai clic sul menu con tre puntini Opzioni nella riga del server SSH scelto.
  2. Scegli Testa connessioni.

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

Aggiunta di una connessione al database a un server SSH

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

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

Looker mostra la pagina Impostazioni connessione, con il server SSH elencato nel campo Server SSH.

Eliminazione di una configurazione del server SSH

Per eliminare una configurazione del server SSH:

  1. Fai clic sul menu Opzioni 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 database.

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

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

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

Puoi controllare lo stato di:

  • Una singola connessione facendo clic su Test all'estrema destra della connessione
  • Tutte le connessioni facendo clic sul pulsante Testa tutte le connessioni nella parte superiore della pagina.

Due controlli sono spesso fonte di confusione:

  • Può trovare lo schema temporaneo
  • Può utilizzare tabelle derivate permanenti

Questi controlli non devono essere superati per il funzionamento di Looker. Tuttavia, devi superare questo controllo per poter utilizzare le tabelle derivate permanenti, che sono una funzionalità di modellazione molto utile.

Aggiunta di connessioni

Per aggiungere una nuova connessione al database, segui i passaggi descritti nella pagina della documentazione Connessione di Looker al database.

Modificare le connessioni

Per modificare una connessione esistente, apri la pagina Connessioni selezionando il menu Amministrazione e poi Connessioni in Database. Fai clic sul pulsante Modifica per la connessione. Viene visualizzata la stessa pagina utilizzata per creare una connessione (descritta nella pagina della documentazione Connessione di Looker al database), ma con le informazioni pertinenti già inserite. Apporta le modifiche necessarie e poi fai clic su Aggiorna connessione.

Azioni disponibili per tutte le connessioni

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

Opzione Descrizione
SQL Runner Questa opzione ti reindirizza a SQL Runner di Looker, con la connessione e lo schema corretti già selezionati.
Esplora Questa opzione ti reindirizza a un elenco di opzioni di esplorazione di base generate automaticamente per la connessione. Non si basano sui tuoi modelli di dati personalizzati, ma consentono di generare alcuni report rapidi sui dati non elaborati nelle tabelle della connessione. In genere, questo è utile solo per farsi un'idea dei contenuti della tabella prima della definizione del modello, anziché per l'analisi effettiva dei dati.
Elimina Per eliminare un collegamento esistente, fai clic sul menu a discesa a forma di ingranaggio all'estrema destra di un collegamento e seleziona Elimina. Ti verrà data la possibilità di confermare l'eliminazione, ma, una volta eseguita, non potrà essere annullata. L'eliminazione accidentale di una connessione comporterà la disattivazione di tutte le query che la utilizzano. Tuttavia, se crei 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 a forma di ingranaggio a destra della connessione potrebbe offrire le seguenti opzioni aggiuntive:

Opzione Descrizione
Mostra tabelle Questa opzione ti reindirizza a una pagina di esplorazione di Looker che ti consente di creare query di esplorazione di Looker in base ai metadati della connessione. Sebbene questa opzione inizi con il nome dello schema, il nome della tabella e il numero di colonne selezionati, puoi manipolarla come qualsiasi altra esplorazione di Looker.
Mostra database Questa opzione ti reindirizza a una pagina di esplorazione di Looker che ti consente di creare query di esplorazione di Looker in base ai metadati della connessione. Sebbene questa opzione inizi con il nome dello schema, il nome del catalogo, il numero di tabelle e il numero di colonne selezionati, puoi manipolarla come qualsiasi altra esplorazione di Looker.
Mostra processi Questa opzione ti reindirizza a una pagina di esplorazione di Looker che ti consente di creare query di esplorazione di Looker in base ai processi in esecuzione su questa connessione, allo stato in cui si trovano, alla durata dell'esecuzione e ad altre informazioni. Questa opzione può essere utile per determinare la causa se Looker è lento o se una query non è in esecuzione.
Mostra log eventi PDT Questa opzione ti reindirizza a una pagina di esplorazione di Looker che ti consente di creare query di esplorazione di Looker in base all'attività della tabella derivata per questa connessione. I campi disponibili sono descritti in modo più dettagliato nella pagina della documentazione relativa alle tabelle derivate permanenti.