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
  • Google Cloud SQL para PostgreSQL
  • Microsoft Azure PostgreSQL
  • AlloyDB para PostgreSQL
  • Amazon Aurora PostgreSQL
  • Amazon RDS para PostgreSQL

Encripta el tráfico de red

Una práctica recomendada es encriptar el tráfico de red entre la aplicación de Looker y tu base de datos. Considera una de las opciones que se describen 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 por 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 que no sea 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 futuros, debes especificar un usuario o un rol de destino para aplicar los permisos del usuario looker a los siguientes elementos:

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 de web_app crea tablas y quieres que el usuario de looker pueda usarlas, debes ejecutar una sentencia GRANT para otorgar permisos de usuario a looker en las tablas que crea el usuario web_app. En este caso, el rol o usuario de destino es el usuario web_app, lo que significa que apuntamos a tablas que crea web_app para que el usuario looker tenga 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 autoalojado

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 temporal al usuario looker:

ALTER SCHEMA looker_scratch OWNER TO looker;

Configura el search_path

Por último, debes establecer 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, ejecuta el siguiente 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

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

Sigue estos pasos para crear la conexión de Looker a tu base de datos:

  1. En la sección Administrador de Looker, selecciona Conexiones y, luego, haz clic en Agregar conexión.

  2. En el menú desplegable Dialecto, selecciona el nombre del dialecto de la base de datos. En el dialecto AlloyDB para PostgreSQL, selecciona PostgreSQL 9.5+.

  3. Completa los detalles de la conexión. La mayoría de los parámetros de configuración son comunes en la mayoría de los dialectos de bases de datos. Consulta la página de documentación Cómo conectar Looker a tu base de datos para obtener más información.

  4. Para verificar que la conexión se haya realizado correctamente, haz clic en Probar. Consulta la página de documentación Prueba la conectividad de la base de datos para obtener información sobre la solución de problemas.

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

Compatibilidad de características

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

A partir de Looker 24.6, PostgreSQL 9.5 y versiones posteriores son compatibles con las siguientes funciones:

Atributo ¿Es compatible?
Nivel de asistencia
Admitido
Looker (Google Cloud Core)
Sí
Agregados simétricos
Sí
Tablas derivadas
Sí
Tablas derivadas de SQL persistentes
Sí
Tablas derivadas persistentes nativas
Sí
Vistas estables
Sí
Finalización de consultas
Sí
Tablas dinámicas basadas en SQL
Sí
Zonas horarias
Sí
SSL
Sí
Subtotales
Sí
Parámetros adicionales de JDBC
Sí
Distingue mayúsculas de minúsculas
Sí
Tipo de ubicación
Sí
Tipo de lista
Sí
Percentil
Sí
Percentil distinto
Sí
Procesos de presentación del ejecutor de SQL
Sí
Tabla de descripción del ejecutor de SQL
Sí
Mostrar índices del ejecutor de SQL
Sí
Selector de SQL 10 Select
Sí
Recuento de ejecutores de SQL
Sí
Explicación de SQL
Sí
Credenciales de OAuth
No
Comentarios de contexto
Sí
Agrupación de conexiones
Sí
Bocetos HLL
No
Reconocimiento agregado
Sí
PDT incrementales
Sí
Milisegundos
Sí
Microsegundos
Sí
Vistas materializadas
No
Recuento aproximado de valores distintos
No

A partir de Looker 24.6, Google Cloud PostgreSQL admite las siguientes funciones:

Atributo ¿Es compatible?
Nivel de asistencia
Admitido
Looker (Google Cloud Core)
Sí
Agregados simétricos
Sí
Tablas derivadas
Sí
Tablas derivadas de SQL persistentes
Sí
Tablas derivadas persistentes nativas
Sí
Vistas estables
Sí
Finalización de consultas
Sí
Tablas dinámicas basadas en SQL
Sí
Zonas horarias
Sí
SSL
Sí
Subtotales
Sí
Parámetros adicionales de JDBC
Sí
Distingue mayúsculas de minúsculas
Sí
Tipo de ubicación
Sí
Tipo de lista
Sí
Percentil
Sí
Percentil distinto
Sí
Procesos de presentación del ejecutor de SQL
Sí
Tabla de descripción del ejecutor de SQL
Sí
Mostrar índices del ejecutor de SQL
Sí
Selector de SQL 10 Select
Sí
Recuento de ejecutores de SQL
Sí
Explicación de SQL
Sí
Credenciales de OAuth
No
Comentarios de contexto
Sí
Agrupación de conexiones
Sí
Bocetos HLL
No
Reconocimiento agregado
Sí
PDT incrementales
Sí
Milisegundos
Sí
Microsegundos
Sí
Vistas materializadas
No
Recuento aproximado de valores distintos
No

A partir de Looker 24.6, Microsoft Azure PostgreSQL admite las siguientes funciones:

Atributo ¿Es compatible?
Nivel de asistencia
Admitido
Looker (Google Cloud Core)
Sí
Agregados simétricos
Sí
Tablas derivadas
Sí
Tablas derivadas de SQL persistentes
Sí
Tablas derivadas persistentes nativas
Sí
Vistas estables
Sí
Finalización de consultas
Sí
Tablas dinámicas basadas en SQL
Sí
Zonas horarias
Sí
SSL
Sí
Subtotales
Sí
Parámetros adicionales de JDBC
Sí
Distingue mayúsculas de minúsculas
Sí
Tipo de ubicación
Sí
Tipo de lista
Sí
Percentil
Sí
Percentil distinto
Sí
Procesos de presentación del ejecutor de SQL
Sí
Tabla de descripción del ejecutor de SQL
Sí
Mostrar índices del ejecutor de SQL
Sí
Selector de SQL 10 Select
Sí
Recuento de ejecutores de SQL
Sí
Explicación de SQL
Sí
Credenciales de OAuth
No
Comentarios de contexto
Sí
Agrupación de conexiones
Sí
Bocetos HLL
No
Reconocimiento agregado
Sí
PDT incrementales
Sí
Milisegundos
Sí
Microsegundos
Sí
Vistas materializadas
No
Recuento aproximado de valores distintos
No