PostgreSQL

Dialectos que usan estas instrucciones

Los siguientes dialectos comparten los requisitos de configuración de la base de datos como se describe en esta página:

  • PostgreSQL
  • Cloud SQL para PostgreSQL
  • Microsoft Azure PostgreSQL
  • AlloyDB para PostgreSQL
  • Amazon Aurora PostgreSQL
  • Amazon RDS para PostgreSQL

Encripta el tráfico de red

Looker recomienda que encripte el tráfico de red entre la aplicación de Looker y su base de datos. Considera una de las opciones descritas en la página de documentación Habilita el acceso seguro a la base de datos.

Si te interesa usar la encriptación SSL, consulta la documentación de PostgreSQL.

Usuarios y seguridad

Cambia some_password_here a una contraseña única y segura:

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;

Si usas un esquema distinto de public, ejecuta este comando para otorgar permisos de uso a Looker:

GRANT USAGE ON SCHEMA schema_name TO looker;

A fin de asegurarte de que las tablas futuras que agregues al esquema público también estén disponibles para el usuario looker, ejecuta estos comandos:

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

Según su configuración, es posible que deba modificar los comandos anteriores. Si otro usuario o rol crea tablas para las que el usuario looker necesita permisos en el futuro, debes especificar un rol o un usuario objetivo a fin de aplicar los permisos que otorga el usuario looker para lo siguiente:

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;

Por ejemplo, si un usuario web_app crea tablas y deseas que el usuario looker pueda usar esas tablas, debes ejecutar una sentencia GRANT para otorgarle permisos looker al usuario en las tablas que creó el usuario web_app. En este caso, la función o el usuario de destino es el usuario web_app, lo que significa que segmentamos tablas que crea web_app a fin de que el usuario looker pueda tener permisos para leer las tablas. A continuación, se muestra un ejemplo:

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

Consulta ALTER DEFAULT PRIVILEGES en el sitio web de PostgreSQL para obtener más información.

Configuración del esquema temporal

Postgres de alojamiento propio

Crea un esquema que sea propiedad del usuario looker:

CREATE SCHEMA looker_scratch AUTHORIZATION looker;

Postgres en Amazon RDS

Crea un esquema temporal:

CREATE SCHEMA looker_scratch;

Cambia la propiedad del esquema desde cero al usuario looker:

ALTER SCHEMA looker_scratch OWNER TO looker;

Configurando search_path

Por último, debes configurar un search_path apropiado, que el ejecutor de SQL de Looker usa para recuperar ciertos metadatos de tu base de datos. Si creaste un usuario llamado looker y un esquema temporal llamado looker_scratch, el comando es el siguiente:

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

Crea la conexión de Looker a tu base de datos

En la sección Administrador de Looker, seleccione Conexiones y, luego, haga clic en Agregar conexión.

Completa los detalles de la conexión. La mayoría de las opciones de configuración son comunes en la mayoría de los dialectos de las bases de datos. Consulta la página de documentación Conecta Looker a tu base de datos para obtener más información.

Para verificar que la conexión se realice de forma correcta, haz clic en Probar. Consulta la página de documentación sobre cómo probar la conectividad de la base de datos para obtener información sobre la solución de problemas.

Para guardar esta configuración, haz clic en Conectar.

Compatibilidad de características

Para que Looker admita algunas funciones, tu dialecto de base de datos también debe admitirlas.

PostgreSQL 9.5 y versiones posteriores son compatibles con las siguientes funciones a partir de Looker 23.8:

Atributo ¿Es compatible?
Nivel de asistencia
Admitido
Looker (Google Cloud Core)
Agregaciones simétricas
Tablas derivadas
Tablas derivadas de SQL persistente
Tablas derivadas persistentes nativas
Vistas estables
Asesinato de consultas
Pivotes basados en SQL
Zonas horarias
SSL
Subtotales
Parámetros adicionales de JDBC
Distingue mayúsculas de minúsculas
Tipo de ubicación
Tipo de lista
Percentil
Percentil distintivo
Procesos de Show del ejecutor de SQL
Tabla de descripción del ejecutor de SQL
Índices de SQL Runner Show
Ejecutor de SQL Select 10
Recuento de ejecutores de SQL
Explicación de SQL
Credenciales de OAuth
No
Comentarios de contexto
Agrupación de conexiones
Bocetos de HLL
No
Reconocimiento global
PDT incrementales
Milisegundos
Microsegundos
Vistas materializadas
No
Distinto del recuento aproximado
No

A partir de Looker 23.8, Google Cloud PostgreSQL es compatible con las siguientes funciones:

Atributo ¿Es compatible?
Nivel de asistencia
Admitido
Looker (Google Cloud Core)
Agregaciones simétricas
Tablas derivadas
Tablas derivadas de SQL persistente
Tablas derivadas persistentes nativas
Vistas estables
Asesinato de consultas
Pivotes basados en SQL
Zonas horarias
SSL
Subtotales
Parámetros adicionales de JDBC
Distingue mayúsculas de minúsculas
Tipo de ubicación
Tipo de lista
Percentil
Percentil distintivo
Procesos de Show del ejecutor de SQL
Tabla de descripción del ejecutor de SQL
Índices de SQL Runner Show
Ejecutor de SQL Select 10
Recuento de ejecutores de SQL
Explicación de SQL
Credenciales de OAuth
No
Comentarios de contexto
Agrupación de conexiones
Bocetos de HLL
No
Reconocimiento global
PDT incrementales
Milisegundos
Microsegundos
Vistas materializadas
No
Distinto del recuento aproximado
No

Microsoft Azure PostgreSQL es compatible con las siguientes funciones a partir de Looker 23.8:

Atributo ¿Es compatible?
Nivel de asistencia
Admitido
Looker (Google Cloud Core)
Agregaciones simétricas
Tablas derivadas
Tablas derivadas de SQL persistente
Tablas derivadas persistentes nativas
Vistas estables
Asesinato de consultas
Pivotes basados en SQL
Zonas horarias
SSL
Subtotales
Parámetros adicionales de JDBC
Distingue mayúsculas de minúsculas
Tipo de ubicación
Tipo de lista
Percentil
Percentil distintivo
Procesos de Show del ejecutor de SQL
Tabla de descripción del ejecutor de SQL
Índices de SQL Runner Show
Ejecutor de SQL Select 10
Recuento de ejecutores de SQL
Explicación de SQL
Credenciales de OAuth
No
Comentarios de contexto
Agrupación de conexiones
Bocetos de HLL
No
Reconocimiento global
PDT incrementales
Milisegundos
Microsegundos
Vistas materializadas
No
Distinto del recuento aproximado
No