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 del database e gli indirizzi IP necessari per consentire il traffico di rete. Se per l'istanza è stata abilitata la possibilità di creare un nuovo database, 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 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 di indirizzi IP necessari per consentire il traffico di rete dalla tua istanza Looker. Tutto il traffico di rete proveniente da Looker proverrà 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 Looker eseguirà le query 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 | Indipendentemente dal fatto che tu stia utilizzando 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 abilitata la possibilità di creare un nuovo database, puoi anche aggiungere dati da un'origine dati aggiuntiva a qualsiasi connessione gestita da Looker. |
Scheda Server SSH
L'opzione SSH Server è disponibile se il deployment dell'istanza è stato eseguito sull'infrastruttura Kubernetes e solo se è stata abilitata la possibilità di aggiungere informazioni di configurazione del server SSH all'istanza di Looker. Se questa opzione non è abilitata sulla tua istanza di Looker e vuoi abilitarla, contatta un esperto delle vendite di Google Cloud o apri una richiesta di assistenza.
Looker sceglie automaticamente la porta localhost per te quando crei 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 Server SSH elenca le configurazioni del server SSH che hai aggiunto, indica lo stato delle connessioni ai server SSH ed elenca le connessioni di database che utilizzano ciascun server SSH. Nella scheda Server SSH puoi anche testare una connessione a un server SSH e aggiungere o modificare le configurazioni del server SSH.
Nella tabella seguente vengono descritti gli elementi presenti nella scheda Server SSH:
| Colonna | Descrizione |
|---|---|
| Nome server | Il nome della configurazione del server SSH che hai scelto da te, utilizzato per la connessione al tuo database. |
| Connessioni | Un elenco delle connessioni di 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 del database a un server SSH, modificare una configurazione del server SSH o eliminare una configurazione del server SSH. |
Aggiunta o modifica della configurazione di un server SSH
Per aggiungere una nuova configurazione del server SSH:
- Nella scheda Server SSH, fai clic su Aggiungi server.
- Nel campo Server senza nome nell'angolo in alto a destra, inserisci un nome per la configurazione del server SSH.
- Fai clic su Scarica chiave per scaricare la chiave pubblica in un file di testo. Assicurati di salvare il file per utilizzarlo in seguito.
- Nel campo Nome utente del server, inserisci il nome utente che Looker utilizzerà per connettersi al server SSH.
- Nel campo Indirizzo IP o nome host del server, inserisci l'indirizzo IP o il nome host del server SSH.
- Nel campo Porta server, inserisci il numero di porta utilizzato per la connessione al server SSH.
- Aggiungi la chiave pubblica scaricata al file della chiave autorizzata sul server SSH. Per ulteriori informazioni e per un esempio, consulta la pagina della documentazione Utilizzo di un server SSH.
- Assicurati di aggiungere alla lista consentita gli indirizzi IP di Looker sul tuo server SSH in modo che Looker possa connettersi al server SSH.
- Fai clic su Test & Request Fingerprint (Verifica e richiedi l'impronta digitale) per verificare la connessione al server SSH.
- 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 con tre puntini Opzioni nella riga del server SSH selezionato e scegli Dettagli server.
Test delle connessioni a un server SSH
Per testare tutte le connessioni di database a un server SSH:
- Fai clic sul menu Opzioni con tre puntini nella riga del server SSH scelto.
- 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 a tutte le connessioni in cui viene superato il test di connessione. Un'icona rossa con punto esclamativo indica che il test di connessione non è riuscito.
Aggiunta di una connessione di database a un server SSH
Per aggiungere una nuova connessione al database utilizzando un server SSH:
- Fai clic sul menu Opzioni con tre puntini nella riga del server SSH scelto.
- Scegli Aggiungi connessione.
Looker visualizza la pagina Impostazioni di connessione, con il server SSH elencato nel campo Server SSH.
Eliminazione di una configurazione del server SSH in corso...
Per eliminare una configurazione del server SSH:
- Fai clic sul menu Opzioni con tre puntini nella riga del server SSH da eliminare.
- 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 della connessione include un elenco di controlli dello stato per indicare se Looker è in grado di utilizzare correttamente la connessione del database.
I potenziali problemi sono visualizzati in giallo, mentre gli errori sono mostrati in rosso. Se una connessione "viene superata", viene visualizzata in verde.
Le connessioni di database che utilizzano OAuth, come Snowflake e Google BigQuery, richiedono l'accesso 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 Test All Connections (Testa tutte le connessioni) nella parte superiore della pagina.
Sono due i controlli più frequenti che creano confusione:
- Può trovare lo schema temporaneo
- È possibile usare 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. Verrà visualizzata la stessa pagina che utilizzi per creare una connessione (descritta nella pagina della documentazione Collegamento 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
Tutti i collegamenti offrono le seguenti opzioni dal menu a discesa dell'ingranaggio all'estrema destra di ogni connessione:
| Opzione | Descrizione |
|---|---|
| SQL Runner | Questa opzione ti porta 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. Avrai la possibilità di confermare l'eliminazione, ma, una volta effettuata, l'operazione non potrà essere annullata. L'eliminazione accidentale di una connessione disattiverà 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 della connessione, il menu a discesa dell'ingranaggio a destra della connessione potrebbe offrire le seguenti opzioni aggiuntive:
| Opzione | Descrizione |
|---|---|
| Mostra tabelle | Questa opzione ti rimanda a una pagina di esplorazione di Looker in cui puoi creare report di Looker basati sui metadati della tua 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 altro report di Looker. |
| Mostra database | Questa opzione ti rimanda a una pagina di esplorazione di Looker in cui puoi creare report di Looker basati sui metadati della tua connessione. Anche se questa opzione inizia con il nome dello schema, il nome del catalogo, il conteggio delle tabelle e il numero di colonne selezionati, puoi manipolarla come qualsiasi altro report di Looker. |
| Mostra processi | Questa opzione ti consente di accedere a una pagina di esplorazione di Looker che consente di creare report Looker basati sui processi in esecuzione su questa connessione, lo stato in cui si trovano, la durata dell'esecuzione e 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 consente di accedere a una pagina di esplorazione di Looker in cui puoi creare report 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. |