PostgreSQL

Dialectos que usan estas instrucciones

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

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

En el caso de Google Cloud SQL para PostgreSQL, Looker (Google Cloud core) ofrece las credenciales predeterminadas de la aplicación (ADC) como método de autenticación. Para obtener más información, consulta la documentación de Looker (Google Cloud core).

En AlloyDB para PostgreSQL, Amazon RDS para PostgreSQL y Amazon Aurora PostgreSQL, Looker ofrece compatibilidad con la integración. Para crear una conexión para estos dialectos, selecciona PostgreSQL 9.5+ en el menú desplegable Dialect (Dialecto) de la página New Connection (Nueva conexión).

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

Cifrar el tráfico de red

Te recomendamos que cifres el tráfico de red entre la aplicación Looker y tu base de datos. Considera una de las opciones descritas en la página de documentación Habilitar el acceso seguro a la base de datos.

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

Usuarios y seguridad

Para realizar acciones en tu base de datos, Looker necesita tener una cuenta de usuario en ella.

Si tienes una instancia de Looker (Google Cloud core) y quieres usar ADC, utiliza el nombre de usuario de la cuenta de servicio suplantada que has añadido a tu base de datos de Cloud SQL. El nombre de usuario de la cuenta de servicio tendrá el formato service-<project number>@gcp-sa-looker.iam.gserviceaccount.com. Si el nombre de usuario de tu cuenta de servicio termina en .gserviceaccount.com, elimina la parte .gserviceaccount.com del nombre de usuario. Una vez truncado, el nombre de usuario sería service-<project number>@gcp-sa-looker.iam.

Para configurar un usuario de base de datos que pueda usar Looker, sigue estos pasos en tu base de datos:

  1. Crea un usuario y una contraseña para la base de datos.

    CREATE USER USERNAME WITH ENCRYPTED PASSWORD 'PASSWORD';

  2. Concede permisos al usuario de la base de datos para que Looker pueda realizar acciones en tu base de datos:

    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. Si usas un esquema que no sea public, ejecuta este comando para conceder permisos de uso a Looker:

    GRANT USAGE ON SCHEMA SCHEMA_NAME TO USERNAME;

  4. Para asegurarte de que las tablas que añadas al esquema público también estén disponibles para el usuario de Looker, ejecuta estos comandos:

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

Según tu configuración, es posible que tengas que modificar los comandos anteriores. Si otro usuario o rol crea tablas para las que el usuario de Looker necesita permisos en el futuro, debe especificar un rol o usuario de destino para aplicar los permisos del usuario de 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;

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 dar permisos al usuario de looker en las tablas creadas por el usuario de web_app. En este caso, el rol o el usuario de destino es el usuario web_app, lo que significa que quieres modificar los privilegios de las tablas creadas por 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 de temperatura

Postgres autohosted

Crea un esquema propiedad del usuario de Looker:

CREATE SCHEMA SCHEMA_NAME AUTHORIZATION USERNAME;

Postgres en Amazon RDS

Crea un esquema desde cero:

CREATE SCHEMA SCHEMA_NAME;

Cambia la propiedad del esquema de borrador al usuario de Looker:

ALTER SCHEMA SCHEMA_NAME OWNER TO USERNAME;

Configurar la search_path

Antes de conectar Looker a tu base de datos, debes definir un search_path adecuado, que el SQL Runner de Looker pueda usar para obtener determinados metadatos de tu base de datos:

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

Crear 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 Administrar de Looker, selecciona Conexiones y, a continuación, haz clic en Añadir conexión.

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

  3. Rellena los detalles de la conexión. La mayoría de los ajustes son comunes a la mayoría de los dialectos de bases de datos. Consulta la página de documentación Conectar Looker a tu base de datos para obtener información.

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

  5. Para guardar estos ajustes, haz clic en Conectar.

Funciones admitidas

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

PostgreSQL 9.5 y versiones posteriores admiten las siguientes funciones a partir de Looker 25.14:

Función ¿Es compatible?
Nivel de asistencia
Compatible
Looker (servicio principal de Google Cloud)
Sí
Agregados simétricos
Sí
Tablas derivadas
Sí
Tablas derivadas de SQL persistentes
Sí
Tablas derivadas nativas persistentes
Sí
Vistas estables
Sí
Eliminación de consultas
Sí
Pivotes basados en SQL
Sí
Zonas horarias
Sí
SSL
Sí
Subtotales
Sí
Parámetros adicionales de JDBC
Sí
Distingue entre mayúsculas y minúsculas
Sí
Tipo de ubicación
Sí
Tipo de lista
Sí
Percentil
Sí
Percentil de valores distintos
Sí
SQL Runner Show Processes
Sí
SQL Runner Describe Table
Sí
SQL Runner Show Indexes
Sí
SQL Runner Select 10
Sí
Recuento de SQL Runner
Sí
Explicación de SQL
Sí
Credenciales de OAuth 2.0
No
Comentarios contextuales
Sí
Grupo de conexiones
Sí
Esquemas HLL
No
Notoriedad agregada
Sí
PDTs incrementales
Sí
Milisegundos
Sí
Microsegundos
Sí
Vistas materializadas
No
Métricas de comparación con el periodo anterior
No
Recuento aproximado de valores distintos
No

Google Cloud PostgreSQL admite las siguientes funciones a partir de Looker 25.14:

Función ¿Es compatible?
Nivel de asistencia
Compatible
Looker (servicio principal de Google Cloud)
Sí
Agregados simétricos
Sí
Tablas derivadas
Sí
Tablas derivadas de SQL persistentes
Sí
Tablas derivadas nativas persistentes
Sí
Vistas estables
Sí
Eliminación de consultas
Sí
Pivotes basados en SQL
Sí
Zonas horarias
Sí
SSL
Sí
Subtotales
Sí
Parámetros adicionales de JDBC
Sí
Distingue entre mayúsculas y minúsculas
Sí
Tipo de ubicación
Sí
Tipo de lista
Sí
Percentil
Sí
Percentil de valores distintos
Sí
SQL Runner Show Processes
Sí
SQL Runner Describe Table
Sí
SQL Runner Show Indexes
Sí
SQL Runner Select 10
Sí
Recuento de SQL Runner
Sí
Explicación de SQL
Sí
Credenciales de OAuth 2.0
No
Comentarios contextuales
Sí
Grupo de conexiones
Sí
Esquemas HLL
No
Notoriedad agregada
Sí
PDTs incrementales
Sí
Milisegundos
Sí
Microsegundos
Sí
Vistas materializadas
No
Métricas de comparación con el periodo anterior
No
Recuento aproximado de valores distintos
No

Microsoft Azure PostgreSQL admite las siguientes funciones a partir de Looker 25.14:

Función ¿Es compatible?
Nivel de asistencia
Compatible
Looker (servicio principal de Google Cloud)
Sí
Agregados simétricos
Sí
Tablas derivadas
Sí
Tablas derivadas de SQL persistentes
Sí
Tablas derivadas nativas persistentes
Sí
Vistas estables
Sí
Eliminación de consultas
Sí
Pivotes basados en SQL
Sí
Zonas horarias
Sí
SSL
Sí
Subtotales
Sí
Parámetros adicionales de JDBC
Sí
Distingue entre mayúsculas y minúsculas
Sí
Tipo de ubicación
Sí
Tipo de lista
Sí
Percentil
Sí
Percentil de valores distintos
Sí
SQL Runner Show Processes
Sí
SQL Runner Describe Table
Sí
SQL Runner Show Indexes
Sí
SQL Runner Select 10
Sí
Recuento de SQL Runner
Sí
Explicación de SQL
Sí
Credenciales de OAuth 2.0
No
Comentarios contextuales
Sí
Grupo de conexiones
Sí
Esquemas HLL
No
Notoriedad agregada
Sí
PDTs incrementales
Sí
Milisegundos
Sí
Microsegundos
Sí
Vistas materializadas
No
Métricas de comparación con el periodo anterior
No
Recuento aproximado de valores distintos
No