Google BigQuery

Panoramica

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

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

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

  2. Nel tuo database BigQuery, se vuoi utilizzare tabelle derivate permanenti (PDT) nella connessione, crea un set di dati temporaneo che Looker possa utilizzare per creare PDT sul tuo database. Per la procedura, consulta la sezione Creazione di un set di dati temporaneo per 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, verifica la connessione tra Looker e il tuo database BigQuery. Per la procedura, consulta la sezione Test della connessione in questa pagina.

Crittografia del traffico di rete

Una delle 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 Abilitazione dell'accesso sicuro al database.

Autenticazione con gli account di servizio BigQuery

Un modo in cui Looker può autenticarsi nel tuo database BigQuery è tramite un account di servizio BigQuery. Puoi creare l'account di servizio nel database BigQuery utilizzando il gestore API nella console Google Cloud. Devi disporre delle autorizzazioni di amministratore di Google Cloud per creare l'account di servizio. 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 nella 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, aggiungi eventualmente una descrizione e seleziona CREA E CONTINUA.

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

    • BigQuery > Editor dati BigQuery
    • BigQuery > Utente job BigQuery

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

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

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

  6. Seleziona CHIAVE, quindi seleziona AGGIUNGI CHIAVE e, nel menu a discesa, seleziona Crea nuova chiave:

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

  8. La chiave JSON verrà salvata sul tuo computer.

    Dopo aver annotato il percorso di download, seleziona CHIUDI:

  9. Seleziona FINE.

  10. Trova l'indirizzo email che corrisponde 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, inserirai le informazioni di questo account di servizio e i dettagli del file del certificato nei campi Email dell'account di servizio, File JSON/P12 dell'account di servizio e Password della finestra Connessioni di Looker quando configuri la connessione di Looker a BigQuery.

Autenticazione con OAuth

Looker supporta OAuth per le connessioni Google BigQuery, ovvero ogni utente Looker si autentica 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.
  • Applica i controlli dell'accesso basati sui ruoli utilizzando le autorizzazioni Google.
  • Utilizza i token OAuth per tutti i processi e le azioni che accedono a Google BigQuery, invece di incorporare gli ID e le password BigQuery in più posizioni.

Tieni presente quanto segue per le connessioni BigQuery con OAuth:

  • Se un amministratore di database modifica le credenziali del client OAuth di BigQuery, questa operazione influirà su eventuali pianificazioni o avvisi di proprietà di un utente. Gli utenti devono accedere di nuovo se il loro amministratore modifica le credenziali OAuth di BigQuery. Gli utenti possono anche andare alla pagina Account Looker dalla pagina dell'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 validi anche per utente e non solo per query. Ciò significa che, invece di utilizzare i risultati memorizzati nella cache ogni volta che la stessa query viene eseguita nel periodo di memorizzazione nella cache, Looker utilizzerà i risultati memorizzati nella cache solo se lo stesso utente ha eseguito la stessa query durante il periodo di memorizzazione nella cache. Per ulteriori informazioni sulla memorizzazione nella cache, consulta la pagina della documentazione relativa alla memorizzazione delle 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 su una connessione BigQuery in questa pagina.
  • Gli amministratori, quando eseguono il comando sudo come un altro utente, utilizzeranno il token di autorizzazione OAuth di quell'utente. Per informazioni sull'utilizzo del comando sudo, consulta la pagina della documentazione relativa agli utenti.

Configurazione di un progetto di database BigQuery per OAuth

Le seguenti sezioni descrivono come generare le credenziali OAuth e configurare una schermata per il consenso OAuth. Se hai già configurato una schermata per il consenso OAuth per un'altra applicazione nel tuo progetto, non devi crearne un'altra: devi configurare una sola schermata per il consenso per tutte le applicazioni di un progetto.

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

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

Generazione di credenziali Google OAuth

  1. Vai alla console Google Cloud.

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

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

  4. Prima di poter generare le credenziali OAuth, Google richiede di configurare una schermata per il consenso OAuth, che consente agli utenti di scegliere come concedere l'accesso ai propri dati privati. Per configurare la schermata per il consenso OAuth, consulta la sezione Configurare 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 OAuth e un secret da utilizzare nella connessione BigQuery a Looker. Dal menu a discesa Tipo di applicazione, seleziona Applicazione web. La pagina si espanderà e mostrerà opzioni aggiuntive:

  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 Looker, incluso https://. Ad esempio:

    • Se Looker ospita la tua istanza: https://<instancename>.looker.com
    • Se hai un'istanza Looker ospitata dal cliente: https://looker.<mycompany>.com
    • Se la tua istanza di 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 i valori dell'ID client e del client secret. Ti serviranno per configurare il protocollo OAuth per la connessione BigQuery in Looker.

Google richiede di configurare una schermata per il 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 consenso OAuth. Prima di poter configurare la schermata per il consenso OAuth, devi scegliere il tipo di utenti a cui rendere disponibile l'app. A seconda della selezione, l'app potrebbe richiedere la verifica da parte di Google.

Effettua una selezione e scegli Crea. Google mostra la pagina Schermata consenso OAuth. Puoi configurare questa schermata per tutte le applicazioni del tuo 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 del 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 dell'assistenza utenti, inserisci l'email dell'assistenza che gli utenti devono contattare per 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 all'indirizzo 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 campi rimanenti 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 con la procedura per generare le credenziali OAuth.

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

Configurare la connessione di Looker per BigQuery con OAuth

Per attivare OAuth per la connessione BigQuery, seleziona l'opzione OAuth nella pagina Connessione di Looker quando configuri la connessione di Looker a BigQuery. Quando attivi 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 della procedura Generazione di credenziali OAuth di Google in questa pagina.

In che modo gli utenti di Looker eseguono 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 database BigQuery eseguendo una delle seguenti operazioni:

Autenticazione su Google da una query

Dopo aver configurato la connessione di Looker a BigQuery per OAuth, Looker chiederà 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 e autenticarsi con OAuth. Dopo l'autenticazione in BigQuery, può selezionare il pulsante Esegui nell'esplorazione e Looker caricherà i dati nell'esplorazione.

Autenticazione su Google dalla pagina dell'account utente

Una volta configurata la connessione di Looker a BigQuery per OAuth, un utente può autenticarsi nel proprio Account Google dalla pagina dell'account utente di Looker:

  1. In Looker, seleziona l'icona del profilo e scegli Account dal menu degli utenti.
  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 nella 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 effettuato l'autenticazione a Google tramite Looker, puoi uscire o autorizzare nuovamente le tue credenziali in qualsiasi momento tramite la pagina Account, come descritto nella pagina della documentazione Personalizzazione dell'account utente. Anche se i token di Google BigQuery non scadono, un utente può selezionare Autorizza di nuovo ad accedere con un Account Google diverso.

Revoca dei token OAuth

Gli utenti possono revoke l'accesso da applicazioni come Looker all'Account Google visitando le impostazioni del proprio Account Google.

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

Tabelle derivate permanenti in una connessione BigQuery

Se vuoi utilizzare le tabelle derivate permanenti (PDT) per la tua connessione BigQuery, potresti dover effettuare le seguenti operazioni, a seconda della configurazione della connessione:

  • Utilizza la console Google Cloud per creare un set di dati temporaneo nel tuo database BigQuery che Looker può utilizzare per scrivere PDT. Per informazioni sulla procedura, consulta la sezione Creazione di un set di dati temporaneo per 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 Creazione di un account di servizio e download del certificato delle credenziali JSON in questa pagina. Il tipo di autenticazione della connessione determina se è necessario un account di servizio PDT e anche il punto in cui inserisci 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 utente, devi creare un account di servizio separato per i processi PDT. Inserirai i dati dell'account di servizio e i dettagli del file del certificato nella sezione PDT Overrides (Override PDT) della finestra Connections (Connessioni) di Looker. La finestra Connessioni di Looker mostra automaticamente la sezione Override PDT 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 utente, puoi creare un account di servizio separato per i processi PDT. Se scegli di avere un account di servizio PDT separato, dovrai inserire i dati dell'account di servizio nella sezione PDT Overrides (Override PDT) per i campi Email account di servizio, File JSON/P12 account di servizio e Password della finestra Connections (Connessioni) di Looker. La sezione Override PDT viene visualizzata quando attivi l'opzione Abilita PDT per una connessione Looker a BigQuery utilizzando 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 tua connessione 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 Temp Dataset. In questo campo, inserisci il nome del set di dati che Looker può utilizzare per creare 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, quindi seleziona Crea set di dati.

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

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

Abilitazione delle PDT per le connessioni di Looker a BigQuery con OAuth

Per le connessioni BigQuery che utilizzano OAuth, gli utenti devono eseguire l'autenticazione in Looker con le proprie credenziali OAuth. Looker supporta le PDT per le connessioni BigQuery con OAuth, ma Looker stesso 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 il gestore API di Google Cloud. 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, inserirai i dati dell'account di servizio e i dettagli del file del certificato nella sezione Override PDT della finestra Connections (Connessioni) di Looker quando configuri la connessione Looker a BigQuery. La finestra Connessioni di Looker mostra automaticamente la sezione Override PDT quando attivi l'opzione Abilita PDT per una connessione configurata anche con l'opzione OAuth nel campo Autenticazione. Utilizza i seguenti campi nella sezione Override PDT per inserire le informazioni per l'account di servizio che Looker può utilizzare per i processi PDT nel tuo database:

  • Carica p12 o json: usa 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 ottenere 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 PDT. Inserisci l'indirizzo email dell'account di servizio BigQuery da utilizzare per i processi PDT sulla connessione. Puoi ottenere 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 PDT. Inserisci la password nel file delle credenziali .p12 per l'account di servizio BigQuery che vuoi utilizzare per i processi PDT nella connessione.

Connessione di Looker a BigQuery

Nella sezione Admin (Amministratore) di Looker, seleziona Connections (Connessioni) per aprire la pagina Connections (Connessioni) ed 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 del database e sono descritte nella pagina della documentazione Connessione di Looker al tuo database. Le impostazioni seguenti sono menzionate per evidenziarle o per chiarire come si applicano specificamente alle connessioni BigQuery:

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

  • ID progetto di fatturazione: il nome del progetto di fatturazione di Google Cloud. Il progetto di fatturazione è il progetto Google Cloud che viene fatturato, ma puoi comunque eseguire query sui set di dati in un progetto Google Cloud diverso se i tuoi sviluppatori LookML specificano i nomi delle tabelle con ambito completo nel parametro sql_table_name delle viste, delle esplorazioni o dei join di LookML. Per BigQuery, il nome di 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 che hai specificato 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 che deve essere impostato da Looker per impostazione predefinita 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 altro progetto.

    Il tuo progetto LookML può accedere alle tabelle in altri set di dati (incluse tabelle in set di dati pubblici) se gli sviluppatori LookML specificano i nomi delle tabelle con ambito completo nel parametro sql_table_name delle viste LookML, delle esplorazioni o dei join. Per BigQuery, il nome di tabella con ambito completo utilizza il formato <project_name>.<dataset_name>.<table_name>. Per eseguire query su una tabella in un altro set di dati, la tabella deve essere accessibile all'account di servizio (per le connessioni che utilizzano l'autenticazione dell'account di servizio) o all'utente che esegue la query (per le connessioni che utilizzano l'autenticazione OAuth). Se il codice LookML non specifica nomi di tabella 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 (cosa che potrebbe verificarsi se separa le risorse di calcolo e archiviazione in progetti separati), puoi fornire un valore Set di dati arbitrario, ma in questo caso devi sempre utilizzare nomi di tabella con ambito completo nel LookML.

  • : il tipo di autenticazione che Looker utilizzerà per accedere al tuo database, Account di servizio o OAuth.

  • Abilita PDT: abilita questa opzione per consentire le tabelle derivate permanenti (PDT) nella connessione. Dovrai specificare il set di dati temporaneo sul database che Looker utilizzerà per scrivere le PDT. Per informazioni sulla procedura, consulta la sezione Creazione di un set di dati temporaneo per tabelle derivate permanenti in questa pagina. Nota: se la connessione è configurata per OAuth, dovrai utilizzare la sezione Override PDT per specificare un account di servizio che Looker può utilizzare per i processi PDT sulla connessione BigQuery. Per maggiori dettagli, consulta la sezione Abilitazione delle PDT per le connessioni di Looker a BigQuery con OAuth.

  • Set di dati temporanei: 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 tabelle derivate permanenti.

  • Fuso orario database: il fuso orario predefinito per BigQuery è UTC. L'impostazione del fuso orario specificata qui deve corrispondere a quella di BigQuery. Per saperne di più, consulta la sezione Fuso orario del database della pagina Connessione di Looker al database.

  • Fuso orario query: consulta la sezione Fuso orario query della pagina Connessione di Looker al tuo database per saperne di più.

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

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

  • Max di gigabyte di fatturazione: per le connessioni BigQuery, ti viene addebitata ogni query in base alle sue dimensioni. Per evitare agli utenti di eseguire accidentalmente una query troppo costosa, puoi impostare un numero massimo di gigabyte a cui un utente può eseguire il pull in una singola query. Puoi lasciare vuoto il campo Max di gigabyte di fatturazione se non limiti le dimensioni delle query. Per ulteriori informazioni sui prezzi, consulta la pagina Prezzi di BigQuery.

  • Numero massimo di connessioni per nodo: può essere inizialmente lasciato sul valore predefinito. Scopri di più su questa impostazione nella sezione Numero massimo di connessioni per nodo della pagina della documentazione Connessione di Looker al tuo database.

  • Timeout del pool di connessioni: inizialmente può essere lasciato al valore predefinito. Scopri di più su questa impostazione nella sezione Timeout del pool di connessioni nella pagina della documentazione Connessione di Looker al database.

  • Disabilita contesto: questa opzione disabilita i commenti di contesto su una connessione BigQuery. I commenti del contesto nelle connessioni a Google BigQuery sono disattivati per impostazione predefinita perché questi commenti impediscono a Google BigQuery di memorizzare nella cache e possono incidere negativamente sulle prestazioni della cache. Puoi attivare i commenti contestuali per una connessione BigQuery disattivando l'opzione Disabilita contesto. Per saperne di più, consulta la sezione Etichette dei job e commenti al contesto per le connessioni BigQuery.

  • Precache di SQL Runner: se vuoi che SQL Runner non precarica le informazioni della tabella e carichi invece quelle solo quando è selezionata, cancella questa opzione. Per saperne di più, consulta la sezione Precache di SQL Runner della pagina Connessione di Looker al tuo database.

Dopo aver compilato tutti i campi applicabili per la connessione, puoi verificarla in base alle tue esigenze.

Per salvare queste impostazioni, fai clic su Connetti.

Test della connessione in corso...

Puoi testare le impostazioni di connessione da un paio di punti della UI di Looker:

  • Seleziona il pulsante Test in fondo alla pagina Connections Settings (Impostazioni connessioni) come descritto nella pagina della documentazione relativa alla connessione di Looker al tuo database.
  • Seleziona il pulsante Test in base all'elenco della connessione nella pagina di amministrazione Connections (Connessioni), come descritto nella pagina della documentazione Connections (Connessioni).

Per le nuove connessioni, se Looker visualizza 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 a Modalità di sviluppo.
  2. Per una connessione BigQuery esistente che utilizza OAuth, vai ai file di progetto per un progetto Looker che utilizza la connessione BigQuery. Per le nuove connessioni BigQuery che utilizzano OAuth, apri un file del modello e sostituisci il valore connection del modello con il nome della nuova connessione BigQuery, poi salva il file del modello.
  3. Apri una delle esplorazioni o delle dashboard del modello ed esegui una query. Quando provi a eseguire una query, Looker ti chiede di accedere con il tuo Account Google. Segui le istruzioni di accesso OAuth di Google.

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 dei job BigQuery. Per impostazione predefinita, Looker invia le seguenti chiavi di etichetta di contesto per le connessioni BigQuery:

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

  • looker-context-history_slug: l'identificatore univoco per 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. L'assistenza Looker può utilizzare queste informazioni per aiutarti a risolvere i problemi, se necessario.

Puoi configurare etichette dei job aggiuntive per Looker da inviare con ogni query sulla connessione BigQuery utilizzando il campo di testo Parametri JDBC aggiuntivi della pagina Connessioni. Nel campo Parametri JDBC aggiuntivi, aggiungi un ulteriore parametro JDBC, labels, e fornisci un elenco separato da virgole di coppie key=value codificate nell'URL. Ad esempio, se includi questa opzione nel campo Parametri JDBC aggiuntivi:

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

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

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

Tieni presente che BigQuery prevede restrizioni sulle 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, le etichette di contesto sono le prime a essere eliminate, seguite dalle etichette di connessione, fino a 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 l'esito negativo delle query.

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

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

-- Looker Query Context

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

Quindi 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"}]

Supporto delle funzionalità

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

SQL standard di Google BigQuery

L'SQL standard di Google BigQuery supporta le seguenti funzionalità a partire da Looker 24.8:

Selezione delle Supportato?
Livello di assistenza
Supportato
Looker (Google Cloud core)
Sì
Aggregati simmetrici
Sì
Tabelle derivate
Sì
Tabelle derivate SQL permanenti
Sì
Tabelle derivate native permanenti
Sì
Visualizzazioni stabili
Sì
Eliminazione delle 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 SQL Runner
No
Descrivi tabella SQL Runner
No
Indici di visualizzazione SQL Runner
No
SQL Runner Select 10
Sì
Conteggio esecutori SQL
Sì
Spiegazione SQL
No
Credenziali OAuth
Sì
Commenti contestuali
Sì
Pooling di connessioni
No
Schizzi HLL
Sì
Awareness aggregato
Sì
PDT incrementali
Sì
Millisecondi
Sì
Microsecondi
Sì
Viste materializzate
Sì
Conteggio approssimativo distinto
Sì

SQL precedente di Google BigQuery

L'SQL precedente di Google BigQuery supporta le seguenti funzionalità a partire da Looker 24.8:

Selezione delle Supportato?
Livello di assistenza
Supportato
Looker (Google Cloud core)
No
Aggregati simmetrici
Sì
Tabelle derivate
Sì
Tabelle derivate SQL permanenti
Sì
Tabelle derivate native permanenti
Sì
Visualizzazioni stabili
No
Eliminazione delle 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 SQL Runner
No
Descrivi tabella SQL Runner
No
Indici di visualizzazione SQL Runner
No
SQL Runner Select 10
Sì
Conteggio esecutori SQL
Sì
Spiegazione SQL
No
Credenziali OAuth
Sì
Commenti contestuali
Sì
Pooling di connessioni
No
Schizzi HLL
No
Awareness aggregato
Sì
PDT incrementali
No
Millisecondi
Sì
Microsecondi
Sì
Viste materializzate
No
Conteggio approssimativo distinto
Sì

Passaggi successivi

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