PostgreSQL

Dialetti che utilizzano queste istruzioni

I seguenti dialetti condividono i requisiti di configurazione del database, come descritto in questa pagina:

  • PostgreSQL
  • Google Cloud SQL per PostgreSQL
  • Microsoft Azure PostgreSQL
  • AlloyDB per PostgreSQL
  • Amazon Aurora PostgreSQL
  • Amazon RDS per PostgreSQL

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.

Se vuoi utilizzare la crittografia SSL, consulta la documentazione di PostgreSQL.

Utenti e sicurezza

Modifica some_password_here in una password univoca e sicura:

CREATE USER looker WITH ENCRYPTED PASSWORD 'some_password_here';
GRANT CONNECT ON DATABASE database_name to looker;
\c database_name
GRANT SELECT ON ALL SEQUENCES IN SCHEMA public TO looker;
GRANT SELECT ON ALL TABLES IN SCHEMA public TO looker;

Se utilizzi uno schema diverso da public, esegui questo comando per concedere a Looker le autorizzazioni di utilizzo:

GRANT USAGE ON SCHEMA schema_name TO looker;

Per assicurarti che le tabelle future aggiunte allo schema pubblico siano disponibili anche per l'utente looker, esegui questi comandi:

ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT SELECT ON tables TO looker;
ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT SELECT ON sequences TO looker;

A seconda della configurazione, potrebbe essere necessario modificare i comandi precedenti. Se un altro utente o ruolo sta creando tabelle per le quali l'utente looker ha bisogno di autorizzazioni future, devi specificare un ruolo o un utente target per cui applicare le concessioni di autorizzazioni dell'utente looker:

ALTER DEFAULT PRIVILEGES FOR USER <USER_WHO_CREATES_TABLES> IN SCHEMA public GRANT SELECT ON tables TO looker;
ALTER DEFAULT PRIVILEGES FOR ROLE <ROLE_THAT_CREATES_TABLES> IN SCHEMA public GRANT SELECT ON sequences TO looker;

Ad esempio, se un utente di web_app crea tabelle e vuoi che l'utente looker possa utilizzarle, devi eseguire un'istruzione GRANT per concedere all'utente looker le autorizzazioni per le tabelle create dall'utente web_app. In questo caso, l'utente/il ruolo target è l'utente web_app, il che significa che scegliamo come target tabelle create da web_app in modo che l'utente looker possa disporre delle autorizzazioni necessarie per leggere le tabelle. Ecco un esempio:

ALTER DEFAULT PRIVILEGES FOR USER web_app IN SCHEMA public GRANT SELECT ON tables TO looker;

Per saperne di più, vedi ALTER DEFAULT PRIVILEGES sul sito web di PostgreSQL.

Configurazione dello schema temporaneo

Postgres self-hosted

Crea uno schema di proprietà dell'utente looker:

CREATE SCHEMA looker_scratch AUTHORIZATION looker;

Postgres su Amazon RDS

Crea uno schema temporaneo:

CREATE SCHEMA looker_scratch;

Cambia la proprietà dello schema temporaneo per l'utente looker:

ALTER SCHEMA looker_scratch OWNER TO looker;

Impostazione di search_path

Infine, devi impostare un valore search_path appropriato, che SQL Runner di Looker utilizza per recuperare determinati metadati dal tuo database. Supponendo che tu abbia creato un utente denominato looker e uno schema temporaneo denominato looker_scratch, esegui questo comando:

ALTER USER looker SET search_path TO '$user',looker_scratch,schema_of_interest,public
                                                            ^^^^^^^^^^^^^^^^^^
                                                            ^^^^^^^^^^^^^^^^^^
                                             include a comma-separated list of
                                            all schemas you'll use with Looker

Creazione della connessione Looker al tuo database

Per creare la connessione da Looker al tuo database:

  1. Nella sezione Admin (Amministrazione) di Looker, seleziona Connections (Connessioni) e fai clic su Add Connection (Aggiungi connessione).
  2. Dal menu a discesa Dialect, seleziona il nome del dialetto del database. Per il dialetto AlloyDB per PostgreSQL, seleziona PostgreSQL 9.5 o versioni successive.

  3. Compila i dettagli della connessione. La maggior parte delle impostazioni è comune alla maggior parte dei dialetti del database. Per informazioni, consulta la pagina della documentazione Connessione di Looker al tuo database.

  4. Per verificare che la connessione venga stabilita, fai clic su Prova. Per informazioni sulla risoluzione dei problemi, consulta la pagina della documentazione relativa ai test di connettività dei database.

  5. Per salvare queste impostazioni, fai clic su Connetti.

Supporto delle funzionalità

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

PostgreSQL 9.5 e versioni successive supporta le seguenti funzionalità a partire da Looker 24.8:

Selezione delle Supportato?
Livello di assistenza
Supportato
Looker (Google Cloud core)
Aggregati simmetrici
Tabelle derivate
Tabelle derivate SQL permanenti
Tabelle derivate native permanenti
Visualizzazioni stabili
Eliminazione delle query
Pivot basati su SQL
Fusi orari
SSL
Subtotali
Parametri aggiuntivi JDBC
Sensibilità alle maiuscole
Tipo di località
Tipo di elenco
Percentile
Percentile distinto
Processi di visualizzazione SQL Runner
Descrivi tabella SQL Runner
Indici di visualizzazione SQL Runner
SQL Runner Select 10
Conteggio esecutori SQL
Spiegazione SQL
Credenziali OAuth
No
Commenti contestuali
Pooling di connessioni
Schizzi HLL
No
Awareness aggregato
PDT incrementali
Millisecondi
Microsecondi
Viste materializzate
No
Conteggio approssimativo distinto
No

Google Cloud PostgreSQL supporta le seguenti funzionalità a partire da Looker 24.8:

Selezione delle Supportato?
Livello di assistenza
Supportato
Looker (Google Cloud core)
Aggregati simmetrici
Tabelle derivate
Tabelle derivate SQL permanenti
Tabelle derivate native permanenti
Visualizzazioni stabili
Eliminazione delle query
Pivot basati su SQL
Fusi orari
SSL
Subtotali
Parametri aggiuntivi JDBC
Sensibilità alle maiuscole
Tipo di località
Tipo di elenco
Percentile
Percentile distinto
Processi di visualizzazione SQL Runner
Descrivi tabella SQL Runner
Indici di visualizzazione SQL Runner
SQL Runner Select 10
Conteggio esecutori SQL
Spiegazione SQL
Credenziali OAuth
No
Commenti contestuali
Pooling di connessioni
Schizzi HLL
No
Awareness aggregato
PDT incrementali
Millisecondi
Microsecondi
Viste materializzate
No
Conteggio approssimativo distinto
No

Microsoft Azure PostgreSQL supporta le seguenti funzionalità a partire da Looker 24.8:

Selezione delle Supportato?
Livello di assistenza
Supportato
Looker (Google Cloud core)
Aggregati simmetrici
Tabelle derivate
Tabelle derivate SQL permanenti
Tabelle derivate native permanenti
Visualizzazioni stabili
Eliminazione delle query
Pivot basati su SQL
Fusi orari
SSL
Subtotali
Parametri aggiuntivi JDBC
Sensibilità alle maiuscole
Tipo di località
Tipo di elenco
Percentile
Percentile distinto
Processi di visualizzazione SQL Runner
Descrivi tabella SQL Runner
Indici di visualizzazione SQL Runner
SQL Runner Select 10
Conteggio esecutori SQL
Spiegazione SQL
Credenziali OAuth
No
Commenti contestuali
Pooling di connessioni
Schizzi HLL
No
Awareness aggregato
PDT incrementali
Millisecondi
Microsecondi
Viste materializzate
No
Conteggio approssimativo distinto
No