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

Nota: Looker tiene asistencia de integración para AlloyDB para PostgreSQL, Amazon RDS para PostgreSQL y Amazon Aurora PostgreSQL. A fin de crear una conexión para estos dialectos, selecciona PostgreSQL 9.5+ en el menú desplegable Dialecto de la página Conexión nueva.

Nota: Para PostgreSQL en Heroku, consulta la documentación de Heroku.

Encriptar el tráfico de red

Looker recomienda que se encripte el tráfico de red entre la aplicación de Looker y su 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 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;

Para 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 función crea tablas para las que el usuario looker necesita permisos en el futuro, debes especificar una función o un usuario objetivo a fin de aplicar los permisos otorgados por el usuario 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;

Por ejemplo, si un usuario web_app crea tablas y quieres que el usuario looker pueda usarlas, debes ejecutar una declaración GRANT para otorgarle permisos looker en las tablas que crea 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 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 con alojamiento propio

Crea un esquema que pertenezca al 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 de scratch al usuario looker:

ALTER SCHEMA looker_scratch OWNER TO looker;

Nota: Para que las tablas derivadas de PostgreSQL funcionen, no debes usar Looker sobre una base de datos de replicación de transmisión de intercambio directo. Debes poder escribir en la base de datos desde fuera de la aplicación.

Configura search_path

Por último, debes configurar un search_path adecuado, que el ejecutor de SQL de Looker usa para recuperar ciertos metadatos de tu base de datos. Suponiendo que 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

Agrega la conexión

Después de completar la configuración de la base de datos, puedes conectarte a la base de datos de Looker. 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 estas opciones de configuración son comunes en la mayoría de los dialectos de la base de datos. Se describen en la página de documentación Conecta Looker a tu base de datos.

Nota: A fin de crear una conexión para el dialecto de AlloyDB para PostgreSQL, selecciona PostgreSQL 9.5+ en el menú desplegable Dialect de la página New Connection.

Después de configurar las opciones de conexión, haga clic en Probar esta configuración para verificar que la conexión a PostgreSQL sea correcta. 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.

Haz clic en Agregar conexión para guardar la conexión.

Compatibilidad de características

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

En la versión más reciente de Looker, PostgreSQL es compatible con las siguientes funciones de Looker:

En la versión más reciente de Looker, Cloud SQL para PostgreSQL es compatible con las siguientes características de Looker:

En la versión más reciente de Looker, Microsoft Azure PostgreSQL es compatible con las siguientes características de Looker: