Ten en cuenta que estás viendo la documentación de Looker. Para obtener documentación de Looker Studio, visita https://support.google.com/looker-studio.

Se usó la API de Cloud Translation para traducir esta página.

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

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

En el caso de AlloyDB para PostgreSQL, Amazon RDS para PostgreSQL y Amazon Aurora PostgreSQL, Looker tiene compatibilidad con la integración. Para crear una conexión para estos dialectos, selecciona PostgreSQL 9.5 y versiones posteriores en el menú desplegable Dialecto de la página Nueva conexión.

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

Encripta el tráfico de red

Se recomienda 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

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

Si usas una instancia de Looker (núcleo de Google Cloud) y quieres usar las ADC, usa el nombre de usuario de la cuenta de servicio suplantada que agregaste 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 con .gserviceaccount.com, quita la parte .gserviceaccount.com del nombre de usuario. Después de truncarlo, el nombre de usuario se verá como service-<project number>@gcp-sa-looker.iam.

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

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

Nota: Omite este paso si estás en una instancia de Looker (Google Cloud Core) y deseas usar las credenciales predeterminadas de la aplicación. No necesitas crear una cuenta de usuario. En su lugar, usarás una cuenta de servicio existente.
```
CREATE USER USERNAME WITH ENCRYPTED PASSWORD 'PASSWORD';
```

Otorga permisos al usuario de la base de datos para que Looker pueda realizar acciones en ella:

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;

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 USERNAME;
```

Para asegurarte de que las tablas futuras que agregues 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 debas modificar los comandos anteriores. Si otro usuario o rol crea tablas para las que el usuario de Looker necesitará permisos en el futuro, debes especificar un rol o usuario objetivo para aplicar los permisos otorgados al 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 web_app crea tablas y quieres que el usuario looker pueda usarlas, debes ejecutar una sentencia GRANT para otorgarle permisos al usuario looker en las tablas que crea el usuario web_app. El rol o usuario de destino en este caso es el usuario web_app, lo que significa que deseas alterar los privilegios en las tablas que crea web_app para que el usuario looker pueda tener permisos para leerlas. 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 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 en blanco al usuario de Looker:

ALTER SCHEMA SCHEMA_NAME OWNER TO USERNAME;

Configura `search_path`

Antes de conectar Looker a tu base de datos, debes configurar un search_path adecuado, que Looker SQL Runner pueda usar para recuperar ciertos 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

Cómo 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:

En la sección Administrador de Looker, selecciona Conexiones y, luego, haz clic en Agregar conexión.
En el menú desplegable Dialecto, selecciona el nombre del dialecto de la base de datos. Para el dialecto de AlloyDB para PostgreSQL, selecciona PostgreSQL 9.5 o versiones posteriores.

Nota: Si usas una instancia de Looker (Google Cloud Core) y no ves tu dialecto en el menú desplegable Dialecto, consulta la documentación de Looker (Google Cloud Core) para verificar que el dialecto sea compatible con las instancias de Looker (Google Cloud Core).
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 información.
Para verificar que la conexión se haya establecido correctamente, haz clic en Probar. Consulta la página de documentación 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, 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 24.20:

Atributo	¿Es compatible?
Nivel de asistencia	Admitido
Looker (Google Cloud Core)	Sí
Agregaciones simétricas	Sí
Tablas derivadas	Sí
Tablas derivadas de SQL persistentes	Sí
Tablas derivadas persistentes nativas	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 mayúsculas de minúsculas	Sí
Tipo de ubicación	Sí
Tipo de lista	Sí
Percentil	Sí
Percentil de valores distintos	Sí
Cómo mostrar procesos en el Ejecutor de SQL	Sí
Tabla de descripción de SQL Runner	Sí
Índices de Show de SQL Runner	Sí
SQL Runner Select 10	Sí
Cantidad de Ejecutor de SQL	Sí
Explicación de SQL	Sí
Credenciales de OAuth	No
Comentarios contextuales	Sí
Agrupación de conexiones	Sí
Esbozos de HLL	No
Aggregate Awareness	Sí
PDT incrementales	Sí
Milisegundos	Sí
Microsegundos	Sí
Vistas materializadas	No
Distinción de recuento aproximado	No

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

Atributo	¿Es compatible?
Nivel de asistencia	Admitido
Looker (Google Cloud Core)	Sí
Agregaciones simétricas	Sí
Tablas derivadas	Sí
Tablas derivadas de SQL persistentes	Sí
Tablas derivadas persistentes nativas	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 mayúsculas de minúsculas	Sí
Tipo de ubicación	Sí
Tipo de lista	Sí
Percentil	Sí
Percentil de valores distintos	Sí
Cómo mostrar procesos en el Ejecutor de SQL	Sí
Tabla de descripción de SQL Runner	Sí
Índices de Show de SQL Runner	Sí
SQL Runner Select 10	Sí
Cantidad de Ejecutor de SQL	Sí
Explicación de SQL	Sí
Credenciales de OAuth	No
Comentarios contextuales	Sí
Agrupación de conexiones	Sí
Esbozos de HLL	No
Aggregate Awareness	Sí
PDT incrementales	Sí
Milisegundos	Sí
Microsegundos	Sí
Vistas materializadas	No
Distinción de recuento aproximado	No

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

Atributo	¿Es compatible?
Nivel de asistencia	Admitido
Looker (Google Cloud Core)	Sí
Agregaciones simétricas	Sí
Tablas derivadas	Sí
Tablas derivadas de SQL persistentes	Sí
Tablas derivadas persistentes nativas	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 mayúsculas de minúsculas	Sí
Tipo de ubicación	Sí
Tipo de lista	Sí
Percentil	Sí
Percentil de valores distintos	Sí
Cómo mostrar procesos en el Ejecutor de SQL	Sí
Tabla de descripción de SQL Runner	Sí
Índices de Show de SQL Runner	Sí
SQL Runner Select 10	Sí
Cantidad de Ejecutor de SQL	Sí
Explicación de SQL	Sí
Credenciales de OAuth	No
Comentarios contextuales	Sí
Agrupación de conexiones	Sí
Esbozos de HLL	No
Aggregate Awareness	Sí
PDT incrementales	Sí
Milisegundos	Sí
Microsegundos	Sí
Vistas materializadas	No
Distinción de recuento aproximado	No