Google BigQuery

Panoramica

Questa pagina spiega come configurare una connessione in Looker a SQL standard di Google BigQuery o a SQL precedente di Google BigQuery.

Di seguito sono riportati i passaggi generali per impostare una connessione SQL standard di Google BigQuery o una connessione SQL precedente di Google BigQuery:

  1. Nel database BigQuery, configura l'autenticazione che Looker utilizzerà per accedere al database BigQuery. Looker supporta le seguenti opzioni di autenticazione per BigQuery:

  2. Nel tuo database BigQuery, se vuoi utilizzare tabelle derivate permanenti (PDT) per la connessione, crea un set di dati temporaneo che Looker possa utilizzare per creare PDT nel tuo database. Per la procedura, consulta la sezione Creare un set di dati temporaneo per le tabelle derivate permanenti in questa pagina.

  3. In Looker, configura la connessione di Looker al tuo database BigQuery. Per la procedura, consulta la sezione Connessione di Looker a BigQuery in questa pagina.

  4. In Looker, testa la connessione tra Looker e il tuo database BigQuery. Per informazioni sulla procedura, consulta la sezione Verifica della connessione in questa pagina.

Crittografia del traffico di rete in corso...

Una best practice consiste nel criptare il traffico di rete tra l'applicazione Looker e il tuo database. Valuta una delle opzioni descritte nella pagina della documentazione Abilitare l'accesso sicuro ai database.

Autenticazione con gli account di servizio BigQuery

Un modo per consentire a Looker di eseguire l'autenticazione nel tuo database BigQuery è utilizzare un account di servizio BigQuery. Crea l'account di servizio nel tuo database BigQuery utilizzando API Manager nella console Google Cloud. Per creare l'account di servizio, devi disporre delle autorizzazioni di amministratore di Google Cloud. Consulta la documentazione sulla creazione di un account di servizio e sulla generazione di una chiave privata.

Creazione di un account di servizio e download del certificato delle credenziali JSON

Per creare un account di servizio BigQuery:

  1. Apri la pagina delle credenziali nel Gestore API della console Google Cloud e seleziona il tuo progetto.

  2. Seleziona CREA CREDENZIALI e scegli Account di servizio.

  3. Inserisci un nome per il nuovo account di servizio, facoltativamente aggiungi una descrizione e seleziona CREA E CONTINUA.

  4. Il tuo account di servizio richiede due ruoli predefiniti di Google BigQuery:

    • BigQuery > BigQuery Data Editor
    • BigQuery > Utente job BigQuery

    Seleziona il primo ruolo nel campo Seleziona un ruolo, seleziona AGGIUNGI UN ALTRO RUOLO e poi seleziona il secondo ruolo.

    Dopo aver selezionato entrambi i ruoli, seleziona CONTINUA, quindi FINE.

  5. Nella pagina Credenziali, seleziona il nuovo account di servizio:

  6. Seleziona KEYS, poi KEYS e poi KEYS nel menu a discesa:

  7. Seleziona JSON in Tipo di chiave, quindi seleziona CREA:

  8. La chiave JSON verrà salvata sul computer.

    Dopo aver annotato il percorso di download, seleziona CHIUDI:

  9. Seleziona FINE.

  10. Trova l'indirizzo email corrispondente all'account di servizio. Per configurare la connessione di Looker a BigQuery, avrai bisogno di questo indirizzo:

  11. Dopo aver creato l'account di servizio nel database BigQuery, inserisci le informazioni dell'account di servizio e i dettagli del file del certificato nei campi Email account di servizio, File JSON/P12 dell'account di servizio e Password della finestra Connessioni di Looker durante la configurazione della connessione di Looker a BigQuery.

Autenticazione con OAuth

Looker supporta OAuth per le connessioni di Google BigQuery, il che significa che ogni utente Looker esegue l'autenticazione in Google con le proprie credenziali Google OAuth e autorizza Looker ad accedere al database.

OAuth consente agli amministratori di database di eseguire le seguenti funzioni:

  • Controlla quali utenti di Looker eseguono query sul database.
  • Applicare i controlli dell'accesso basati sui ruoli utilizzando le autorizzazioni Google.
  • Utilizza i token OAuth per tutte le procedure e le azioni che accedono a Google BigQuery, anziché incorporare ID e password di BigQuery in più posizioni.

Per le connessioni BigQuery con OAuth, tieni presente quanto segue:

  • Se un amministratore di database modifica le credenziali del client OAuth di BigQuery, tutte le pianificazioni o gli avvisi di proprietà di un utente saranno interessati. Gli utenti devono eseguire nuovamente l'accesso se l'amministratore modifica le credenziali OAuth di BigQuery. Gli utenti possono anche andare alla pagina del proprio account Looker dalla pagina del proprio account del profilo utente per accedere a Google.
  • Poiché le connessioni BigQuery che utilizzano OAuth sono "per utente", i criteri di memorizzazione nella cache sono anche per utente, non solo per query. Ciò significa che, anziché utilizzare i risultati memorizzati nella cache ogni volta che viene eseguita la stessa query entro il periodo di memorizzazione nella cache, Looker li utilizzerà solo se lo stesso utente ha eseguito la stessa query entro il periodo di memorizzazione nella cache. Per ulteriori informazioni sulla memorizzazione nella cache, consulta la pagina della documentazione sulle query nella cache.
  • Se vuoi utilizzare tabelle derivate permanenti (PDT) su una connessione BigQuery con OAuth, devi creare un account di servizio aggiuntivo per consentire a Looker di accedere al tuo database per i processi PDT. Per informazioni, consulta la sezione Tabelle derivate permanenti in una connessione BigQuery in questa pagina.
  • Quando eseguono il comando come altro utente, gli amministratori utilizzeranno il token di autorizzazione OAuth di quell'utente. Per informazioni sull'utilizzo del comando sudo, consulta la pagina della documentazione Utenti.

Configurare un progetto di database BigQuery per OAuth

Le sezioni seguenti descrivono come generare le credenziali OAuth e come configurare una schermata per il consenso OAuth.

Nei seguenti casi, non è necessario eseguire queste procedure:

Le credenziali OAuth e la schermata per il consenso OAuth devono essere configurate nella console Google Cloud. La descrizione generica di Google è disponibile sul sito dell'assistenza Google Cloud e sul sito della console Google Dev.

A seconda del tipo di utenti che accedono ai dati BigQuery in Looker e del fatto che i dati BigQuery siano pubblici o privati, OAuth potrebbe non essere il metodo di autenticazione più appropriato. Allo stesso modo, il tipo di dati richiesti all'utente e il grado di accesso necessario ai dati dell'utente durante l'autenticazione in Google per l'utilizzo di Looker potrebbero richiedere la verifica da parte di Google. Per saperne di più sulla verifica, consulta la sezione Generazione delle credenziali OAuth di Google di questa pagina.

Generazione delle credenziali OAuth di Google

  1. Vai alla console Google Cloud.

  2. Nel menu a discesa Seleziona un progetto, vai al tuo progetto BigQuery. Dovresti visualizzare la dashboard del tuo progetto.

  3. Nel menu a sinistra, seleziona la pagina API e servizi. Quindi seleziona Credenziali. Nella pagina Credenziali, seleziona la Freccia giù nel pulsante Crea credenziali e seleziona ID client OAuth dal menu a discesa:

  4. Prima che tu possa generare le tue credenziali OAuth, Google richiede di configurare una schermata per il consenso OAuth, che consente agli utenti di scegliere come concedere l'accesso ai loro dati privati. Per configurare la schermata per il consenso OAuth, consulta la sezione Configurazione di una schermata per il consenso OAuth in questa pagina.

  5. Se hai già configurato una schermata per il consenso OAuth, Google mostra la pagina Crea ID client OAuth, che ti consente di creare un ID client e un secret OAuth da utilizzare nella connessione BigQuery a Looker. Dal menu a discesa Tipo di applicazione, seleziona Applicazione web. La pagina si espanderà e mostrerà ulteriori opzioni:

  6. Nel campo Nome, inserisci un nome per l'app, ad esempio Looker.

  7. Nella sezione Origini JavaScript autorizzate, seleziona + AGGIUNGI URI per visualizzare il campo URI 1. Nel campo URI 1, inserisci l'URL dell'istanza di Looker, incluso https://. Ad esempio:

    • Se la tua istanza è ospitata da Looker: https://<instancename>.looker.com
    • Se hai un'istanza di Looker ospitata dal cliente: https://looker.<mycompany>.com
    • Se la tua istanza Looker richiede un numero di porta: https://looker.<mycompany>.com:9999

  8. Nella sezione URI di reindirizzamento autorizzati, seleziona + AGGIUNGI URI per visualizzare il campo URI 1. Nel campo URI 1, inserisci l'URL dell'istanza di Looker, seguito da /external_oauth/redirect. Ad esempio: https://<instancename>.looker.com/external_oauth/redirect o https://looker.<mycompany>.com:9999/external_oauth/redirect.

  9. Seleziona Crea. Google mostra il tuo ID client e il tuo client secret.

  10. Copia l'ID client e i valori del client secret. Ti serviranno per configurare OAuth per la connessione BigQuery in Looker.

Google richiede di configurare una schermata di consenso OAuth, che consente agli utenti di scegliere come concedere l'accesso ai propri dati privati e fornisce un link ai Termini di servizio e alle Norme sulla privacy della tua organizzazione.

Nel menu a sinistra, seleziona la pagina Schermata del consenso OAuth. Prima di poter configurare la schermata per il consenso OAuth, devi scegliere il tipo di utenti a cui vuoi rendere disponibile l'app. A seconda della selezione, la tua app potrebbe richiedere la verifica da parte di Google.

Effettua la tua selezione e seleziona Crea. Google mostra la pagina Schermata per il consenso OAuth. Puoi configurare questa schermata per tutte le applicazioni del progetto, incluse quelle interne e pubbliche.

Google eseguirà una verifica per le applicazioni pubbliche se una delle seguenti condizioni è vera:

  • L'applicazione utilizza API di Google che utilizzano ambiti con restrizioni o sensibili.
  • La schermata per il consenso OAuth include il logo dell'applicazione.
  • Il progetto ha superato la soglia per il dominio.

Per configurare la schermata per il consenso OAuth:

  1. Nel campo Nome app, inserisci il nome dell'applicazione a cui l'utente concede l'accesso, in questo caso Looker.

  2. Nel campo Email per l'assistenza utenti, inserisci l'email di assistenza che gli utenti devono contattare in caso di problemi di accesso o di consenso.

  3. Seleziona AGGIUNGI DOMINIO per visualizzare il campo Dominio autorizzato 1. In questo campo, inserisci il dominio dell'URL dell'istanza di Looker. Ad esempio, se Looker ospita la tua istanza in https://<instance_name>.cloud.looker.com, il dominio è cloud.looker.com. Per i deployment di Looker ospitati dal cliente, inserisci il dominio in cui ospiti Looker.

  4. Nella sezione Dati di contatto dello sviluppatore, inserisci uno o più indirizzi email che Google possa utilizzare per contattarti in merito al tuo progetto.

    I restanti campi sono facoltativi, ma puoi utilizzarli per personalizzare ulteriormente la schermata per il consenso.

  5. Seleziona SALVA E CONTINUA.

  6. Google visualizza la pagina Ambiti, in cui puoi configurare gli ambiti. Looker richiede solo gli ambiti predefiniti, quindi non è necessaria alcuna configurazione aggiuntiva dell'ambito. Seleziona SALVA E CONTINUA.

  7. Nella pagina Riepilogo, seleziona TORNA ALLA DASHBOARD.

Ora puoi continuare la procedura per la generazione delle credenziali OAuth.

Per ulteriori informazioni sulla configurazione della schermata per il consenso OAuth di Google, consulta la documentazione dell'assistenza di Google.

Configurazione della connessione di Looker per BigQuery con OAuth

Per abilitare OAuth per la tua connessione BigQuery, seleziona l'opzione OAuth nella pagina Connessione di Looker durante la configurazione della connessione di Looker a BigQuery. Quando selezioni l'opzione OAuth, Looker mostra i campi ID client OAuth e Client secret OAuth. Incolla i valori Client ID e Client Secret ottenuti come passaggio nella procedura Generazione delle credenziali OAuth di Google di questa pagina.

Se hai impostato una durata della sessione per OAuth di BigQuery, per evitare i timeout della sessione di Looker dovrai utilizzare la funzionalità Escludi app attendibili per aggiungere Looker alle app attendibili. Consulta l'articolo del Centro assistenza Impostare la durata della sessione per i servizi Google Cloud per visualizzare i passaggi per questa procedura.

In che modo gli utenti di Looker effettuano l'autenticazione in BigQuery con OAuth

Dopo aver configurato la connessione di Looker a BigQuery per OAuth, gli utenti possono utilizzare Looker per eseguire l'autenticazione iniziale nel tuo database BigQuery effettuando una delle seguenti operazioni:

Autenticazione in Google da una query

Una volta configurata la connessione di Looker a BigQuery per OAuth, Looker richiederà agli utenti di accedere con il proprio Account Google prima di eseguire query che utilizzano la connessione BigQuery. Looker mostra questo prompt da esplorazioni, dashboard, Look e SQL Runner.

L'utente deve selezionare Accedi ed eseguire l'autenticazione con OAuth. Dopo aver eseguito l'autenticazione in BigQuery, l'utente può selezionare il pulsante Esegui nell'esplorazione e Looker caricherà i dati nell'esplorazione.

Autenticazione in Google dalla pagina dell'account utente

Dopo aver configurato la connessione di Looker a BigQuery per OAuth, un utente può eseguire l'autenticazione nel proprio Account Google dalla pagina dell'account utente di Looker:

  1. In Looker, seleziona l'icona del profilo e seleziona Account dal menu utente.
  2. Vai alla sezione Credenziali di connessione OAuth e seleziona il pulsante Accedi per la connessione al database BigQuery appropriata.
  3. Seleziona l'account appropriato dalla pagina Accedi con Google.
  4. Seleziona Consenti nella schermata per il consenso OAuth per consentire a Looker di visualizzare e gestire i tuoi dati in Google BigQuery.

Dopo aver eseguito l'autenticazione a Google tramite Looker, puoi disconnettere o autorizzare di nuovo le tue credenziali in qualsiasi momento dalla pagina Account, come descritto nella pagina della documentazione Personalizzazione dell'account utente. Anche se i token di Google BigQuery non hanno scadenza, un utente può selezionare Riautorizza per accedere con un altro Account Google.

Revoca dei token OAuth

Gli utenti possono revocare l'accesso all'Account Google da applicazioni come Looker tramite le impostazioni dell'Account Google.

I token Google BigQuery non scadono; tuttavia, se un amministratore del database modifica le credenziali OAuth della connessione al database in modo da invalidare quelle esistenti, gli utenti dovranno accedere di nuovo con il proprio Account Google prima di eseguire query che utilizzano la connessione.

Tabelle derivate permanenti su una connessione BigQuery

Se vuoi utilizzare tabelle derivate permanenti (PDT) per la connessione BigQuery, potrebbe essere necessario eseguire queste operazioni, a seconda della configurazione della connessione:

  • Utilizza la console Google Cloud per creare un set di dati temporaneo nel database BigQuery che Looker possa utilizzare per scrivere le PDT. Per la procedura, consulta la sezione Creare un set di dati temporaneo per le tabelle derivate permanenti in questa pagina. Questo passaggio è obbligatorio per le PDT, indipendentemente dalle altre opzioni di configurazione della connessione.
  • Utilizza il gestore API nella console Google Cloud per creare un account di servizio separato per i processi PDT di Looker. Per la procedura, consulta la sezione Creare un account di servizio e scaricare il certificato delle credenziali JSON in questa pagina. Il tipo di autenticazione sulla connessione determina se è necessario un account di servizio PDT, nonché dove devi inserire le informazioni dell'account di servizio PDT nella finestra Connessioni di Looker quando configuri la connessione di Looker a BigQuery:
    • Se la connessione utilizza OAuth per l'autenticazione degli utenti, devi creare un account di servizio separato per i processi PDT. Inserirai le informazioni dell'account di servizio e i dettagli del file del certificato nella sezione PDT Overrides (Override PPD) della finestra Connections (Connessioni) di Looker. La finestra Connessioni di Looker mostra automaticamente la sezione Override PPD quando attivi l'opzione Abilita PDT per una connessione configurata anche con l'opzione OAuth nel campo Autenticazione. Per saperne di più, consulta la sezione Abilitare le PDT per le connessioni di Looker a BigQuery con OAuth.
    • Se la connessione utilizza account di servizio per l'autenticazione degli utenti, puoi scegliere di creare un account di servizio separato per i processi PDT. Se scegli di avere un account di servizio PDT separato, inserirai le informazioni dell'account di servizio nella sezione PDT Overrides (Override PPD) per i campi Service Account Email (Email account di servizio), Service Account JSON/P12 File (File JSON/P12 dell'account di servizio) e Password della finestra Connections (Connessioni) di Looker. La sezione Sostituzioni PDT viene visualizzata quando attivi l'opzione di attivazione/disattivazione Attiva i PDT per una connessione di Looker a BigQuery che utilizza l'autenticazione dell'account di servizio.

Creazione di un set di dati temporaneo per le tabelle derivate permanenti

Per abilitare le tabelle derivate permanenti (PDT) per la connessione a BigQuery, attiva l'opzione Abilita PDT nella pagina Connessione di Looker quando configuri la connessione di Looker a BigQuery. Quando abiliti le PDT, Looker visualizza il campo Set di dati temporaneo. In questo campo, inserisci il nome del set di dati che Looker può utilizzare per creare le PDT. Il database o lo schema deve essere configurato preventivamente, con le autorizzazioni di scrittura adeguate.

Puoi configurare un set di dati temporaneo utilizzando la console Google Cloud:

  1. Apri la console Google Cloud e seleziona il tuo progetto.

  2. Seleziona il menu con tre puntini e poi Crea set di dati.

  3. Inserisci un ID set di dati (in genere looker_scratch), quindi seleziona Località dei dati (facoltativo), Scadenza tabella predefinita e soluzione di gestione delle chiavi di crittografia. Seleziona CREA SET DI DATI per terminare.

Ora che hai creato il set di dati, puoi specificare il nome del set di dati nel campo Set di dati temporaneo della finestra Connessioni di Looker quando configuri la connessione di Looker a BigQuery.

Attivazione dei token di accesso a pagina pubblica per le connessioni di Looker a BigQuery con OAuth

Per le connessioni BigQuery che utilizzano OAuth, i tuoi utenti eseguono l'autenticazione in Looker con le proprie credenziali OAuth. Looker supporta le PDT per le connessioni BigQuery con OAuth, ma Looker non può utilizzare OAuth, quindi devi configurare un account di servizio BigQuery specifico per consentire a Looker di accedere al tuo database per i processi PDT.

Puoi configurare un account di servizio PDT sul tuo database BigQuery utilizzando Google Cloud API Manager. Consulta la sezione Creazione di un account di servizio e download del certificato delle credenziali JSON in questa pagina.

Dopo aver creato l'account di servizio nel database BigQuery, inserisci le informazioni dell'account di servizio e i dettagli del file del certificato nella sezione Override PPD della finestra Connessioni di Looker quando configuri la connessione di Looker a BigQuery. La finestra Connessioni di Looker mostra automaticamente la sezione Sostituzioni PDT quando attivi l'opzione di attivazione/disattivazione Attiva PDT per una connessione configurata anche con l'opzione OAuth nel campo Autenticazione. Utilizza i seguenti campi nella sezione Sostituzioni PDT per inserire le informazioni relative all'account di servizio che Looker può utilizzare per i processi PDT nel tuo database:

  • Carica p12 o json: utilizza il pulsante Carica file per caricare il file del certificato per l'account di servizio BigQuery che vuoi utilizzare per i processi PDT sulla connessione. Puoi recuperare questo file dal gestore API di Google Cloud come passaggio nella procedura Creazione di un account di servizio e download del certificato delle credenziali JSON.
  • : questo campo si applica solo se carichi un file P12 nel campo Carica p12 o json della sezione Override P12. Inserisci l'indirizzo email dell'account di servizio BigQuery che vuoi utilizzare per i processi PDT nella connessione. Puoi recuperare questo indirizzo email dal gestore API di Google Cloud come passaggio nella procedura Creazione di un account di servizio e download del certificato delle credenziali JSON.
  • Password: questo campo si applica solo se carichi un file P12 nel campo Carica p12 o json della sezione Override P12. Inserisci la password nel file delle credenziali .p12 dell'account di servizio BigQuery che vuoi utilizzare per i processi PDT nella connessione.

Connessione di Looker a BigQuery

Nella sezione Amministrazione di Looker, seleziona Connessioni per aprire la pagina Connessioni, quindi esegui una delle seguenti operazioni:

  • Per creare una nuova connessione, seleziona il pulsante Aggiungi connessione.
  • Per modificare una connessione esistente, individua la connessione nella tabella Database e seleziona il pulsante Modifica nell'elenco della connessione.

Compila i dettagli della connessione. La maggior parte di queste impostazioni è comune alla maggior parte dei dialetti di database e sono descritte nella pagina della documentazione Connessione di Looker al tuo database. Le seguenti impostazioni vengono menzionate per evidenziarle o per chiarire in che modo si applicano specificamente alle connessioni BigQuery:

  • Dialetto: seleziona SQL standard di Google BigQuery o SQL precedente di Google BigQuery.

  • ID progetto di fatturazione: il nome del progetto di fatturazione Google Cloud. Il progetto di fatturazione è il progetto Google Cloud per cui viene addebitata la fattura, ma puoi comunque eseguire query sui set di dati in un altro progetto Google Cloud se gli sviluppatori LookML specificano i nomi delle tabelle con ambito completo nel parametro sql_table_name delle visualizzazioni, delle esplorazioni o delle unioni di LookML. Per BigQuery, il nome di una tabella con ambito completo utilizza il formato <project_name>.<dataset_name>.<table_name>. Senza un riferimento con ambito completo, BigQuery cerca la tabella nel progetto di fatturazione e nel set di dati specificati nella pagina Connessioni di Looker per la connessione BigQuery a Looker. Consulta la documentazione di BigQuery per una spiegazione della gerarchia delle risorse in BigQuery.

  • il nome del set di dati da utilizzare come predefinito da Looker quando esegue query sul database. Il set di dati predefinito deve trovarsi all'interno del progetto di fatturazione specificato per la connessione. non puoi inserire un valore come project_name.dataset_name nel campo Database per specificare un set di dati in un progetto diverso.

    Il tuo progetto LookML può accedere alle tabelle in altri set di dati (incluse le tabelle in set di dati pubblici) se gli sviluppatori LookML specificano nomi delle tabelle con ambito completo nel parametro sql_table_name delle viste, delle esplorazioni o dei join LookML. Per BigQuery, il nome di una tabella con ambito completo utilizza il formato <project_name>.<dataset_name>.<table_name>. Per eseguire una query su una tabella in un altro set di dati, la tabella deve essere accessibile dall'account di servizio (per le connessioni che utilizzano l'autenticazione dell'account di servizio) o dall'utente che esegue la query (per le connessioni che utilizzano l'autenticazione OAuth). Se il codice LookML non specifica nomi delle tabelle con ambito completo, BigQuery cercherà la tabella nel set di dati specificato nel campo Set di dati della connessione BigQuery.

    Se il progetto non ha set di dati (come accade se si separano elaborazione e archiviazione in progetti separati), puoi fornire un valore Dataset arbitrario, ma devi sempre utilizzare nomi delle tabelle con ambito completo in LookML.

  • : il tipo di autenticazione che Looker utilizzerà per accedere al tuo database. Alcune di queste opzioni sono supportate solo per le istanze Looker (Google Cloud core):

  • Abilita le PDT: abilita questa opzione per consentire le tabelle derivate permanenti (PDT) nella connessione. Dovrai specificare il set di dati temporaneo nel tuo database che verrà utilizzato da Looker per scrivere i report PDT. Per informazioni sulla procedura, consulta la sezione Creazione di un set di dati temporaneo per le tabelle derivate permanenti in questa pagina. Nota: se la connessione è configurata per OAuth, devi utilizzare la sezione Override PdT per specificare un account di servizio che Looker possa utilizzare per i processi PDT sulla tua connessione BigQuery. Per maggiori dettagli, consulta la sezione Abilitare i token di accesso a livello di progetto per le connessioni di Looker a BigQuery con OAuth.

  • Set di dati temporaneo: il set di dati BigQuery che hai creato nella console Google Cloud per consentire a Looker di scrivere tabelle derivate permanenti nel tuo database. Per la procedura, consulta la sezione Creazione di un set di dati temporaneo per le tabelle derivate permanenti.

  • Database Time Zone: il fuso orario predefinito per BigQuery è UTC. L'impostazione del fuso orario qui specificata deve corrispondere all'impostazione del fuso orario di BigQuery. Per ulteriori informazioni, consulta la sezione Fuso orario database della pagina Connessione di Looker al tuo database.

  • Fuso orario delle query: per ulteriori informazioni, consulta la sezione Fuso orario delle query della pagina Connessione di Looker al tuo database.

  • Parametri JDBC aggiuntivi: aggiungi eventuali parametri JDBC, ad esempio le etichette BigQuery (per ulteriori informazioni, consulta la sezione Etichette dei job e commenti contestuali per le connessioni BigQuery in questa pagina). Di seguito sono riportati alcuni degli altri parametri supportati:

    • connectTimeout: numero di millisecondi da attendere per una connessione. Il valore predefinito è 240.000.
    • readTimeout: numero di millisecondi di attesa di una lettura. Il valore predefinito è 240000.
    • rootUrl: se hai un'istanza BigQuery in una rete privata, specifica un endpoint alternativo per connetterti a BigQuery diverso da quello pubblico predefinito.

  • Numero massimo di gigabyte di fatturazione: per le connessioni BigQuery ti viene addebitata ogni query in base alle dimensioni. Per evitare che gli utenti eseguano accidentalmente una query troppo costosa, puoi impostare un numero massimo di gigabyte che un utente può estrarre in una singola query. Puoi lasciare vuoto il campo Numero massimo di gigabyte di fatturazione se non limiti le dimensioni delle query. Scopri di più sui prezzi nella pagina dei prezzi di BigQuery.

  • Numero massimo di connessioni per nodo: inizialmente può essere lasciato sul valore predefinito. Per saperne di più su questa impostazione, consulta la sezione Numero massimo di connessioni per nodo della pagina della documentazione Collegamento di Looker al tuo database.

  • Timeout del pool di connessioni: inizialmente può essere lasciato sul valore predefinito. Per saperne di più su questa impostazione, consulta la sezione Timeout del pool di connessioni della pagina della documentazione Connessione di Looker al tuo database.

  • Disattiva contesto: questa opzione disattiva i commenti di contesto su una connessione BigQuery. I commenti relativi al contesto sulle connessioni a Google BigQuery sono disattivati per impostazione predefinita perché non consentono a Google BigQuery di memorizzare i dati nella cache e possono influire negativamente sulle prestazioni della cache. Puoi attivare i commenti contestuali per una connessione BigQuery disattivando l'opzione Disattiva contesto. Per saperne di più, consulta la sezione Etichette dei job e commenti sul contesto per le connessioni BigQuery.

  • Pre-cache SQL Runner: se non vuoi che SQL Runner precarichi le informazioni sulle tabelle, ma preferisci che le carichi solo quando una tabella è selezionata, deseleziona questa opzione. Per saperne di più, consulta la sezione SQL Runner Precache (Precache di SQL Runner) nella pagina Connessione di Looker al tuo database.

Dopo aver compilato tutti i campi applicabili per la connessione, puoi testare la connessione, se necessario.

Per salvare queste impostazioni, fai clic su Connetti.

Test della connessione

Puoi testare le impostazioni di connessione da un paio di punti nell'interfaccia utente di Looker:

  • Seleziona il pulsante Test (Test) nella parte inferiore della pagina Connections Settings (Impostazioni delle connessioni), come descritto nella pagina della documentazione Connessione di Looker al tuo database.
  • Seleziona il pulsante Test (Test) nell'elenco della connessione nella pagina di amministrazione Connections (Connessioni), come descritto nella pagina della documentazione Connessioni.

Per le nuove connessioni, se in Looker viene visualizzato Può connettersi, seleziona Aggiungi connessione. Looker eseguirà gli altri test della connessione per verificare che l'account di servizio sia stato configurato correttamente e con i ruoli appropriati.

Test di una connessione che utilizza OAuth

  1. In Looker, vai alla modalità di sviluppo.
  2. Per una connessione BigQuery esistente che utilizza OAuth, vai ai file di progetto di un progetto Looker che utilizza la tua connessione BigQuery. Per le nuove connessioni BigQuery che utilizzano OAuth, apri un file modello e sostituisci il valore connection del modello con il nome della nuova connessione BigQuery, quindi salva il file modello.
  3. Apri una delle esplorazioni o delle dashboard del modello ed esegui una query. Quando provi a eseguire una query, Looker ti chiederà di accedere con il tuo Account Google. Segui le istruzioni di accesso a Google OAuth.

Etichette dei job e commenti sul contesto per le connessioni BigQuery

Per le connessioni BigQuery, Looker invia il contesto della query sotto forma di etichette del job BigQuery. Per impostazione predefinita, Looker invia le seguenti chiavi di etichetta del contesto per le connessioni BigQuery:

  • looker-context-user_id: l'identificatore univoco per ciascun utente nell'istanza di Looker. Puoi abbinare questo ID utente agli ID utente nella pagina Utenti del menu Amministrazione.

  • looker-context-history_slug: identificatore univoco di ogni query eseguita sul database dall'istanza di Looker.

  • looker-context-instance_slug: il numero ID dell'istanza di Looker che ha eseguito la query. Se necessario, l'assistenza Looker può utilizzare queste informazioni ai fini della risoluzione dei problemi.

Puoi configurare etichette di job aggiuntive che Looker invia con ogni query sulla connessione BigQuery utilizzando il campo di testo Parametri JDBC aggiuntivi della pagina Connessioni. Nel campo Parametri JDBC aggiuntivi, aggiungi un parametro JDBC aggiuntivo, labels, e fornisci un elenco separato da virgole di coppie key=value con URL codificati. Ad esempio, se includi questo parametro nel campo Parametri JDBC aggiuntivi:

labels=this%3Dconnection-label,that%3Danother-connection-label

%3D è la codifica URL per =, quindi verranno aggiunte le due etichette seguenti a ogni query inviata da Looker al database BigQuery, oltre alle etichette di contesto predefinite di Looker:

  • this: connection-label
  • that: another-connection-label

Tieni presente che BigQuery ha limitazioni per le etichette dei job:

  • Qualsiasi etichetta di connessione che ha la stessa chiave di un'etichetta di contesto verrà ignorata.
  • Se l'unione di etichette di connessione ed etichette di contesto supera il limite massimo di 64 etichette totali, queste ultime sono le prime a essere eliminate, seguite dalle etichette di connessione, fino a raggiungere un massimo di 64.

Looker garantisce che le etichette di contesto siano conformi a tutti i requisiti di validità delle etichette di BigQuery, ma non controlla la validità delle etichette di connessione. La configurazione di etichette di connessione non valide può causare la mancata riuscita delle query.

Le etichette dei job BigQuery inviate da Looker per impostazione predefinita (looker-context-user_id, looker-context-history_id e looker-context-instance_slug) corrispondono ai commenti contestuali SQL che Looker associa alle query SQL per i dialetti di database diversi da BigQuery. Per le connessioni a BigQuery, i commenti relativi al contesto sono disabilitati per impostazione predefinita perché invalidano la capacità di BigQuery di utilizzare la cache e possono influire negativamente sulle prestazioni della cache. Puoi attivare i commenti contestuali per una connessione BigQuery disattivando l'opzione Disabilita il contesto per la connessione BigQuery. Ti consigliamo di mantenere l'impostazione predefinita per Disabilita commenti contestuali, in modo da poter utilizzare la cache di BigQuery. Tuttavia, se deselezioni l'opzione Disabilita commento contestuale per una connessione BigQuery, Looker invierà i commenti contestuali SQL e le etichette dei job BigQuery al tuo database.

I commenti contestuali SQL e le etichette dei job BigQuery trasmettono le stesse informazioni. Ad esempio, Looker potrebbe generare i seguenti commenti contestuali SQL per una query:

-- Looker Query Context

'{"user_id":1,"history_id":4757,"instance_slug":"ec2804ddef74c466f2a43e0afaa3ff6b"}'

Looker genererà le seguenti etichette dei job BigQuery per la stessa query:

[{"value":"1","key":"looker-context-user_id"},

 {"value":"4757","key":"looker-context-history_id"},

 {"value":"ec2804ddef74c466f2a43e0afaa3ff6b","key":"looker-context-instance_slug"}]

Funzionalità supportate

Affinché Looker supporti alcune funzionalità, è necessario che anche il dialetto del tuo database le supporti.

SQL standard di Google BigQuery

A partire da Looker 24.14, l'SQL standard di Google BigQuery supporta le seguenti funzionalità:

Funzionalità Supportata?
Livello di assistenza
Supportato
Looker (Google Cloud core)
Sì
Aggregati simmetrici
Sì
Tabelle derivate
Sì
Tabelle derivate da SQL permanente
Sì
Tabelle derivate native permanenti
Sì
Viste stabili
Sì
Termine query
Sì
Pivot basati su SQL
Sì
Fusi orari
Sì
SSL
Sì
Subtotali
Sì
Parametri aggiuntivi JDBC
Sì
Sensibilità alle maiuscole
Sì
Tipo di località
Sì
Tipo di elenco
Sì
Percentile
Sì
Percentile distinto
Sì
Processi di visualizzazione di SQL Runner
No
Tabella di descrizione di SQL Runner
No
SQL Runner Mostra indici
No
Selezione SQL Runner 10
Sì
Conteggio runner SQL
Sì
SQL Explain
No
Credenziali OAuth
Sì
Commenti contestuali
Sì
Pooling di connessioni
No
Schizzi HLL
Sì
Consapevolezza aggregata
Sì
PDT incrementali
Sì
Millisecondi
Sì
Microsecondi
Sì
Viste materializzate
Sì
Conteggio approssimato distinto
Sì

SQL precedente di Google BigQuery

SQL legacy di Google BigQuery supporta le seguenti funzionalità a partire da Looker 24.14:

Funzionalità Supportata?
Livello di assistenza
Supportato
Looker (Google Cloud core)
No
Aggregati simmetrici
Sì
Tabelle derivate
Sì
Tabelle derivate da SQL permanente
Sì
Tabelle derivate native permanenti
Sì
Viste stabili
No
Termine query
Sì
Pivot basati su SQL
Sì
Fusi orari
No
SSL
Sì
Subtotali
No
Parametri aggiuntivi JDBC
Sì
Sensibilità alle maiuscole
Sì
Tipo di località
Sì
Tipo di elenco
Sì
Percentile
Sì
Percentile distinto
Sì
Processi di visualizzazione di SQL Runner
No
Tabella di descrizione di SQL Runner
No
SQL Runner Mostra indici
No
Selezione SQL Runner 10
Sì
Conteggio runner SQL
Sì
SQL Explain
No
Credenziali OAuth
Sì
Commenti contestuali
Sì
Pooling di connessioni
No
Schizzi HLL
No
Consapevolezza aggregata
Sì
PDT incrementali
No
Millisecondi
Sì
Microsecondi
Sì
Viste materializzate
No
Conteggio approssimato distinto
Sì

Passaggi successivi

Dopo aver collegato il database a Looker, configura le opzioni di accesso per gli utenti.