PostgreSQL

Dialetti che utilizzano queste istruzioni

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

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

Nota: Looker dispone del supporto all'integrazione per AlloyDB per PostgreSQL, Amazon RDS per PostgreSQL e Amazon Aurora PostgreSQL. Per creare una connessione per questi dialetti, seleziona PostgreSQL 9.5+ dal menu a discesa Dialect nella pagina Nuova connessione.

Nota: per PostgreSQL su Heroku, consulta la documentazione di Heroku.

Crittografia del traffico di rete

Looker consiglia di criptare il traffico di rete tra l'applicazione Looker e il tuo database. Valuta una delle opzioni descritte nella pagina della documentazione relativa all'abilitazione dell'accesso sicuro al database.

Se ti interessa utilizzare la crittografia SSL, consulta la documentazione di PostgreSQL.

Utenti e sicurezza

Cambia 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 le autorizzazioni di utilizzo a Looker:

GRANT USAGE ON SCHEMA schema_name TO looker;

Per assicurarti che le tabelle future che aggiungi 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 crea tabelle per le quali l'utente looker richiede autorizzazioni future, devi specificare un ruolo o un utente target per applicare le autorizzazioni di autorizzazione dell'utente looker per:

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 di looker sia in grado di utilizzarle, devi eseguire un'istruzione GRANT per concedere all'utente looker le autorizzazioni per le tabelle create dall'utente web_app. Il ruolo/utente di destinazione in questo caso è l'utente web_app, il che significa che abbiamo scelto come target le tabelle create da web_app in modo che l'utente looker possa avere le autorizzazioni per leggere le tabelle. Ecco un esempio:

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

Per ulteriori informazioni, consulta il ALTER DEFAULT PRIVILEGES sul sito web di PostgreSQL.

Configurazione 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;

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

ALTER SCHEMA looker_scratch OWNER TO looker;

Nota: affinché le tabelle derivate permanenti di PostgreSQL funzionino, non devi utilizzare Looker su un database di replica "streaming" attivo. Devi poter scrivere nel database dall'esterno dell'applicazione.

Configurazione del search_path in corso...

Infine, dovresti impostare un search_path appropriato, che viene utilizzato da SQL Runner per recuperare determinati metadati dal tuo database. Supponendo che tu abbia creato un utente chiamato looker e uno schema temporaneo denominato looker_scratch, il comando sia:

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

Aggiungere la connessione

Dopo aver completato la configurazione del database, puoi connetterti al database da Looker. Nella sezione Admin (Amministrazione) di Looker, seleziona Connections (Connessioni) e fai clic su Add Connection (Aggiungi connessione).

Inserisci i dettagli della connessione. La maggior parte di queste impostazioni è comune alla maggior parte dei dialetti dei database. Sono descritte nella pagina della documentazione dedicata alla connessione di Looker al tuo database.

Nota: per creare una connessione per il dialetto AlloyDB per PostgreSQL, seleziona PostgreSQL 9.5 e versioni successive dal menu a discesa Dialect nella pagina Nuova connessione.

Dopo aver configurato le opzioni di connessione, fai clic su Test These Settings (Prova queste impostazioni) per verificare che la connessione a PostgreSQL sia riuscita. Per informazioni sulla risoluzione dei problemi, consulta la pagina della documentazione relativa al test di connettività del database.

Fai clic su Aggiungi connessione per salvare la connessione.

Supporto delle funzionalità

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

Nell'ultima release di Looker, PostgreSQL supporta le seguenti funzionalità di Looker:

Nella versione più recente di Looker, Cloud SQL per PostgreSQL supporta le seguenti funzionalità di Looker:

Nell'ultima release di Looker, Microsoft Azure PostgreSQL supporta le seguenti funzionalità di Looker: