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.
| Comando | HTTP | Descripción |
|---|---|---|
data-sources list | GET /v1/data_sources | Listar fuentes de datos |
data-sources get | GET /v1/data_sources/{id} | Consultar fuente de datos |
data-sources update | PATCH /v1/data_sources/{id} | Actualizar fuente de datos |
data-sources delete | DELETE /v1/data_sources/{id} | Eliminar fuente de datos |
data-sources authorize | POST /v1/data_sources/{id}/authorize | Autorizar fuente MCP |
data-sources schedule | PUT /v1/data_sources/{id}/schedule | Agendar sincronización de la fuente |
data-sources spec | PUT /v1/data_sources/{id}/spec | Reemplazar spec de la fuente |
data-sources sync | POST /v1/data_sources/{id}/sync | Sincronizar fuente de datos |
data-sources catalog list | GET /v1/data_sources/catalog | Listar productos del catálogo Kobana |
data-sources catalog create | POST /v1/data_sources/catalog | Conectar producto Kobana |
data-sources database create | POST /v1/data_sources/database | Crear fuente de base de datos |
data-sources logs list | GET /v1/data_sources/{id}/logs | Listar log de solicitudes de la fuente |
data-sources logs get | GET /v1/data_sources/{id}/logs/{log_id} | Consultar solicitud de la fuente |
data-sources mcp create | POST /v1/data_sources/mcp | Crear fuente MCP |
data-sources openapi create | POST /v1/data_sources/openapi | Crear fuente OpenAPI |
data-sources openapi analyze create | POST /v1/data_sources/openapi/analyze | Analizar spec OpenAPI |
data-sources operations update | PATCH /v1/data_sources/{id}/operations/{operation_id} | Activar o desactivar operación de la fuente |
data-sources test create | POST /v1/data_sources/test | Probar 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
- Entidades
- Introspección de schema — todos los parámetros que acepta este recurso.