PostgreSQL

Dialetti che utilizzano queste istruzioni

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

• PostgreSQL
• Microsoft Azure PostgreSQL
• Amazon Aurora PostgreSQL
• Amazon RDS per PostgreSQL

Per Amazon RDS per PostgreSQL e Amazon Aurora PostgreSQL, Looker include il supporto per l'integrazione.

Per PostgreSQL su Heroku, consulta la documentazione di Heroku.

Per Google Cloud SQL per PostgreSQL, consulta la nostra pagina dedicata a Google Cloud SQL per PostgreSQL.

Criptare il traffico di rete

È una best practice criptare il traffico di rete tra l'applicazione Looker e il tuo database. Valuta una delle opzioni descritte nella pagina della documentazione Abilita l'accesso sicuro ai database.

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

Utenti e sicurezza

Per eseguire azioni sul database, Looker deve avere un account utente sul database.

Per configurare un utente del database da utilizzare per Looker, segui questi passaggi sul database:

1. Crea un nome utente e una password del database.

   CREATE USER USERNAME WITH ENCRYPTED PASSWORD 'PASSWORD';
   

2. Concedi le autorizzazioni all'utente del database in modo che Looker possa eseguire azioni sul database:

   GRANT CONNECT ON DATABASE DATABASE_NAME to USERNAME;
   \c DATABASE_NAME
   GRANT SELECT ON ALL SEQUENCES IN SCHEMA public TO USERNAME;
   GRANT SELECT ON ALL TABLES IN SCHEMA public TO USERNAME;
   

3. 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 USERNAME;
   

4. 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 USERNAME;
   ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT SELECT ON sequences TO USERNAME;
   

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 avrà bisogno di autorizzazioni future, devi specificare un ruolo o un utente di destinazione a cui applicare le concessioni di autorizzazioni dell'utente Looker:

ALTER DEFAULT PRIVILEGES FOR USER ANOTHER_USERNAME IN SCHEMA SCHEMA_NAME GRANT SELECT ON tables TO USERNAME;
ALTER DEFAULT PRIVILEGES FOR ROLE TARGET_ROLE IN SCHEMA SCHEMA_NAME GRANT SELECT ON sequences TO USERNAME;

Ad esempio, se un utente web_app crea tabelle e vuoi che l'utente looker possa utilizzare queste tabelle, devi eseguire un'istruzione GRANT per concedere all'utente looker le autorizzazioni sulle tabelle create dall'utente web_app. In questo caso, il ruolo o l'utente di destinazione è l'utente web_app, il che significa che vuoi modificare i privilegi sulle 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 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 SCHEMA_NAME AUTHORIZATION USERNAME;

Postgres su Amazon RDS

Crea uno schema temporaneo:

CREATE SCHEMA SCHEMA_NAME;

Modifica la proprietà dello schema temporaneo in modo che sia dell'utente Looker:

ALTER SCHEMA SCHEMA_NAME OWNER TO USERNAME;

Nota: affinché le tabelte derivate permanenti di PostgreSQL funzionino, non devi utilizzare Looker su un database di replica di streaming "hot swap" . Devi essere in grado di scrivere nel database dall'esterno dell'applicazione.

Impostare search_path

Prima di connettere Looker al database, devi impostare un search_path appropriato, che SQL Runner di Looker può utilizzare per recuperare determinati metadati dal database:

ALTER USER USERNAME SET search_path TO '$user',SCHEMA_NAME,SCHEMA_NAME_2,SCHEMA_NAME_3
                                                            ^^^^^^^^^^^^^^^^^^
                                                            ^^^^^^^^^^^^^^^^^^
                                             include a comma-separated list of
                                            all schemas that you'll use with Looker

Nota: se utilizzi un'istanza di Looker (Google Cloud core) e vuoi utilizzare ADC, utilizza il nome utente del account di servizio con rappresentazione che hai aggiunto al database Cloud SQL. Il nome utente del account di servizio avrà il formato service-<project number>@gcp-sa-looker.iam.gserviceaccount.com. Se il nome utente del account di servizio termina con .gserviceaccount.com, rimuovi la parte .gserviceaccount.com del nome utente. Dopo il troncamento, il nome utente sarà simile a service-<project number>@gcp-sa-looker.iam.

Creare la connessione Looker al database

Segui questi passaggi per creare la connessione da Looker al database:

1. Apri la pagina Connetti il tuo database a Looker in uno dei seguenti modi:

   • Fai clic sull'icona del menu Menu principale e seleziona Amministrazione, quindi seleziona Connessioni nella sezione Database del riquadro Amministrazione. Nella pagina Connessioni, fai clic sul pulsante Aggiungi connessione.
   • Fai clic sul pulsante Crea nel menu di navigazione principale, quindi seleziona la voce di menu Connessione.

2. Dal menu a discesa Dialetto, seleziona il nome del dialetto del database:

   • Per Microsoft Azure PostgreSQL, seleziona Microsoft Azure PostgreSQL.
   • Per PostgreSQL, seleziona PostgreSQL 9.5+ o PostgreSQL pre-9.5, a seconda della versione di PostgreSQL.
   • Per Amazon RDS per PostgreSQL e Amazon Aurora PostgreSQL, seleziona PostgreSQL 9.5+.
   Nota: se utilizzi un'istanza di Looker (Google Cloud core) e non vedi il dialetto elencato nel menu a discesa Dialetto, consulta la documentazione di Looker (Google Cloud core) per verificare che il dialetto sia supportato per le istanze di Looker (Google Cloud core).

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

4. 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 Testare la connettività del database.

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

Parametri JDBC supportati

Per PostgreSQL, Looker supporta i seguenti parametri JDBC nel campo Parametri JDBC aggiuntivi per la connessione. Per informazioni su questi parametri, consulta la documentazione del tuo database.

• allowEncodingChanges
• ApplicationName
• assumeMinServerVersion
• binaryTransfer
• binaryTransferDisable
• binaryTransferEnable
• cancelSignalTimeout
• connectTimeout
• currentSchema
• databaseMetadataCacheFields
• defaultRowFetchSize
• escapeSyntaxCallMode
• gssEncMode
• hostRecheckSeconds
• jaasApplicationName
• jaasLogin
• kerberosServerName
• loadBalanceHosts
• loginTimeout
• logServerErrorDetail
• options
• password
• preferQueryMode
• preparedStatementCacheQueries
• prepareThreshold
• queryTimeout
• readOnly
• reWriteBatchedInserts
• socketTimeout
• ssl
• sslfactory
• sslhostnameverifier
• sslmode
• sslNegotiation
• sslpassword
• sslpasswordcallback
• stringtype
• targetServerType
• tcpKeepAlive
• unknownLength
• user

Funzionalità supportate

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

A partire da Looker 26.6, PostgreSQL 9.5+ supporta le seguenti funzionalità:

Funzionalità	Supportata?
Looker (Google Cloud core)
Aggregati simmetrici
Tabelle derivate
Tabelle derivate SQL permanenti
Tabelle derivate permanenti native
Visualizzazioni stabili
Terminazione delle query
Pivot basati su SQL
Fusi orari
SSL
Subtotali
Parametri JDBC aggiuntivi
Maiuscole/minuscole
Tipo di località
Tipo di elenco
Percentile
Percentile valori distinti
SQL Runner Mostra processi
SQL Runner Descrivi tabella
SQL Runner Mostra indici
SQL Runner Seleziona 10
SQL Runner Conteggio
Spiegazione SQL
Credenziali OAuth 2.0
Commenti di contesto
Pool di connessioni
Schizzi HLL
Riconoscimento degli aggregati
PDT incrementali
Millisecondi
Microsecondi
Visualizzazioni materializzate
Misure in base al periodo
Conteggio approssimato valori distinti
Calendari personalizzati

A partire da Looker 26.6, Microsoft Azure PostgreSQL supporta le seguenti funzionalità:

Funzionalità	Supportata?
Looker (Google Cloud core)
Aggregati simmetrici
Tabelle derivate
Tabelle derivate SQL permanenti
Tabelle derivate permanenti native
Visualizzazioni stabili
Terminazione delle query
Pivot basati su SQL
Fusi orari
SSL
Subtotali
Parametri JDBC aggiuntivi
Maiuscole/minuscole
Tipo di località
Tipo di elenco
Percentile
Percentile valori distinti
SQL Runner Mostra processi
SQL Runner Descrivi tabella
SQL Runner Mostra indici
SQL Runner Seleziona 10
SQL Runner Conteggio
Spiegazione SQL
Credenziali OAuth 2.0
Commenti di contesto
Pool di connessioni
Schizzi HLL
Riconoscimento degli aggregati
PDT incrementali
Millisecondi
Microsecondi
Visualizzazioni materializzate
Misure in base al periodo
Conteggio approssimato valori distinti
Calendari personalizzati