Impostazioni amministratore - Connessioni

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

Nota: se disponi di un'autorizzazione che fornisce l'accesso solo a determinate pagine del pannello di amministrazione, ad esempio manage_schedules, manage_themes o see_admin, ma non disponi del ruolo di amministratore, la pagina o le pagine descritte qui potrebbero non essere visibili nel pannello di amministrazione.

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 le informazioni di base sulle connessioni al database che hai definito. Mostra anche tutte 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 proveniente da Looker proverrà 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 altri indirizzi IP attendibili, è un modo per limitare l'accesso ai dati.

Nota: il pulsante Indirizzi IP pubblici non è disponibile per le istanze di Looker (Google Cloud core). Se utilizzi un'istanza di Looker (Google Cloud core) configurata per connessioni sicure pubbliche o per connessioni ibride, utilizza l'indirizzo IP elencato nel campo IP pubblico in uscita nella scheda Dettagli della pagina Istanze nella console Google Cloud .

Se hai il ruolo Amministratore, puoi fare clic sul pulsante Testa raggiungibilità nella parte superiore della pagina Connessioni di Looker per verificare se Looker può raggiungere un nome host e una porta sulla rete. Per saperne di più, consulta Diagnostica della connettività di rete.

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à le 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 utilizzato per creare un tunnel SSH al tuo database. Questa colonna viene visualizzata solo se la scheda SSH Servers (Server SSH) è abilitata nella tua istanza di Looker.
SSL	Se utilizzi o meno la crittografia SSL per proteggere i dati scambiati tra Looker e il tuo database (oltre a SSL, esistono altre opzioni di sicurezza).
Tipo	Il dialetto SQL della connessione al database.
Azioni	Azioni che puoi eseguire 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'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 SSH Server (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 esperto di vendita Google Cloud o apri una richiesta di assistenza.

Looker sceglie automaticamente la porta localhost quando crei i 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 sulla porta 443 per impostazione predefinita. Per stabilire il tunnel SSH, Looker deve impostare la porta localhost su 443, che è già in uso da Looker. In questo modo, la configurazione del tunnel SSH non andrà a buon fine. Per risolvere il problema, configura il database PrestoDB o Trino in modo che ascolti 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 ed elenca le connessioni ai 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 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 la connessione al database in questione.
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 eliminarla.

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 Add Server (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 utilizzarlo in un secondo momento.
4. Nel campo Nome utente 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 connettersi 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 tuo server SSH, in modo che Looker possa connettersi al server SSH.
9. Fai clic su Test & Request Fingerprint (Testa e richiedi fingerprint) 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 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:

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

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

Nota: se apporti modifiche al file sshd_config del server SSH, prima di testare la connessione dovrai riavviare il daemon sshd sul server SSH per applicare le modifiche.

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 visualizza la pagina Connection Settings (Impostazioni connessione), con il server SSH elencato nel campo SSH Server (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 mostrati in giallo, mentre gli errori sono mostrati in rosso. Se una connessione "supera" il test, viene visualizzata in verde.

Nota: le connessioni ai database che utilizzano OAuth, come Snowflake e Google BigQuery, richiedono l'accesso dell'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

Due controlli sono causa comune di confusione:

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

Non è necessario che questi controlli vengano superati per il funzionamento di Looker. Tuttavia, è necessario che vengano superati per utilizzare le tabelle derivate permanenti, che sono una funzionalità di modellazione molto utile.

Diagnostica di rete

Looker fornisce due strumenti che ti aiutano a scoprire se un problema di connessione è causato dalla rete, ad esempio una regola firewall o una route mancante, o dal database, ad esempio credenziali errate:

• Diagnostica di rete nei risultati del test di connessione: quando un test di connessione non riesce a connettersi al database, Looker aggiunge la diagnostica di rete al messaggio di errore.
• Diagnostica della connettività di rete: se hai il ruolo di amministratore di Looker, puoi utilizzare il pulsante Testa connettività nella parte superiore della pagina Connessioni di Looker per verificare se Looker può raggiungere qualsiasi nome host e porta.

Entrambi gli strumenti cercano il nome host nel DNS e poi tentano di aprire una connessione TCP a ogni indirizzo IP restituito dalla ricerca. Poiché utilizzano connessioni TCP anziché richieste di ping ICMP, un host che blocca le richieste di ping può comunque risultare raggiungibile.

Diagnostica di rete nei risultati dei test di connessione

Quando un test di connessione non riesce a connettersi al database, Looker testa i seguenti endpoint e aggiunge i risultati alla fine del messaggio di errore, in Network Diagnostics::

• Per tutte le connessioni, l'host e la porta configurati per la connessione.
• Per le connessioni Amazon Athena, l'endpoint AWS Glue per la regione AWS della connessione, sulla porta 443, ad esempio glue.us-east-1.amazonaws.com.
• Per le connessioni Cloud SQL il cui campo Host contiene un nome di connessione dell'istanza, ad esempio my-project:us-central1:my-instance, l'endpoint sqladmin.googleapis.com sulla porta 443. Il connettore Cloud SQL utilizza questo endpoint per ottenere informazioni e certificati dell'istanza.

Looker testa fino a tre indirizzi IP per ogni endpoint e la diagnostica richiede al massimo 3 secondi. Looker non esegue la diagnostica di rete per le connessioni che utilizzano un tunnel SSH.

Ad esempio, la seguente diagnostica mostra che Looker può raggiungere l'endpoint Athena, ma le connessioni all'endpoint AWS Glue scadono:

Network Diagnostics:
- athena.eu-central-1.amazonaws.com (Port: 443):
  - 203.0.113.10 - success
- glue.eu-central-1.amazonaws.com (Port: 443):
  - 203.0.113.20 - timeout (3000ms)
  - 203.0.113.21 - timeout (3000ms)

Ogni indirizzo IP mostra uno dei seguenti risultati:

• success: Looker ha aperto una connessione TCP all'indirizzo IP e alla porta. Se ogni indirizzo IP mostra success, ma il test non va comunque a buon fine, controlla le impostazioni di connessione, ad esempio le credenziali, le impostazioni SSL e le autorizzazioni utente del database.
• timeout (3000ms): Looker non ha ricevuto risposta entro 3 secondi. Questo risultato spesso significa che una regola firewall, un gruppo di sicurezza o una route di rete mancante interrompe il traffico.
• failed: seguito da un motivo: la connessione è stata rifiutata o la rete non era raggiungibile. Ad esempio, Connection refused significa che non è presente alcun elemento in ascolto sulla porta o che un firewall ha rifiutato la connessione.
• blocked (sensitive IP): Looker non ha testato l'indirizzo IP perché si trova in un intervallo limitato.

Se la ricerca DNS non va a buon fine, l'endpoint mostra DNS resolution failed: seguito dal motivo. Controlla che non siano presenti errori ortografici nel nome host. Se il database utilizza un nome host privato, assicurati che Looker possa risolverlo.

Diagnostica della connettività di rete

Se disponi del ruolo di amministratore di Looker, puoi testare un host del database prima di aggiungere una connessione o testare un endpoint da cui dipende una connessione, ad esempio sqladmin.googleapis.com sulla porta 443.

Per testare la connettività di rete, segui questi passaggi:

1. Nella pagina Connessioni, fai clic sul pulsante Testa raggiungibilità nella parte superiore della pagina.
2. Nella finestra di dialogo Diagnostica di connettività di rete, nel campo Nome host o dominio, inserisci un nome host o un indirizzo IP.
3. Nel campo Porta, inserisci la porta da testare. Il valore predefinito è 443.
4. Fai clic su Test.

Looker testa fino a cinque indirizzi IP per il nome host e il test richiede al massimo 3 secondi. Ecco un esempio di finestra di dialogo Diagnostica della connettività di rete che mostra i risultati del test per un nome host e una porta:

Per ogni indirizzo IP, la finestra di dialogo mostra un messaggio, il tempo impiegato per la connessione in millisecondi, se l'operazione è riuscita, e uno dei seguenti stati:

• Connesso: Looker ha aperto una connessione TCP all'indirizzo IP e alla porta.
• Timeout: Looker non ha ricevuto risposta entro 3 secondi.
• Non riuscita: la connessione è stata rifiutata o la rete non era raggiungibile. Il messaggio mostra il motivo.
• SSRF bloccato: Looker non ha testato l'indirizzo IP perché si trova in un intervallo limitato. Queste limitazioni proteggono dalla falsificazione delle richieste lato server (SSRF).

Se Looker non riesce a risolvere il nome host o se la porta è limitata, la finestra di dialogo mostra un messaggio di errore anziché i risultati.

Indirizzi e porte con limitazioni

Per proteggere l'istanza, la diagnostica di rete di Looker non testa gli indirizzi IP nei seguenti intervalli:

• Intervalli di indirizzi di loopback, link-local, multicast e altri indirizzi limitati, incluso l'indirizzo del server dei metadati 169.254.169.254.
• Intervalli di indirizzi privati (10.0.0.0/8, 172.16.0.0/12 e 192.168.0.0/16) su istanze di Looker (Google Cloud core) che utilizzano solo connessioni sicure pubbliche.

Inoltre, la funzione Testa raggiungibilità non testa alcune porte limitate per motivi di sicurezza, ad esempio la porta 22. Se inserisci una di queste porte, la finestra di dialogo mostra un messaggio come Port 22 is restricted from diagnostic probing for security reasons.

Aggiunta di connessioni

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

Modifica delle connessioni

Per modificare una connessione esistente, apri la pagina Connections (Connessioni) selezionando il menu Admin (Amministrazione) e poi, 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 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 indirizza a SQL Runner di Looker, con la connessione e lo schema corretti già selezionati.
Esplora	Questa opzione ti indirizza 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 report sui dati non elaborati nelle tabelle della connessione. In genere, questo è utile solo per farsi un'idea dei contenuti della tabella prima della modellazione, piuttosto che ai fini dell'analisi effettiva dei dati.
Elimina	Per eliminare un collegamento esistente, fai clic sul menu a discesa con l'icona a forma di ingranaggio all'estrema destra di un collegamento e seleziona Elimina. Ti verrà chiesto di confermare l'eliminazione, ma una volta eseguita, l'operazione non può essere annullata. L'eliminazione accidentale di una connessione disabiliterà tutte le query che la utilizzano e può causare errori di convalida di LookML per gli sviluppatori. Tuttavia, se crei 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 con l'icona a forma di ingranaggio a destra della connessione potrebbe offrire le seguenti opzioni aggiuntive:

Opzione	Descrizione
Mostra tabelle	Questa opzione ti indirizza a una pagina di esplorazione di Looker che ti consente di creare query di esplorazione di Looker in base ai metadati della tua connessione. Anche se questa opzione inizia 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 indirizza a una pagina di esplorazione di Looker che ti consente di creare query di esplorazione di Looker in base ai metadati della tua connessione. Anche se questa opzione inizia 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 indirizza a una pagina Esplora 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 loro durata e ad altre informazioni. Questo può essere utile per determinare la causa se Looker è lento o se una query non viene eseguita affatto.
Mostra log eventi PDT	Questa opzione ti indirizza 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.

Eliminazione sicura di una connessione al database

L'eliminazione di una connessione al database a cui fanno ancora riferimento i modelli LookML causa errori di convalida che possono impedire agli sviluppatori di eseguire il commit o il merge dei branch. Per eliminare una connessione in sicurezza, segui questi passaggi:

1. Identifica le dipendenze: in modalità di sviluppo, utilizza la ricerca nei progetti per connection: CONNECTION_NAME per trovare tutti i file dei modelli LookML che fanno riferimento alla connessione.
2. Rimuovi le dipendenze: aggiorna il parametro connection in questi file di modello in modo che rimandi a una connessione valida o elimina i modelli dipendenti se non sono più necessari.
3. Convalida i contenuti: esegui lo strumento di convalida dei contenuti per identificare e correggere eventuali Look o dashboard che si basavano sui modelli che utilizzano la connessione.
4. Esegui il deployment delle modifiche: esegui il commit e il deployment di queste modifiche di LookML nel branch di produzione.
5. Elimina la connessione: una volta rimossi tutti i riferimenti dal branch di produzione, vai ad Amministrazione > Database > Connessioni ed elimina la connessione.