Saltar al contenido principal

Fuentes de datos

Las conexiones de donde vienen los datos del portal — una API descrita por OpenAPI, un servidor MCP, una base de datos de solo lectura o un producto Kobana del catálogo. En el dashboard aparecen como Conectores. No hay un create genérico: cada tipo tiene el suyo (openapi create, mcp create, database create, catalog create), y test create prueba una conexión antes de guardarla. sync encola la sincronización de todas las entidades de la fuente, schedule define la frecuencia y spec reemplaza la spec OpenAPI.

ComandoHTTPDescripción
data-sources listGET /v1/data_sourcesListar fuentes de datos
data-sources getGET /v1/data_sources/{id}Consultar fuente de datos
data-sources updatePATCH /v1/data_sources/{id}Actualizar fuente de datos
data-sources deleteDELETE /v1/data_sources/{id}Eliminar fuente de datos
data-sources authorizePOST /v1/data_sources/{id}/authorizeAutorizar fuente MCP
data-sources schedulePUT /v1/data_sources/{id}/scheduleAgendar sincronización de la fuente
data-sources specPUT /v1/data_sources/{id}/specReemplazar spec de la fuente
data-sources syncPOST /v1/data_sources/{id}/syncSincronizar fuente de datos
data-sources catalog listGET /v1/data_sources/catalogListar productos del catálogo Kobana
data-sources catalog createPOST /v1/data_sources/catalogConectar producto Kobana
data-sources database createPOST /v1/data_sources/databaseCrear fuente de base de datos
data-sources logs listGET /v1/data_sources/{id}/logsListar log de solicitudes de la fuente
data-sources logs getGET /v1/data_sources/{id}/logs/{log_id}Consultar solicitud de la fuente
data-sources mcp createPOST /v1/data_sources/mcpCrear fuente MCP
data-sources openapi createPOST /v1/data_sources/openapiCrear fuente OpenAPI
data-sources openapi analyze createPOST /v1/data_sources/openapi/analyzeAnalizar spec OpenAPI
data-sources operations updatePATCH /v1/data_sources/{id}/operations/{operation_id}Activar o desactivar operación de la fuente
data-sources test createPOST /v1/data_sources/testProbar conexión antes de guardar

Ejemplos​

--params lleva parámetros de query, de ruta y de encabezado (id, página, filtros, X-Workspace-Id); --json lleva el cuerpo de la solicitud; --fields limita los campos que vuelven — vale la pena en todo list/get, para ahorrar contexto. Mira Flags globales para la referencia completa.

# Listar fuentes de datos
kobana dashboards data-sources list \
--fields "id,name,kind,status,last_synced_at"

# Consultar fuente de datos
kobana dashboards data-sources get --params '{"id": "DATA_SOURCE_ID"}'

# Listar productos del catálogo Kobana
kobana dashboards data-sources catalog list

# Conectar producto Kobana
kobana dashboards data-sources catalog create \
--json '{"product": "billing", "environment": "production", "token": "TOKEN_DO_PRODUTO"}'

# Crear fuente MCP
kobana dashboards data-sources mcp create \
--json '{"name": "CRM", "url": "https://mcp.example.com/mcp", "transport": "http"}'

# Sincronizar fuente de datos
kobana dashboards data-sources sync \
--params '{"id": "DATA_SOURCE_ID"}' \
--dry-run

# Agendar sincronización de la fuente
kobana dashboards data-sources schedule \
--params '{"id": "DATA_SOURCE_ID"}' \
--json '{"cron": "0 */6 * * *", "timezone": "America/Sao_Paulo"}'

Próximos pasos​