Per accedere alla pagina Connessioni, apri il menu Amministrazione e, nella sezione 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 la possibilità di creare un nuovo database è stata attivata 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 la possibilità di creare un nuovo database è stata attivata per la tua istanza. Puoi anche testare 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 da Looker proviene da uno degli indirizzi IP elencati, in base alla regione in cui è ospitata l'istanza di Looker. Vietare il traffico al tuo database, ad eccezione di questi e 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 di stato sotto il nome della connessione. |
| Database | Il nome del database su cui Looker eseguirà query quando utilizza questa connessione. |
| Ambito | 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 tuo 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 scambiati fra Looker e il tuo database (oltre a SSL, esistono altre opzioni sicure). |
| 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 la possibilità di creare un nuovo database è stata attivata per la tua istanza, puoi anche aggiungere dati da un'origine dati aggiuntiva a qualsiasi connessione gestita da Looker. |
Scheda Server SSH
La scheda Server SSH non è disponibile per le istanze di Looker (Google Cloud core).
L'opzione Server SSH è disponibile se è stato eseguito il deployment di un'istanza di Looker (originale) 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 desideri abilitarla, contatta un Google Cloud esperto del team di vendita o apri una richiesta di assistenza.
Looker sceglie automaticamente la porta localhost per te 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 è impostato per l'ascolto sulla porta 443. Per stabilire il tunnel SSH, Looker deve impostare la porta localhost su 443, che è già in uso. In questo modo, la configurazione del tunnel SSH non riuscirà. Per risolvere il problema, configura il database PrestoDB o Trino in modo che sia 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 al database che utilizzano ciascun server SSH. Dalla scheda Server SSH, puoi anche testare una connessione a un server SSH e aggiungere o modificare le configurazioni del server SSH.
La tabella seguente descrive gli elementi della scheda Server SSH:
| Colonna | Descrizione |
|---|---|
| Nome server | Il nome della configurazione del server SSH, scelto da te, che viene utilizzato per connettersi al tuo 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 con tre puntini Opzioni | Azioni che puoi intraprendere per una configurazione server SSH: testare le connessioni a un server SSH, aggiungere una connessione al database a un server SSH, modificare una configurazione server SSH o eliminare una configurazione server SSH. |
Aggiungere o modificare una configurazione del 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 questo file per un utilizzo futuro.
- Nel campo Nome utente server, inserisci il nome utente che verrà utilizzato da Looker 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 connettersi al server SSH.
- Aggiungi la chiave pubblica scaricata al file delle chiavi autorizzate sul server SSH. Per ulteriori informazioni ed esempi, consulta la pagina della documentazione Utilizzo di un server SSH.
- 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.
- Fai clic su Testa e richiedi impronta 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 server SSH esistente, fai clic sul menu con tre puntini Opzioni nella riga del server SSH selezionato e scegli Dettagli server.
Testare le connessioni a un server SSH
Per testare tutte le connessioni al database a un server SSH:
- Fai clic sul menu con tre puntini Opzioni nella riga del server SSH scelto.
- Scegli Prova 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 viene 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:
- Fai clic sul menu con tre puntini Opzioni nella riga del server SSH scelto.
- Scegli Aggiungi connessione.
Looker visualizza la pagina Impostazioni connessione, con il server SSH elencato nel campo Server SSH.
Eliminare una configurazione del server SSH
Per eliminare una configurazione del server SSH:
- Fai clic sul menu con tre puntini Opzioni 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 di documentazione Connessione di Looker al database.
Ogni test di connessione include un elenco di controlli di stato per indicare se Looker può utilizzare correttamente la connessione al database.
I problemi potenziali vengono visualizzati in giallo, mentre gli errori in rosso. Se una connessione "supera" il test, viene visualizzata in verde.
Le connessioni ai 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 una causa comune di confusione:
- Can find temp schema
- Può utilizzare le tabelle derivate permanenti
Questi controlli non devono essere superati per il funzionamento di Looker. Tuttavia, sono necessari per utilizzare le tabelle derivate persistenti, una funzionalità di modellazione molto utile.
Aggiungere connessioni
Per aggiungere una nuova connessione al database, segui i passaggi descritti nella pagina di documentazione Connessione di Looker al database.
Modifica delle connessioni
Per modificare una connessione esistente, apri la pagina Connessioni selezionando il menu Amministratore e poi, in Database, scegli 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 Connessione di Looker al tuo database), ma con le informazioni pertinenti già compilate. 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 porta a SQL Runner di Looker, con la connessione e lo schema corretti già selezionati. |
| Esplora | Questa opzione ti porta a un elenco di opzioni di esplorazione di base generate automaticamente per la tua connessione. Questi non si basano sui tuoi modelli di dati personalizzati, ma consentono di generare rapidamente alcuni report sui dati non elaborati nelle tabelle della connessione. In genere, questa operazione è utile solo per farsi un'idea dei contenuti della tabella prima della modellazione, anziché per scopi di 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 una volta eseguita, non potrà essere annullata. L'eliminazione accidentale di una connessione disattiverà 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 porta 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 conteggio delle colonne selezionati, puoi manipolarla come qualsiasi altra esplorazione di Looker. |
| Mostra database | Questa opzione ti porta 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 conteggio delle tabelle e il conteggio delle colonne selezionati, puoi manipolarla come qualsiasi altra esplorazione di Looker. |
| Mostra processi | Questa opzione ti porta 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, al loro stato, alla durata di esecuzione e ad altre informazioni. Questa opzione può essere utile per determinare la causa se Looker è lento o se una query non viene eseguita. |
| Mostra log eventi PDT | Questa opzione ti porta 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. |