egutierrez
5f4f1f7508
Añade campos params y output al frontmatter YAML de las 506 funciones del registry. Cada parámetro tiene descripción semántica (qué representa, unidades, rango típico) y cada función describe qué produce su output. Permite a agentes razonar sobre cadenas de composición (ej: prices → log_return → sharpe_ratio) sin leer código.
2.4 KiB
2.4 KiB
name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, params, output, tested, tests, test_file_path, file_path
| name | kind | lang | domain | version | purity | signature | description | tags | uses_functions | uses_types | returns | returns_optional | error_type | imports | params | output | tested | tests | test_file_path | file_path | |||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| metabase_execute_card | function | go | infra | 1.0.0 | impure | func MetabaseExecuteCard(client MetabaseClient, cardID int, parameters []map[string]any) (map[string]any, error) | Ejecuta la query de una card/pregunta guardada en Metabase y retorna los resultados. Soporta parametros para queries parametrizadas. Endpoint: POST /api/card/:id/query. |
|
|
false | error_go_core |
|
|
mapa con status, row_count, running_time, data.columns, data.rows, data.native_form.query | false | functions/infra/metabase_execute_card.go |
Ejemplo
// Ejecutar sin parametros
result, err := MetabaseExecuteCard(client, 42, nil)
if err != nil {
log.Fatal(err)
}
data := result["data"].(map[string]any)
rows := data["rows"].([]any)
fmt.Printf("Filas: %d\n", len(rows))
// Ejecutar con parametros
result, err := MetabaseExecuteCard(client, 42, []map[string]any{
{
"type": "category",
"target": []any{"variable", []any{"template-tag", "status"}},
"value": "active",
},
})
Notas
Estructura de la respuesta
| Campo | Tipo | Descripcion |
|---|---|---|
| status | string | "completed" o "failed" |
| row_count | float64 | Numero de filas |
| running_time | float64 | Tiempo de ejecucion en ms |
| data.columns | []string | Nombres de columnas |
| data.rows | [][]any | Filas de datos |
| data.cols | []map | Metadata de columnas (name, base_type, display_name) |
| data.native_form.query | string | SQL ejecutado |
Parametros para queries parametrizadas
[]map[string]any{
{
"type": "category", // tipo del parametro
"target": []any{"variable", []any{"template-tag", "tag"}}, // referencia al template-tag
"value": "valor", // valor a inyectar
},
}
Limite por defecto: 2000 filas. Para queries ad-hoc sin card, usar MetabaseExecuteQuery.