Fuentes de datos

Conectar Supabase, PostgreSQL, MySQL, SQL Server, Snowflake y Databricks, elegir las tablas expuestas y seguir el estado de la conexión.

Una fuente de datos es una base de datos que Rowgate lee para responder las preguntas del equipo. Toda fuente se usa en modo solo lectura y la credencial se guarda cifrada.

Conectar una base de datos

En Fuentes de datos, haz clic en Agregar fuente y elige el tipo de base de datos.
Ponle un nombre a la fuente (por ejemplo, “ERP” o “Producción”).
Completa los datos de conexión (más abajo, por base de datos) y haz clic en Probar conexión.
Con la prueba aprobada, haz clic en Continuar, marca las tablas que la IA puede consultar y haz clic en Guardar con N tablas.

La cantidad de fuentes depende del plan. Al llegar al límite, el botón Agregar fuente queda desactivado hasta que contrates una conexión adicional en Configuración.

Supabase

Ingresa la URL del proyecto (https://<projeto>.supabase.co) y la clave de servicio (service_role). Las dos están en Supabase, en Project Settings › API.

Rowgate lee los schemas que publica la API del proyecto. Para incluir otro schema además de public, agrégalo en Project Settings › Data API › Exposed schemas y haz clic en Volver a leer la estructura en Rowgate.

PostgreSQL, MySQL y SQL Server

Ingresa host, puerto, base de datos, usuario y contraseña. El servidor tiene que aceptar conexiones externas con SSL (en SQL Server, cifrado).

SSL: “Exigir SSL” cifra la conexión. “Exigir SSL y verificar el certificado” es más seguro, pero el certificado tiene que ser de una autoridad reconocida y válido para ese host.
Red: la dirección tiene que ser pública. Los hosts que apuntan a una red interna (localhost o IP privada) se rechazan.
Versiones: MySQL 8 y MariaDB; SQL Server 2017 o posterior y Azure SQL.

Snowflake

Ingresa la cuenta (identificador orgname-accountname, en Snowsight › Admin › Accounts), el usuario, el warehouse, la base de datos y, si quieres, el rol (vacío usa el rol predeterminado del usuario).

La autenticación puede ser por par de claves (recomendado: pega la clave privada PEM sin contraseña y registra la clave pública en el usuario de Snowflake) o por token de acceso programático, generado en Snowsight › Settings › Authentication.

Databricks

Ingresa la dirección del workspace, la ruta del SQL warehouse, el catálogo de Unity Catalog y un token de acceso. Usa un service principal con permiso de solo lectura en el catálogo.

Usuario de solo lectura

Recomendamos un usuario de base de datos exclusivo para Rowgate, con permiso solo de lectura en las tablas que se van a habilitar. La pantalla de conexión trae el comando listo en Cómo crear un usuario de solo lectura. Para PostgreSQL, por ejemplo:

CREATE ROLE rowgate_leitor LOGIN PASSWORD '<senha forte>';
GRANT USAGE ON SCHEMA public TO rowgate_leitor;
GRANT SELECT ON ALL TABLES IN SCHEMA public TO rowgate_leitor;

PostgreSQL: repite los dos GRANT para cada schema que la IA puede leer.
MySQL: GRANT SELECT, SHOW VIEW ON <banco>.* para el usuario, creado con REQUIRE SSL.
SQL Server: un login con el rol db_datareader en la base de datos. En Azure SQL, ejecuta el CREATE LOGIN en la base master.
Snowflake: un rol con USAGE en el warehouse, en la base de datos y en el schema, y SELECT en las tablas.
Databricks: CAN USE en el warehouse y USE CATALOG, USE SCHEMA y SELECT en Unity Catalog.

Aunque el usuario tenga más permisos, Rowgate solo envía consultas de lectura. En PostgreSQL y MySQL, cada consulta se ejecuta en una transacción de solo lectura; en SQL Server, en una transacción que siempre se revierte al final.

Elegir las tablas expuestas

Abre la fuente (botón Tablas) para ver todas las tablas, agrupadas por schema, y activar o desactivar cada una. Solo las tablas expuestas pueden incluirse en un perfil de acceso.

Una tabla desactivada queda invisible para todos los perfiles.
Una tabla o un schema nuevo encontrado en una relectura entra desactivado: nada nuevo queda visible sin que tú lo actives.

Volver a leer la estructura

¿Creaste una tabla o una columna en la base de datos? En la página de la fuente, haz clic en Volver a leer la estructura. Rowgate también revisa cada fuente automáticamente de vez en cuando.

Estado de la conexión

Operativa: la última verificación fue exitosa.
Con error: la base de datos no respondió o rechazó el acceso. El mensaje con el motivo aparece en la tarjeta de la fuente. Consulta Solución de problemas.
Pausada: pausaste la fuente en el menú ⋯ › Pausar fuente. Para reactivarla, usa Reanudar fuente.

La tarjeta también muestra las tablas expuestas, la latencia de la última verificación y cuándo se hizo.