fn_registry/python/functions/metabase/metabase_validate_sql.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_validate_sql	function	py	infra	1.0.0	impure	def metabase_validate_sql(client: MetabaseClient, database_id: int, sql: str, max_rows: int = 0) -> dict	Valida sintaxis y referencias de una query SQL ejecutandola contra Metabase via POST /api/dataset. Captura tanto errores HTTP como errores embebidos en el body (Metabase a veces devuelve 200 con status failed). Retorna ok, error y rows_returned.	metabase validation sql pre-flight impure query syntax-check	metabase_execute_query_py_infra metabase_auth_py_infra			false	error_go_core	httpx	name desc client instancia autenticada de MetabaseClient con sesion activa name desc database_id ID de la base de datos en Metabase contra la que ejecutar el SQL name desc sql sentencia SQL a validar (SELECT, WITH, etc.) — se ejecuta realmente contra la BD name desc max_rows limite de filas a retornar durante la validacion para minimizar carga (0 = default de Metabase, tipicamente 2000)	dict con tres claves: ok (bool) indica si la query se ejecuto sin error; error (str|None) mensaje de error si ok=False; rows_returned (int) numero de filas devueltas si ok=True	false			python/functions/metabase/validation.py

Ejemplo

result = metabase_validate_sql(client, database_id=1, sql="SELECT id FROM orders LIMIT 1")
if not result["ok"]:
    print(f"SQL invalido: {result['error']}")
else:
    print(f"SQL valido, {result['rows_returned']} filas retornadas")

Notas

No tiene tests automatizados porque requiere una instancia Metabase corriendo con una base de datos real. Para testear manualmente:

client = metabase_auth("http://localhost:3000", "admin@example.com", "pass")
result = metabase_validate_sql(client, 1, "SELECT * FROM tabla_inexistente")
# result["ok"] == False, result["error"] == "Table 'tabla_inexistente' not found"

Comportamiento ante errores:

• httpx.HTTPStatusError (4xx/5xx): extrae el campo error o message del JSON del response de Metabase.
• Body con status: "failed" (Metabase devuelve 200 en algunos errores de query): captura el campo error del body.
• Cualquier otra excepcion: convierte a string y la incluye en el campo error.

Usa metabase_execute_query internamente, que mapea a POST /api/dataset.