fn_registry/functions/infra/metabase_execute_query.md

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_query	function	go	infra	1.0.0	impure	func MetabaseExecuteQuery(client MetabaseClient, databaseID int, sql string, maxResults int) (map[string]any, error)	Ejecuta una query SQL ad-hoc contra una database de Metabase sin guardarla como card. Util para consultas rapidas y exploracion. Endpoint: POST /api/dataset.	metabase query execute sql dataset api		MetabaseClient_go_infra		false	error_go_core	fmt	name desc client cliente MetabaseClient autenticado name desc databaseID ID de la database en Metabase name desc sql query SQL a ejecutar name desc maxResults limite de filas (0 = default 2000)	mapa con status, row_count, running_time, data.columns, data.rows	false			functions/infra/metabase_execute_query.go

Ejemplo

// Query simple
result, err := MetabaseExecuteQuery(client, 1, "SELECT * FROM users LIMIT 10", 0)
if err != nil {
    log.Fatal(err)
}
data := result["data"].(map[string]any)
rows := data["rows"].([]any)

// Query con limite custom
result, err := MetabaseExecuteQuery(client, 1, "SELECT * FROM orders", 5000)

Notas

Parametros para un LLM

Parametro	Tipo	Requerido	Descripcion
client	MetabaseClient	si	Cliente autenticado
databaseID	int	si	ID de la database en Metabase (obtener con GET /api/database)
sql	string	si	Query SQL a ejecutar
maxResults	int	no	Limite de filas. 0 = default 2000

Diferencia con MetabaseExecuteCard

• MetabaseExecuteQuery: query ad-hoc, no se guarda. Usa POST /api/dataset.
• MetabaseExecuteCard: ejecuta una card ya guardada. Usa POST /api/card/:id/query.

Usar esta funcion para exploracion rapida. Si la query se va a reutilizar, crear una card con MetabaseCreateCard.

Estructura de la respuesta

Misma estructura que MetabaseExecuteCard:

• data.columns: nombres de columnas
• data.rows: filas de datos
• row_count: numero de filas
• running_time: tiempo en ms
• status: "completed" o "failed"