Impostazioni amministratore - Connessioni

Per accedere alla pagina Connections (Connessioni), apri il menu Admin (Amministrazione) e, in Database, scegli Connections (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. Mostra anche tutte le connessioni gestite da Looker che hai creato, se è stata abilitata la possibilità di creare un nuovo database per la tua istanza. Puoi anche testare lo stato di queste connessioni e modificarne la configurazione 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. Proibire il traffico verso il tuo database, ad eccezione di questi e altri indirizzi IP attendibili, è un modo per limitare l'accesso ai dati.

Nella tabella seguente vengono descritti 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 su 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 per il tuo database. Questa colonna viene visualizzata solo se la scheda Server SSH è abilitata sull'istanza di Looker.
SSL Se utilizzi o meno la crittografia SSL per proteggere i dati che viaggiano tra Looker e il 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: testare una connessione, modifica 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 attivarla, 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 di database aggiuntiva. 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. Ciò causerà un errore di configurazione del tunnel SSH. Per risolvere il problema, configura il database PrestoDB o Trino in modo che rimanga in ascolto su una porta diversa dalla porta 443 quando SSL è abilitato.

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.

Nella tabella seguente sono descritti gli elementi presenti nella scheda 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 di database, si apre la pagina Modifica connessione per quella connessione di database.
Menu Opzioni con tre puntini Azioni che puoi eseguire per la configurazione di un server SSH: testare le connessioni a un server SSH, aggiungere una connessione di 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 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 il file per utilizzarlo in seguito.
  4. Nel campo Nome utente del server, inserisci il nome utente che Looker utilizzerà 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 la connessione al server SSH.
  7. Aggiungi la chiave pubblica scaricata al file delle chiavi autorizzate sul server SSH. Per ulteriori informazioni e per un esempio, consulta la pagina della documentazione Utilizzo di un server SSH.
  8. Assicurati di aggiungere alla lista consentita gli indirizzi IP di Looker sul tuo 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 visualizzare 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.

Test delle connessioni a un server SSH

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

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

Looker testerà tutte le connessioni di database che utilizzano quel server SSH e mostrerà un segno di spunta verde accanto al nome del server e tutte le connessioni in cui viene superato il test di connessione. 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 Opzioni con tre puntini 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 tuo 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; gli errori vengono visualizzati 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.

Sono due i controlli più frequenti che creano confusione:

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

Questi controlli non devono essere superati per il funzionamento di Looker. Tuttavia, è necessario che vengano passate per utilizzare le tabelle derivate permanenti, che sono una funzionalità di modellazione molto utile.

Aggiunta connessioni

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

Modifica delle connessioni

Per modificare una connessione esistente, apri la pagina Connections (Connessioni) selezionando il menu Admin (Amministrazione) e, in Database, scegli Connections (Connessioni). 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 consente di visualizzare un elenco di opzioni di Esplora di base generate automaticamente per la tua connessione. Non si basano su modelli dei dati personalizzati, ma consentono di generare report rapidi sui dati non elaborati nelle tabelle della connessione. In genere questo è utile solo per farsi un'idea dei contenuti del sommario prima della modellazione, non per finalità di analisi dei dati effettiva.
Elimina Per eliminare un collegamento esistente, fai clic sul menu a discesa a forma di ingranaggio all'estrema destra del 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 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 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. Anche se questa opzione inizia 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 rimanda a una pagina di esplorazione di Looker in cui puoi creare query di esplorazione di Looker in base ai metadati della tua 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 rimanda a una pagina di esplorazione di Looker in cui puoi creare query di esplorazione di Looker in base ai processi in esecuzione su questa connessione, lo stato in cui si trovano, da quanto tempo sono in esecuzione e altre informazioni. Questo può essere utile per determinare la causa se Looker è lento o se una query non è in esecuzione.
Mostra log eventi PDT Questa opzione ti consente di accedere a una pagina di esplorazione di Looker in cui puoi 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.