Skip to main content

Query Run Output

POST 
/runs/:run_id/query

Execute a read-only SQL query against a run's SUT output Parquet.

The query must use run_output as the virtual table name::

SELECT scenario, AVG(bleu) AS avg_bleu, COUNT(*) AS n FROM run_output GROUP BY scenario ORDER BY avg_bleu ASC

The backend rewrites run_output to the actual MinIO Parquet path before execution. Only SELECT statements targeting run_output are accepted; any other DDL or table references are rejected with 422.

Results are capped at limit rows (max 1000; default 1000).

Returns 404 if the run does not exist, or if it has neither completed nor failed with output already written. Returns 422 if the SQL is invalid or contains disallowed patterns.

Request​

Responses​

Successful Response