Conexiones

Las conexiones permiten a Mind One comunicarse con sistemas externos. Cada conexión define las credenciales de acceso, el scope y el propósito de la integración.

Mind One soportará distintos tipos de conexión según el propósito. Actualmente el tipo disponible es Autosync: sincronización automática de datos maestros hacia un sistema de almacenamiento externo.

Conceptos generales

Scope

Una conexión puede configurarse a dos niveles:

Workspace: todas las hojas del workspace heredan la conexión automáticamente.
Hoja: la hoja tiene su propia conexión que sobreescribe la del workspace.

Workspace (conexión por defecto)
  └── Hoja A  →  hereda la del workspace
  └── Hoja B  →  hereda la del workspace
  └── Hoja C  →  tiene conexión propia (sobreescribe)

Si una hoja no tiene conexión propia y el workspace tampoco, no sincroniza y su estado queda como Skipped.

Estado

Estado	Descripción
Active	La conexión está operativa
Inactive	La conexión está deshabilitada
Error	La última operación falló

Permisos de gestión

Solo los roles Admin/Configurador pueden crear, editar y gestionar conexiones. Los demás roles no tienen acceso a estas opciones.

Probar una conexión

Antes de activar la sincronización puedes ejecutar una prueba de conexión para verificar que las credenciales son correctas sin operar sobre los datos.

Crear una conexión

Desde el menú lateral, accede a Conexiones.
Haz clic en Crear conexión.
Completa nombre, descripción opcional, tipo de plataforma y scope.
Introduce las credenciales específicas del tipo seleccionado.
Haz clic en Probar conexión.
Si la prueba es exitosa, confirma la creación.

Autosync

El Autosync es la funcionalidad que sincroniza automáticamente los datos maestros gestionados en Mind One con el lakehouse o sistema de almacenamiento externo del cliente. Utiliza la conexión configurada en el workspace o hoja para propagar los cambios al destino en tiempo real — sin intervención manual, sin exportaciones periódicas, sin procesos intermedios.

Estado de sincronización

Estado	Descripción
Syncing	Sincronización en curso
Synced	Completada con éxito
Skipped	Sin conexión configurada
Error	Falló — se muestra el mensaje de error

Resultados de sincronización

Cada operación reporta tablas creadas y actualizadas, registros sincronizados, errores con detalle por registro y duración de la operación.

Configuración de Autosync por plataforma

Sincroniza los datos maestros de Mind One con tablas en Google BigQuery. Cada hoja se mapea a una tabla dentro del dataset configurado.

Credenciales necesarias:

Parámetro	Descripción
Service Account JSON	Archivo de credenciales de la cuenta de servicio de Google Cloud
Dataset ID	Identificador del dataset donde se crearán las tablas
Data Location	Ubicación de los datos: `EU` o `US`

Configuración por scope:

A nivel de workspace todas las hojas sincronizan al mismo dataset. A nivel de hoja puedes especificar un dataset distinto.

Comportamiento:

Si la tabla no existe en BigQuery, Mind One la crea automáticamente con el schema de la hoja.
Si ya existe, actualiza los registros mediante upsert por clave primaria o reemplaza la tabla completa según la configuración.
El nombre de la tabla corresponde al Table Code de la hoja.

Permisos mínimos del Service Account:

Permiso	Propósito
`bigquery.datasets.get`	Verificar que el dataset existe
`bigquery.tables.get`	Leer la estructura de tablas existentes
`bigquery.tables.create`	Crear tablas nuevas
`bigquery.tables.update`	Modificar el schema de tablas existentes
`bigquery.tables.updateData`	Escribir y actualizar registros
`bigquery.tables.delete`	Eliminar tablas si se elimina la hoja

La forma más sencilla es asignar el rol predefinido roles/bigquery.dataEditor sobre el dataset de destino.

Sincroniza los datos maestros con tablas en Snowflake. Soporta configuración de schema por workspace o hoja.

Credenciales necesarias:

Parámetro	Descripción
Account	Identificador de cuenta (ej: `xy12345.eu-west-1`)
Usuario	Usuario con permisos de escritura
Contraseña	Contraseña del usuario
Role	Rol de Snowflake (ej: `SYSADMIN`, `DATA_ENGINEER`)
Warehouse	Compute warehouse (ej: `COMPUTE_WH`)
Database	Base de datos de destino

Configuración por scope:

A nivel de workspace define el schema de Snowflake donde se crearán las tablas.

Comportamiento:

Mind One crea la tabla si no existe con los tipos de columna mapeados desde los campos de la hoja.
Los cambios se sincronizan mediante merge (upsert) usando el campo único como clave.
El nombre de la tabla corresponde al Table Code de la hoja.

Permisos mínimos del rol:

Permiso	Propósito
`USAGE` en la database	Acceder a la base de datos
`USAGE` en el schema	Acceder al schema de destino
`CREATE TABLE` en el schema	Crear tablas nuevas
`INSERT` en las tablas	Añadir registros
`UPDATE` en las tablas	Modificar registros existentes
`DELETE` en las tablas	Eliminar registros
`MERGE` en las tablas	Operaciones de upsert
`SELECT` en las tablas	Verificar estado de los datos

Sincroniza los datos maestros con tablas Delta en el Databricks Lakehouse mediante Unity Catalog.

Credenciales necesarias:

Parámetro	Descripción
Host del workspace	Hostname del workspace sin protocolo (ej: `dbc-xxxx.cloud.databricks.com`)
HTTP Path del SQL Warehouse	Ruta HTTP del SQL Warehouse (ej: `/sql/1.0/warehouses/xxxxxxxxxxxx`)
Token de acceso	Personal Access Token o token de Service Principal
Catálogo	Nombre del catálogo en Unity Catalog (ej: `main`, `prod`)
Esquema	Nombre del schema dentro del catálogo (ej: `default`, `mind_data`)

La conexión a Databricks usa HTTPS/TLS de forma nativa.

Configuración por scope:

A nivel de workspace define el schema dentro del catálogo.

Comportamiento:

Mind One escribe en tablas Delta dentro del catálogo y schema configurados.
Si la tabla no existe, se crea con el schema de la hoja.
Las actualizaciones se realizan mediante MERGE INTO de Delta Lake.
El nombre de la tabla corresponde al Table Code de la hoja.

Permisos mínimos del Service Principal o usuario:

Permiso	Propósito
`USE CATALOG` en el catálogo	Acceder al catálogo de destino
`USE SCHEMA` en el schema	Acceder al schema de destino
`CREATE TABLE` en el schema	Crear tablas Delta nuevas
`MODIFY` en el schema	Insertar, actualizar y eliminar registros
`SELECT` en el schema	Verificar estado de los datos

Sincroniza los datos maestros con tablas en Amazon Redshift. Soporta tanto Redshift Serverless como clústeres aprovisionados.

Credenciales necesarias:

Parámetro	Descripción
Host	Endpoint del clúster o workgroup de Redshift
Puerto	Puerto de conexión (por defecto `5439`)
Base de datos	Nombre de la base de datos de destino
Usuario	Usuario con permisos de escritura
Contraseña	Contraseña del usuario
Schema	Schema de destino dentro de la base de datos

Configuración por scope:

A nivel de workspace todas las hojas sincronizan al mismo schema.

Comportamiento:

Mind One crea la tabla en Redshift si no existe con los tipos de columna mapeados desde los campos de la hoja.
Las actualizaciones se realizan mediante staging + merge para garantizar consistencia.
El nombre de la tabla corresponde al Table Code de la hoja.

Permisos mínimos del usuario:

Permiso	Propósito
`USAGE` en el schema	Acceder al schema de destino
`CREATE` en el schema	Crear tablas nuevas
`INSERT` en las tablas	Añadir registros
`UPDATE` en las tablas	Modificar registros existentes
`DELETE` en las tablas	Eliminar registros
`SELECT` en las tablas	Verificar estado de los datos

-- Concesión de permisos en Redshift
GRANT USAGE ON SCHEMA mind_data TO mind_user;
GRANT CREATE ON SCHEMA mind_data TO mind_user;
GRANT INSERT, UPDATE, DELETE, SELECT ON ALL TABLES IN SCHEMA mind_data TO mind_user;
ALTER DEFAULT PRIVILEGES IN SCHEMA mind_data
  GRANT INSERT, UPDATE, DELETE, SELECT ON TABLES TO mind_user;

Sincroniza los datos maestros con tablas en una base de datos PostgreSQL.

Credenciales necesarias:

Parámetro	Descripción
Host	Hostname o IP del servidor PostgreSQL
Puerto	Puerto de conexión (por defecto `5432`)
Base de datos	Nombre de la base de datos de destino
Usuario	Usuario con permisos de escritura
Contraseña	Contraseña del usuario
Schema	Schema de destino (por defecto `public`)
SSL	Habilitar conexión SSL (recomendado en producción)

Configuración por scope:

A nivel de workspace todas las hojas sincronizan al mismo schema.

Comportamiento:

Mind One crea la tabla si no existe con los tipos de columna mapeados desde los campos de la hoja.
Las actualizaciones se realizan mediante INSERT ... ON CONFLICT DO UPDATE (upsert nativo de PostgreSQL).
El nombre de la tabla corresponde al Table Code de la hoja.

Permisos mínimos del usuario:

Permiso	Propósito
`CONNECT` en la base de datos	Establecer conexión
`USAGE` en el schema	Acceder al schema de destino
`CREATE` en el schema	Crear tablas nuevas
`INSERT` en las tablas	Añadir registros
`UPDATE` en las tablas	Modificar registros existentes
`DELETE` en las tablas	Eliminar registros
`SELECT` en las tablas	Verificar estado de los datos

-- Concesión de permisos en PostgreSQL
GRANT CONNECT ON DATABASE mi_base_de_datos TO mind_user;
GRANT USAGE ON SCHEMA mind_data TO mind_user;
GRANT CREATE ON SCHEMA mind_data TO mind_user;
GRANT INSERT, UPDATE, DELETE, SELECT ON ALL TABLES IN SCHEMA mind_data TO mind_user;
ALTER DEFAULT PRIVILEGES IN SCHEMA mind_data
  GRANT INSERT, UPDATE, DELETE, SELECT ON TABLES TO mind_user;

La conexión con Qlik Cloud sincroniza los datos de Mind One directamente a un espacio de Qlik Cloud en formato de archivo estructurado. Mind One es la fuente de verdad: los datos se mantienen y gobiernan en Mind One y se sincronizan a Qlik Cloud como archivos listos para ser consumidos por las aplicaciones de Qlik.

Credenciales necesarias:

Parámetro	Descripción
Tenant URL	URL del tenant de Qlik Cloud (ej: `https://tu-empresa.eu.qlikcloud.com`)
API Key	Clave de API generada desde Qlik Cloud Management Console
Space ID	Identificador del espacio donde se depositarán los archivos

Formato de exportación:

Formato	Descripción	Cuándo usarlo
CSV	Texto plano separado por comas	Compatibilidad máxima

Comportamiento:

Cada vez que se guarda o aprueba un cambio, Mind One genera el archivo en el formato configurado y lo deposita en el espacio de Qlik Cloud.
El nombre del archivo corresponde al Table Code de la hoja
Las aplicaciones de Qlik Sense pueden configurarse para recargar automáticamente al detectar un nuevo archivo.

Permisos necesarios:

Requisito	Descripción
API Key activa	Generada desde Profile > API Keys en Qlik Cloud
Acceso al espacio	El usuario propietario de la API Key debe tener rol Can Edit o superior en el espacio de destino
Tipo de espacio	El espacio debe ser de tipo Shared o Managed — los espacios personales no son válidos

No se requieren permisos adicionales de infraestructura: la API Key con acceso al espacio es suficiente.

Relacionado

Workspaces — Asignar conexiones por defecto a workspaces.
Hojas — Configurar conexiones por hoja y consultar el estado de sincronización.
Mind Ocean — Data warehouse preconfigurado de Mind.

Servidor MCP