Cómo conectarse a la base de datos de informes
Beta. La base de datos de informes está actualmente en beta; los detalles en esta página pueden cambiar.
Qué necesitará
Tras habilitar la base de datos de informes, Azumuta proporciona los siguientes datos de conexión:
- Host — la dirección de su base de datos de informes.
- Port — el puerto de conexión.
- Database name — la base de datos a la que conectar.
- Username y password — credenciales de solo lectura para su espacio de trabajo.
- Schema name — el área dentro de la base de datos que contiene los datos de su espacio de trabajo. Tiene este aspecto:
company_<your-workspace-id>.
Trate estas credenciales como una contraseña. Cualquiera que las tenga puede leer sus datos de informes. Compártalas únicamente con las personas que las necesiten y guárdelas en un gestor de secretos en lugar de en documentos compartidos o en el código fuente.
Se requieren conexiones seguras (SSL)
La base de datos de informes solo acepta conexiones cifradas. Cuando se conecte, asegúrese de que SSL/TLS esté habilitado. En la mayoría de las herramientas esto significa establecer el modo SSL en require (o marcar una casilla "Usar SSL").
Conexión con un cliente SQL
Puede usar cualquier cliente compatible con PostgreSQL, como psql, DBeaver, TablePlus o pgAdmin. Una cadena de conexión tiene este aspecto:
postgresql://<username>:<password>@<host>:<port>/<database>?sslmode=require
Después de conectarse, configure su sesión para usar el esquema de su espacio de trabajo y así poder referirse a las tablas por sus nombres cortos:
set search_path to "company_<your-workspace-id>";
Para confirmar que todo funciona, liste las tablas disponibles:
select table_name
from information_schema.tables
where table_schema = 'company_<your-workspace-id>'
order by table_name;
Conexión con una herramienta de BI
Herramientas como Power BI, Tableau, Metabase, Looker y Grafana admiten PostgreSQL. En general:
- Añada una nueva fuente de datos y elija el conector PostgreSQL.
- Introduzca el host, puerto, nombre de la base de datos, nombre de usuario y contraseña proporcionados por Azumuta.
- Habilite SSL (establezca SSL mode en require).
- Cuando le soliciten un esquema, seleccione el esquema de su espacio de trabajo (
company_<your-workspace-id>).
Una vez conectado, sus tablas aparecerán en la herramienta y podrá empezar a crear paneles. Consulte Consultas analíticas de ejemplo para obtener ideas y empezar.
Nota sobre el rendimiento
La base de datos de informes es una copia, por lo que las consultas pesadas no ralentizarán su espacio de trabajo activo de Azumuta. Aun así, es buena práctica filtrar y agregar en SQL en lugar de importar tablas completas en su herramienta de BI.