Google BigQuery

Panoramica

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

La procedura generale per configurare una connessione SQL standard di Google BigQuery o SQL precedente di Google BigQuery è la seguente:

  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 database BigQuery, se vuoi utilizzare tabelle derivate persistenti (PDT) sulla connessione, crea un set di dati temporaneo che Looker può utilizzare per creare PDT sul tuo database. Per la procedura, consulta la sezione Creazione di un set di dati temporaneo per le tabelle derivate permanenti.

  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 la procedura, consulta la sezione Test della connessione di questa pagina.

Autenticazione con account di servizio BigQuery

Un modo per autenticare Looker nel tuo database BigQuery è utilizzare 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. Google dispone della documentazione relativa alla creazione di un account di servizio e alla generazione di una chiave privata.

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

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 facoltativamente una descrizione e seleziona CREA E CONTINUA.

  4. L'account di servizio richiede due ruoli predefiniti 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 seleziona il secondo ruolo.

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

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

  6. Seleziona CHIAVE, quindi 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 computer.

    Dopo aver preso nota del percorso di download, seleziona CHIUDI:

  9. Seleziona FINE.

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

  11. Una volta creato l'account di servizio nel database BigQuery, dovrai inserire queste informazioni 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 durante la configurazione della connessione di Looker a BigQuery.

Autenticazione con OAuth

Looker supporta le connessioni OAuth per 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 Looker stanno eseguendo 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, anziché incorporare ID e password di BigQuery in più punti

Per le connessioni BigQuery con OAuth:

  • Se un amministratore di database modifica le credenziali del client OAuth di BigQuery, eventuali pianificazioni o avvisi di proprietà di un utente saranno interessati. Gli utenti devono accedere di nuovo se l'amministratore modifica le credenziali OAuth di BigQuery. Inoltre, gli utenti possono andare alla pagina Account di 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 si applicano anche agli utenti e non solo alle query. Ciò significa che, invece di utilizzare i risultati memorizzati nella cache ogni volta che la stessa query viene eseguita all'interno del 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 cache delle query.
  • Se vuoi utilizzare tabelle derivate persistenti (PDT, Persistent Derived Table) 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.
  • Quando eseguono questa operazione, gli amministratori utilizzeranno il token di autorizzazione OAuth di questo utente. Per informazioni sull'utilizzo del comando sudo, consulta la pagina della documentazione Utenti.

Configurazione di 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. Se hai già configurato una schermata per il consenso OAuth per un'altra applicazione nel tuo progetto, non dovrai crearne un'altra: dovrai configurare una sola schermata per il consenso per tutte le applicazioni di un progetto.

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 di Google Cloud e sul sito della console per gli sviluppatori di Google.

A seconda del tipo di utenti che accedono ai dati BigQuery in Looker e se i tuoi dati BigQuery sono pubblici o privati, OAuth potrebbe non essere il metodo di autenticazione più appropriato. Analogamente, il tipo di dati richiesto all'utente e il grado di accesso necessario per l'autenticazione in Google prima dell'utilizzo dei dati di quest'ultimo possono richiedere la verifica da parte di Google. Per saperne di più sulla verifica, consulta la sezione Generazione delle credenziali OAuth di Google in questa pagina.

Generazione delle credenziali OAuth di Google

  1. Vai alla console Google Cloud.

  2. Nel menu a discesa Seleziona un progetto, accedi al progetto BigQuery. A questo punto dovresti accedere alla dashboard del progetto.

  3. Nel menu a sinistra, seleziona la pagina API e servizi. Quindi, seleziona Credenziali. Nella pagina Credenziali, seleziona la freccia rivolta verso il basso nel pulsante Crea credenziali e scegli ID client OAuth dal menu a discesa:

  4. Google richiede la configurazione di una schermata per il consenso OAuth, che consente agli utenti di scegliere come concedere l'accesso ai propri dati privati, prima che tu possa generare le tue credenziali OAuth. 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 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 espande e mostra altre 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 il valore https://. Ecco alcuni esempi:

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

Google richiede la configurazione di 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 per i quali vuoi rendere disponibile questa app. A seconda della selezione effettuata, l'app potrebbe richiedere la verifica da parte di Google.

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

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

  • L'applicazione utilizza API di Google che utilizzano ambiti limitati o sensibili.
  • Nella schermata di consenso OAuth è incluso un logo dell'applicazione.
  • Il progetto ha superato la soglia di 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 utente, inserisci l'email dell'assistenza che gli utenti devono contattare per risolvere problemi relativi all'accesso o al consenso.

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

  4. Nella sezione Informazioni 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 tua schermata di consenso.

  5. Seleziona SALVA E CONTINUA.

  6. Google mostra la pagina Ambiti, in cui puoi configurare gli ambiti. Looker richiede solo gli ambiti predefiniti, quindi non è necessaria alcuna configurazione aggiuntiva. 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 per il consenso OAuth di Google, consulta la documentazione dell'assistenza di Google.

Configurazione della connessione di Looker per BigQuery con OAuth

Per attivare OAuth per la connessione a BigQuery, seleziona l'opzione OAuth nella pagina Connessione di Looker durante la configurazione della connessione di Looker a BigQuery. Quando abiliti l'opzione OAuth, Looker visualizza i campi ID client OAuth e Secret client OAuth. Incolla i valori Client-ID e Client Secret che hai ottenuto come passaggio nella procedura Generazione delle credenziali OAuth di Google di questa pagina.

Completa il resto della procedura come descritto nella sezione Collegamento di Looker a BigQuery di questa pagina.

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

Una volta configurata la connessione Looker a BigQuery per OAuth, gli utenti possono utilizzare Looker per eseguire l'autenticazione iniziale nel tuo database BigQuery, in uno dei seguenti modi:

  • Autenticazione in Google da una query Looker che utilizza la connessione BigQuery
  • Eseguire l'autenticazione su Google dalla sezione Credenziali di connessione OAuth della relativa pagina Account Looker

Autenticazione in Google da una query

Dopo aver configurato la connessione 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 messaggio da Explore, dashboard, Look e SQL Runner.

L'utente deve selezionare Accedi e autenticarsi con OAuth. Dopo che l'utente si è autenticato in BigQuery, può selezionare il pulsante Esegui in Explore e Looker caricherà i dati in Explore.

Autenticazione in Google dalla pagina dell'account utente

Dopo aver configurato OAuth per la connessione a BigQuery, 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 dell'utente.
  2. Scorri verso il basso fino alla sezione Credenziali di connessione OAuth e seleziona il pulsante Accedi per la connessione al database BigQuery che ti interessa.
  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 eseguito l'autenticazione in 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 Riautorizza ad accedere con un altro Account Google.

Revoca dei token OAuth

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

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

Tabelle derivate permanenti su una connessione BigQuery

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

  • Utilizza la console BigQuery di Google Cloud per creare un set di dati temporaneo nel database BigQuery che Looker può utilizzare per scrivere le PDT. Per la procedura, consulta la sezione Creazione di un set di dati temporaneo per le tabelle derivate permanenti in questa documentazione. Questa operazione è necessaria per le PDT, indipendentemente dalle altre opzioni di configurazione della connessione.
  • Utilizza il gestore di 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 sulla connessione influisce sulla necessità di un account di servizio PDT e sull'inserimento dei dati dell'account di servizio PDT nella finestra Connections di Looker quando configuri la connessione Looker a BigQuery:
    • Se la connessione utilizza OAuth per l'autenticazione degli utenti, devi creare un account di servizio separato per i processi PDT. Inserisci le informazioni sull'account di servizio e i dettagli del file del certificato nella sezione Override PDT della finestra Connections di Looker. La finestra Connessioni di Looker mostra automaticamente la sezione Override PDT quando attivi il pulsante di attivazione/disattivazione Abilita PDT per una connessione configurata anche con l'opzione OAuth nel campo Autenticazione. Per saperne di più, consulta la sezione sull'attivazione delle PDT per le connessioni di Looker a BigQuery con OAuth.
    • Se la connessione utilizza account di servizio per l'autenticazione degli utenti, puoi creare un account di servizio separato per i processi PDT. Se scegli di avere un account di servizio PDT separato, dovrai inserire le relative informazioni nella sezione Override PDT per i campi Email account di servizio, File JSON/P12 dell'account di servizio e Password della finestra Connessioni di Looker. La sezione Override delle PDT viene visualizzata quando attivi l'opzione Abilita PDT per una connessione di 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 connessione BigQuery, attiva l'opzione di attivazione delle PDT nella pagina Connessione di Looker quando imposti la connessione Looker a BigQuery. Quando abiliti le PDT, Looker mostra il campo Temp Dataset (Set di dati temporanei). 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 BigQuery di Google Cloud:

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

  2. Seleziona il menu con tre puntini, quindi Crea set di dati.

  3. Inserisci un ID set di dati (in genere looker_scratch) e seleziona la Località dei dati (facoltativa), 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 Temp Dataset della finestra Connections quando hai configurato la connessione 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 autenticarsi in Looker con le proprie credenziali OAuth. Looker supporta le PDT per le connessioni a BigQuery con OAuth, che però non può essere utilizzato. Pertanto, devi configurare un account di servizio BigQuery appositamente per consentire a Looker di accedere al tuo database per i processi PDT.

Puoi configurare un account di servizio PDT nel 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.

Una volta creato l'account di servizio nel database BigQuery, dovrai inserire le informazioni dell'account di servizio e i dettagli del file del certificato nella sezione Override PDT della finestra Connections di Looker, quando configuri la connessione Looker a BigQuery. La finestra Connessioni di Looker mostra automaticamente la sezione Override PDT quando attivi il pulsante di attivazione/disattivazione Abilita PDT per una connessione configurata anche con l'opzione OAuth nel campo Autenticazione. Utilizza i seguenti campi della sezione Override PDT per inserire le informazioni per l'account di servizio che Looker può utilizzare per i processi PDT sul tuo database:

  • Carica file 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 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.
  • Nome utente: questo campo vale solo se carichi un file P12 nel campo Upload p12 or json della sezione PDT Overrides. 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 Upload p12 or json della sezione PDT Overrides. Inserisci la password per il file delle credenziali .p12 per l'account di servizio BigQuery che vuoi utilizzare per i processi PDT sulla connessione.

Collegamento di Looker a BigQuery

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

  • Per creare un nuovo collegamento, seleziona il pulsante Aggiungi connessione.
  • Per modificare una connessione esistente, trova la connessione nella tabella Database e seleziona il pulsante Modifica nell'elenco delle connessioni.

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. Si menziona le impostazioni messe in evidenza per evidenziarle o per spiegare in che modo si applicano specificamente alle connessioni BigQuery:

  • Dialect: seleziona Google BigQuery Standard SQL o Google BigQuery Legacy SQL.
  • ID progetto di fatturazione: l'ID del progetto Google Cloud. Il progetto di fatturazione è il progetto Google Cloud che viene fatturato, 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 viste, delle esplorazioni o dei join di LookML. Per BigQuery, il nome completo di una tabella utilizza il formato <project_name>.<dataset_name>.<table_name>. Senza un riferimento ambito, BigQuery cerca la tabella nel progetto di fatturazione e nel set di dati specificati nella pagina Connections di Looker per la connessione BigQuery a Looker. Per una spiegazione della gerarchia delle risorse in BigQuery, consulta la documentazione di BigQuery.
  • Set di dati: il nome del set di dati predefinito che prevedi di utilizzare. Se per una tabella non è stato specificato un set di dati, si presume che la tabella sia presente in questo set di dati. (puoi anche creare altri set di dati in questo progetto). Il valore Set di dati deve corrispondere al nome di un set di dati nel tuo database BigQuery.
  • Autenticazione: 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 persistenti (PDT) sulla connessione. Dovrai specificare il set di dati temporaneo sul tuo database che Looker utilizzerà per scrivere PDT. Per la procedura, consulta la sezione Creazione di un set di dati temporaneo per le tabelle derivate permanenti in questa pagina. Nota: se la tua 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 tua connessione BigQuery. Per maggiori dettagli, consulta la sezione Abilitazione delle PDT per le connessioni di Looker a BigQuery con OAuth.
  • Set di dati temporaneo: il set di dati BigQuery creato nella console BigQuery di 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.
  • Fuso orario database: il fuso orario predefinito per BigQuery è UTC. L'impostazione del fuso orario specificata qui deve corrispondere a quella del fuso orario di BigQuery. Per ulteriori informazioni, consulta la sezione Database Time Zone (Fuso orario del database) della pagina Connessione di Looker al tuo database.
  • Query Time Zone (Fuso orario query): per saperne di più, consulta la sezione Query Time Zone della pagina Connessione di Looker al tuo database.
  • Parametri JDBC aggiuntivi: aggiungi eventuali altri parametri JDBC, come le etichette BigQuery (per ulteriori informazioni, consulta la sezione Etichette job e commenti di contesto per le connessioni BigQuery in questa pagina). Di seguito sono riportati alcuni degli altri parametri supportati:
    • connectTimeout: numero di millisecondi di attesa per una connessione. Il valore predefinito è 240.000.
    • readTimeout: numero di millisecondi di attesa per una lettura. Il valore predefinito è 240.000.
    • rootUrl: se disponi di un'istanza BigQuery in una rete privata, specifica un endpoint alternativo da connettere a BigQuery, oltre all'endpoint pubblico predefinito.
  • Max Gigabyte di fatturazione: per le connessioni BigQuery, i costi vengono addebitati per ogni query in base alle dimensioni della query. Per impedire agli utenti di eseguire 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 Max Billing Gigabytes (Max gigabyte di fatturazione) per indicare nessun limite sulle dimensioni delle query. Scopri di più sui prezzi qui.
  • Numero massimo di connessioni per nodo: inizialmente può essere lasciato al valore predefinito. Per saperne di più su questa impostazione, consulta la sezione Max connections per node della pagina della documentazione Connessione di Looker al tuo database.
  • Timeout del pool di connessioni: inizialmente può essere lasciato al 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.
  • Disabilita contesto: questa opzione disabilita i commenti del contesto su una connessione BigQuery. I commenti di contesto sulle connessioni a Google BigQuery sono disattivati per impostazione predefinita perché i commenti contestuali non consentono a Google BigQuery di utilizzare la cache e influiscono negativamente sulle prestazioni di quest'ultima. Puoi abilitare i commenti contestuali per una connessione a BigQuery disattivando l'opzione Disattiva contesto. Per ulteriori informazioni, consulta la sezione Etichette dei job e commenti di contesto per le connessioni BigQuery.
  • Pre-cache SQL Runner: se vuoi che SQL Runner non precarichi le informazioni delle tabelle e che carichi le informazioni delle tabelle solo quando viene selezionata una tabella, deseleziona questa opzione. Per ulteriori informazioni, consulta la sezione SQL Runner Precache (Pre-cache SQL Runner) della pagina Connessione di Looker al tuo database.

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

Per salvare queste impostazioni, fai clic su Connetti.

Test della connessione

Puoi verificare le impostazioni di connessione da due posizioni dell'interfaccia utente di Looker.

  • Seleziona il pulsante Test (Prova) in fondo alla pagina Connections Settings (Impostazioni connessioni), come descritto nella pagina della documentazione Connessione di Looker al tuo database.
  • Seleziona il pulsante Test in corrispondenza dell'elenco delle connessioni nella pagina di amministrazione delle connessioni, come descritto nella pagina della documentazione Connessioni.

Per le nuove connessioni, se Looker mostra 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 del progetto per un progetto Looker che utilizza la 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 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 per l'accesso a Google OAuth.

Etichette dei job e commenti contestuali per le connessioni BigQuery

Per le connessioni BigQuery, Looker invia il contesto delle query sotto forma di etichette di 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 di ciascun utente nell'istanza di Looker. L'ID utente è riconducibile a quello visualizzato nella pagina Users del menu Admin (Amministratore).

  • looker-context-history_slug: l'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 inviato la query. Se necessario, l'assistenza Looker può utilizzare queste informazioni per aiutarti a risolvere i problemi.

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

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

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

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

Tieni presente che BigQuery prevede limitazioni sulle etichette dei job:

  • Qualsiasi etichetta di connessione con la stessa chiave di un'etichetta di contesto verrà ignorata.
  • Se l'unione delle etichette delle connessioni e delle etichette del contesto supera il limite massimo di 64 etichette, le etichette del contesto vengono eliminate per prime, seguite da quelle della connessione, fino a quando le etichette del numero totale non sono al massimo 64.

Looker garantisce che le etichette del contesto siano conformi a tutti i requisiti di validità delle etichette di BigQuery, ma non controlla la validità delle etichette di connessione. La configurazione delle etichette di connessione non valide potrebbe causare un errore nelle query.

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

Le stesse informazioni vengono fornite anche dai commenti contestuali di SQL e dalle etichette dei job BigQuery. 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 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"}]

Assistenza per le funzionalità

Affinché Looker supporti alcune funzionalità, anche il dialetto del tuo database deve supportarle.

SQL standard di Google BigQuery

A partire da Looker 23.8, il linguaggio SQL standard di Google BigQuery supporta le seguenti funzionalità:

Funzionalità Supportato?
Livello di assistenza
Richiesta supportata
Looker (Google Cloud core)
Sì
Aggregati simmetrici
Sì
Tabelle derivate
Sì
Tabelle derivate permanenti da SQL
Sì
Tabelle derivate native permanenti
Sì
Visualizzazioni 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ì
Distintivo percentile
Sì
Processi di visualizzazione di SQL Runner
No
Tabella di descrizione di SQL Runner
No
Indici di SQL Runner
No
SQL Runner Seleziona 10
Sì
Conteggio SQL Runner
Sì
Spiegazione SQL
No
Credenziali OAuth
Sì
Commenti contestuali
Sì
Pooling della connessione
No
Disegni HLL
Sì
Aggregate Awareness
Sì
PDT incrementali
Sì
Millisecondi
Sì
Microsecondi
Sì
Viste materializzate
Sì
Conteggio approssimativo distinto
Sì

SQL precedente di Google BigQuery

A partire da Looker 23.8, la versione precedente di SQL di Google supporta le seguenti funzionalità:

Funzionalità Supportato?
Livello di assistenza
Richiesta supportata
Looker (Google Cloud core)
No
Aggregati simmetrici
Sì
Tabelle derivate
Sì
Tabelle derivate permanenti da SQL
Sì
Tabelle derivate native permanenti
Sì
Visualizzazioni 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ì
Distintivo percentile
Sì
Processi di visualizzazione di SQL Runner
No
Tabella di descrizione di SQL Runner
No
Indici di SQL Runner
No
SQL Runner Seleziona 10
Sì
Conteggio SQL Runner
Sì
Spiegazione SQL
No
Credenziali OAuth
Sì
Commenti contestuali
Sì
Pooling della connessione
No
Disegni HLL
No
Aggregate Awareness
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 i tuoi utenti.