Per accedere alla pagina Connessioni, apri il menu Amministratore e, in Database, scegli Connessioni.
Visualizzare le 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 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 al database che hai definito. Mostra anche le connessioni gestite da Looker che hai creato, se per la tua istanza è stata abilitata la possibilità di creare un nuovo database. Dalla scheda Database puoi anche testare lo stato e modificare la configurazione di queste connessioni.
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 visualizza l'elenco dei controlli di stato sotto il nome della connessione. |
| Database | Il nome del database su cui Looker eseguirà query quando utilizzerà 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 tuo database. Questa colonna viene visualizzata solo se nella tua istanza di Looker è abilitata la scheda Server SSH. |
| SSL | Indica se utilizzi o meno la crittografia SSL per proteggere i dati scambiati tra Looker e il tuo database (esistono altre opzioni sicure oltre a SSL). |
| Tipo | Il dialetto SQL della connessione al database. |
| Azioni | Le 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 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
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 uno Google Cloud specialista delle vendite o apri una richiesta di assistenza.
Quando crei tunnel SSH, Looker sceglie automaticamente la porta localhost. 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 da Looker. Di conseguenza, la configurazione del tunnel SSH non andrà a buon fine. Per correggere il problema, configura il database PrestoDB o Trino in modo che ascolti 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, utilizzato per connetterti 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 al database. |
| Menu con tre puntini Opzioni menu | Le azioni che puoi intraprendere 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. |
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 dovrà essere 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 da utilizzare per la connessione al server SSH.
- Aggiungi la chiave pubblica scaricata al file delle chiavi autorizzate sul server SSH. Per ulteriori informazioni e un esempio, consulta la pagina della documentazione Utilizzare 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 del 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 Testa connessioni.
Looker testerà tutte le connessioni al database utilizzando quel server SSH e visualizzerà un segno di spunta verde accanto al nome del server e a tutte le connessioni in cui il test di connessione è riuscito. Un'icona rossa con punto esclamativo indica che la connessione non ha superato il test.
Aggiungere 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.
Testare le connessioni
Looker ti consente di testare le connessioni esistenti per assicurarti che funzionino correttamente. Puoi anche testare le connessioni mentre le aggiungi, come descritto nella pagina della documentazione Connettere Looker al tuo database.
Ogni test di connessione include un elenco di controlli di stato per indicare se Looker può utilizzare correttamente la connessione al database.
I potenziali problemi vengono visualizzati in giallo, mentre gli errori in rosso. Se una connessione "supera" il test, 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 alle informazioni del tuo account OAuth.
Puoi controllare lo stato di:
- Una singola connessione facendo clic su Testa 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 causa di confusione:
- Can find temp schema (Riesce a trovare lo schema temporaneo)
- Can use persistent derived tables (Può utilizzare le tabelle derivate permanenti)
Questi controlli non devono essere superati affinché Looker funzioni. Tuttavia, devi superarli 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 Connettere Looker al tuo database.
Modificare le 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 Connettere 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. Queste non si basano sui modelli di dati personalizzati, ma consentono di generare rapidamente report sui dati non elaborati nelle tabelle della connessione. In genere, questa opzione è utile solo per farsi un'idea dei contenuti delle tabelle prima della modellazione, anziché per l'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 della 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 tua 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 tua 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, allo stato in cui si trovano, al tempo di 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 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. |