Snowflake

Per connettere Looker a Snowflake, segui questi passaggi:

1. Crea un utente Looker su Snowflake ed esegui il provisioning dell'accesso.
2. Configura una connessione al database in Looker.

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. Prendi in considerazione una delle opzioni descritte nella pagina della documentazione Abilitazione dell'accesso sicuro al database.

Creazione di un utente Looker su Snowflake

Consigliamo i comandi seguenti per creare l'utente Looker. Assicurati di eseguire ogni riga singolarmente.

Se vuoi, aggiungi la parola chiave ON FUTURE per rendere persistenti le istruzioni GRANT sugli oggetti appena creati. Ti consigliamo di eseguire questa operazione per le tabelle in tutti gli schemi che Looker utilizzerà, in modo che non sia necessario eseguire nuovamente le istruzioni GRANT quando vengono create nuove tabelle.

-- change role to ACCOUNTADMIN
use role ACCOUNTADMIN;

-- create role for looker
create role if not exists looker_role;
grant role looker_role to role SYSADMIN;
    -- Note that we are not making the looker_role a SYSADMIN,
    -- but rather granting users with the SYSADMIN role to modify the looker_role

-- create a user for looker
create user if not exists looker_user
password = <enter password here>;
grant role looker_role to user looker_user;
alter user looker_user
set default_role = looker_role
default_warehouse = looker_wh;

-- change role
use role SYSADMIN;

-- create a warehouse for looker (optional)
create warehouse if not exists looker_wh

-- set the size based on your dataset
warehouse_size = medium
warehouse_type = standard
auto_suspend = 1800
auto_resume = true
initially_suspended = true;
grant all privileges
on warehouse looker_wh
to role looker_role;

-- grant read only database access (repeat for all database/schemas)
grant usage on database <database> to role looker_role;
grant usage on schema <database>.<schema> to role looker_role;

-- rerun the following any time a table is added to the schema
grant select on all tables in schema <database>.<schema> to role looker_role;
-- or
grant select on future tables in schema <database>.<schema> to role looker_role;

-- create schema for looker to write back to
use database <database>;
create schema if not exists looker_scratch;
use role ACCOUNTADMIN;
grant ownership on schema looker_scratch to role SYSADMIN revoke current grants;
grant all on schema looker_scratch to role looker_role;

Se incolli i comandi precedenti come gruppo nel riquadro delle connessioni Snowflake, seleziona la casella di controllo Tutte le query per assicurarti che tutte le righe vengano eseguite. Per impostazione predefinita, Snowflake esegue solo le linee selezionate.

Creazione della connessione Looker al tuo database

Nella sezione Admin (Amministrazione) di Looker, seleziona Connections (Connessioni) e quindi fai clic su Add Connection (Aggiungi connessione).

Compila i dettagli della connessione. La maggior parte delle impostazioni è comune alla maggior parte dei dialetti dei database. Per informazioni, consulta la pagina della documentazione Collegamento di Looker al tuo database. Di seguito sono descritte alcune delle impostazioni:

• Nome: assegna un nome alla connessione. In questo modo il modello LookML farà riferimento alla connessione.
• Dialetto: seleziona Snowflake.
• Host: inserisci il nome host Snowflake. Sarà simile a <account_name>.snowflakecomputing.com. Controlla gli esempi di nomi di account Snowflake per regione per assicurarti di utilizzare il valore corretto per il tuo deployment.
• Porta: il valore predefinito è 443.
• Database: inserisci il database predefinito da utilizzare. Questo campo distingue tra lettere maiuscole e minuscole.
• Schema: inserisci lo schema predefinito.
• Autenticazione: seleziona Account database o OAuth:
  .
  • Utilizza Account database per specificare il nome utente e la password dell'account utente Snowflake che verrà utilizzato per la connessione a Looker.
  • Utilizza OAuth se vuoi configurare OAuth per la connessione.

• Abilita le PDT: utilizza questa opzione per abilitare le tabelle derivate permanenti (PDT). L'abilitazione delle PDT mostra i campi PDT aggiuntivi e la sezione PDT Overrides (Override PDT) per la connessione.

  Nota: le PDT non sono supportate per le connessioni Snowflake che utilizzano OAuth.

• Database temporaneo: se le PDT sono abilitate, imposta questo campo su uno schema in cui l'utente dispone di tutti i privilegi per creare, eliminare, rinominare e modificare le tabelle.

• Numero massimo di connessioni per nodo: inizialmente questa impostazione può essere lasciata 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.

• Stima dei costi: abilita le stime dei costi per le query Explore, le stime dei costi per le query SQL Runner e le stime del risparmio di calcolo per le query di rilevamento aggregate sulla connessione.

• Fuso orario database: il fuso orario utilizzato dal database Snowflake per archiviare date e orari. Il valore predefinito è UTC. Questa opzione è facoltativa.

• Fuso orario query: il fuso orario in cui visualizzare le query. ad esempio Stati Uniti orientali (America – New York). Questa opzione è facoltativa.

• Parametri JDBC aggiuntivi: aggiungi altri parametri JDBC dal driver JDBC Snowflake.

  • Aggiungi warehouse=<YOUR WAREHOUSE NAME>.

  • Inoltre, per impostazione predefinita, Looker imposterà i seguenti parametri Snowflake su ogni sessione:

    • TIMESTAMP_TYPE_MAPPING=TIMESTAMP_LTZ
    • JDBC_TREAT_DECIMAL_AS_INT=FALSE
    • TIMESTAMP_INPUT_FORMAT=AUTO
    • AUTOCOMMIT=TRUE

    Puoi eseguire l'override di ciascuno di questi parametri impostando un valore alternativo nel campo Parametri JDBC aggiuntivi, ad esempio: &AUTOCOMMIT=FALSE

Per verificare che la connessione sia andata a buon fine, fai clic su Test. Per informazioni sulla risoluzione dei problemi, consulta la pagina della documentazione relativa al test della connettività del database.

Per salvare queste impostazioni, fai clic su Connetti.

Specificare i warehouse Snowflake per gruppo o per utente

Puoi utilizzare gli attributi utente di Looker per assegnare warehouse Snowflake separati a singoli utenti o gruppi di Looker. Ciò è utile, ad esempio, se hai utenti che richiedono livelli diversi di potenza di calcolo. Puoi assegnare un warehouse con maggiori risorse di calcolo solo agli utenti che ne hanno bisogno, assegnando al contempo un warehouse con meno risorse agli utenti con minori esigenze.

Per designare i warehouse per gruppo o per utente, segui questi passaggi:

1. Aggiungi i gruppi o gli utenti in Looker.

2. Definisci un attributo utente in Looker in cui verranno archiviati i nomi dei warehouse Snowflake. Puoi assegnare a questo attributo un nome qualsiasi, ad esempio snowflake_wh.

   

3. Nell'attributo utente appena definito, assegna i valori del nome del warehouse ai gruppi o agli utenti.

   

4. Nel campo Parametri JDBC aggiuntivi della pagina Impostazioni di connessione, aggiungi quanto segue, sostituendo snowflake_warehouse con il nome dell'attributo utente definito:

     warehouse={{ _user_attributes['snowflake_warehouse'] }}
   

   Ad esempio:

   

5. Per testare le singole impostazioni di connessione, puoi sudo come utente a cui hai assegnato un valore per il nome del warehouse.

Per istruzioni più dettagliate su questa procedura, consulta il blog di Red Pill Analytics.

Funzionalità di sospensione automatica di Snowflake

I warehouse Snowflake hanno una funzionalità di sospensione automatica abilitata per impostazione predefinita. Dopo un periodo specificato, il warehouse verrà sospeso automaticamente. Se il warehouse è sospeso, tutte le query producono un errore. Questo errore non è visibile nelle dashboard (in genere non vengono mostrati dati), ma è visibile quando esegui query con la pagina Esplora.

Snowflake dispone anche di una funzionalità di ripristino automatico che consente di ripristinare il warehouse quando viene eseguita una query. Tuttavia, il ripristino del warehouse può richiedere fino a cinque minuti e causare l'interruzione della risposta delle query per cinque minuti prima del ritorno. Queste funzionalità non possono essere configurate in Looker. Attiva queste funzionalità nella scheda Warehouse dell'interfaccia utente di Snowflake.

Supporto per PDT

Per il supporto delle tabelle derivate permanenti, crea un account utente Snowflake per le PDT con accesso in scrittura al tuo database e lo schema temporaneo che Looker utilizzerà per creare le PDT. Nella sezione Persistent Derived Tables (PDT) della pagina Impostazioni connessioni di Looker, attiva l'opzione Abilita PDT. Quindi, nel campo Database temporaneo, inserisci il nome dello schema temporaneo che Looker utilizzerà per creare le PDT. Quindi, nella sezione PDT Overrides (Override PdT), inserisci il nome utente e la password dell'utente della PDT. Per saperne di più, consulta la pagina della documentazione Collegamento di Looker al tuo database.

Le PDT non sono supportate per le connessioni Snowflake che utilizzano OAuth.

Per le connessioni Snowflake, Looker imposta il valore del parametro AUTOCOMMIT su TRUE (che è il valore predefinito di Snowflake). AUTOCOMMIT è obbligatorio per i comandi SQL eseguiti da Looker per mantenere il sistema di registrazione PDT.

Configurare OAuth per le connessioni Snowflake

Looker supporta OAuth per le connessioni Snowflake, il che significa che ogni utente Looker esegue l'autenticazione nel database e autorizza Looker a eseguire query sul database con l'account utente OAuth dell'utente.

OAuth consente agli amministratori di database di eseguire le seguenti attività:

• Controlla quali utenti di Looker eseguono query sul database
• Applica i controlli di accesso basati sui ruoli utilizzando autorizzazioni a livello di database
• Utilizza i token OAuth per tutti i processi e le azioni che accedono al database, invece di incorporare ID e password del database in più posti
• Revocare l'autorizzazione per un determinato utente direttamente tramite il database

Con le connessioni Snowflake che utilizzano OAuth, gli utenti devono accedere di nuovo periodicamente alla scadenza dei loro token OAuth. La durata di validità dei token OAuth Snowflake viene impostata tramite Snowflake stesso.

Tieni presente quanto segue per le connessioni OAuth a livello di database:

• Se un utente lascia scadere il token OAuth, tutte le pianificazioni o gli avvisi di Looker di sua proprietà verranno influenzati. Per evitare questo problema, Looker invia un'email di notifica al proprietario di ogni pianificazione e ogni avviso prima della scadenza del token OAuth attualmente attivo. Looker invierà queste notifiche via email 14 giorni, 7 giorni e 1 giorno prima della scadenza del token. L'utente può andare alla pagina utente di Looker per autorizzare nuovamente Looker al database ed evitare qualsiasi interruzione delle pianificazioni e degli avvisi. Per maggiori dettagli, consulta la pagina della documentazione Personalizzazione delle impostazioni dell'account utente.

• Poiché le connessioni di database che utilizzano OAuth sono "per utente", i criteri di memorizzazione nella cache sono anche per utente, 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 nel periodo di memorizzazione nella cache. Per ulteriori informazioni sulla memorizzazione nella cache, consulta la pagina della documentazione sulle query nella cache.

• Quando utilizzi OAuth, non puoi passare a ruoli diversi nell'account utente Snowflake. Come descritto nella documentazione di Snowflake, Snowflake utilizza il ruolo predefinito dell'account utente Snowflake, a meno che il ruolo predefinito non sia ACCOUNTAMMINISTRATORE o SECURITYADMIN. Poiché questi ruoli sono bloccati per OAuth, Snowflake utilizzerà il ruolo PUBLIC. Per informazioni, consulta la documentazione di Snowflake.

• Le tabelle derivate permanenti (PDT) non sono supportate per le connessioni Snowflake con OAuth.

• Quando un amministratore di Looker esegue l'operazione come altro utente, l'amministratore utilizzerà il token di accesso OAuth di quell'utente. Se il token di accesso dell'utente è scaduto, l'amministratore non può crearne uno nuovo per conto dell'utente sudoed. Per informazioni sull'utilizzo del comando sudo, consulta la pagina della documentazione Utenti.

Configurazione di un database Snowflake per OAuth con Looker

Per creare una connessione Snowflake a Looker utilizzando OAuth, devi configurare l'integrazione di OAuth in Snowflake. Questa operazione richiede un account utente Snowflake con autorizzazione ACCOUNTAMMINISTRATORE.

1. Esegui questo comando in Snowflake, dove <looker_hostname> è il nome host della tua istanza di Looker:

     CREATE SECURITY INTEGRATION LOOKER
       TYPE = OAUTH
       ENABLED = TRUE
       OAUTH_CLIENT = LOOKER
       OAUTH_REDIRECT_URI = 'https://<looker_hostname>/external_oauth/redirect';
   

2. Per recuperare l'ID client e il secret OAuth, esegui questo comando:

     SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('LOOKER');
   

   La risposta avrà OAUTH_CLIENT_ID e OAUTH_CLIENT_SECRET che ti serviranno più avanti in questa procedura.

3. In Looker, crea una nuova connessione al warehouse Snowflake, come descritto nella sezione Creare la connessione di Looker al tuo database di questa pagina. Quando crei la nuova connessione, seleziona l'opzione OAuth nel campo Autenticazione. Quando selezioni l'opzione OAuth, Looker visualizza i campi ID client OAuth e Client secret OAuth.

4. Incolla i valori OAUTH_CLIENT_ID e OAUTH_CLIENT_SECRET ottenuti dal tuo database prima di questa procedura.

5. Completa il resto della procedura per connettere Looker al tuo database.

Dopo aver configurato la connessione di Looker al tuo database, puoi testare la connessione stessa eseguendo una delle seguenti operazioni:

• 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.

In aggiunta, puoi testare la connessione ed eseguirne il deployment su un modello seguendo questi passaggi:

1. In Looker, vai alla modalità di sviluppo.
2. Vai ai file di progetto di un progetto Looker che utilizza la tua connessione Snowflake.
3. Apri un file del modello e sostituisci il valore connection del modello con il nome della nuova connessione Snowflake, quindi salva il file del modello.
4. Apri una delle esplorazioni o delle dashboard del modello ed esegui una query. Quando provi a eseguire una query, Looker ti chiede di accedere a Snowflake.
5. Segui le istruzioni di accesso per Snowflake e inserisci le tue credenziali di Snowflake.

Una volta eseguito l'accesso a Snowflake, Looker ti restituirà la query. Se la query viene eseguita correttamente, puoi eseguire il commit del nuovo valore di connessione ed eseguire il deployment delle modifiche in produzione.

Accesso a Snowflake per eseguire query

Una volta configurata la connessione Snowflake per OAuth, agli utenti verrà chiesto di accedere a Snowflake prima di eseguire le query. Sono incluse le query di esplorazioni, dashboard, Look e SQL Runner.

Gli utenti possono accedere a Snowflake anche dalla sezione Credenziali di connessione OAuth della propria pagina Account.

Per accedere al tuo account Snowflake utilizzando Looker, segui questi passaggi:

1. Fai clic sul menu utente di Looker.
2. Seleziona Account.
3. Nella pagina Account, vai alla sezione Credenziali di connessione OAuth e seleziona il pulsante Accedi per il database Snowflake appropriato.

Se selezioni Accedi, viene visualizzata una finestra di dialogo di accesso Snowflake. Inserisci le tue credenziali Snowflake e seleziona Accedi, quindi seleziona Consenti per concedere a Looker l'accesso al tuo account Snowflake.

Dopo aver eseguito l'accesso a Snowflake tramite Looker, puoi uscire o autorizzare di nuovo le tue credenziali in qualsiasi momento tramite la pagina Account, come descritto nella pagina della documentazione Personalizzare l'account utente.

Supporto delle funzionalità

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

Snowflake supporta le seguenti funzionalità a partire da Looker 24.12:

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ì
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	No
Processi SQL Runner Show	No
Tabella di descrizione di SQL Runner	Sì
SQL Runner Mostra indici	No
Selezione SQL Runner 10	Sì
Conteggio runner SQL	Sì
Spiegazione SQL	Sì
Credenziali OAuth	Sì
Commenti contestuali	Sì
Pooling di connessioni	Sì
Schizzi HLL	Sì
Consapevolezza aggregata	Sì
PDT incrementali	Sì
Millisecondi	Sì
Microsecondi	Sì
Viste materializzate	No
Conteggio approssimato distinto	No

Passaggi successivi

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