FelderaExecute Ad-hoc SQL
Execute ad-hoc SQL in a running or paused pipeline.
The evaluation is not incremental.
Authentication
| Scheme | Type | Details |
|---|---|---|
JSON web token (JWT) or API key | Bearer token | Authorization header · Use a JWT token obtained via an OAuth2/OIDC login workflow or an API key obtained via the `/v0/api-keys` endpoint. |
Parameters
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
pipeline_name | string | Yes | Unique pipeline name |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
sql | string | Yes | SQL query to execute |
format | AdHocResultFormat | Yes | Input data format, e.g., 'text', 'json' or 'parquet' |
Response
Ad-hoc SQL query result
- string (binary)
curl -X GET '/v0/pipelines/{pipeline_name}/query?sql=%3Csql%3E&format=%3Cformat%3E' \
-H 'Authorization: Bearer YOUR_TOKEN'Ad-hoc SQL query result
"string"{
"message": "Unknown pipeline name 'non-existent-pipeline'",
"error_code": "UnknownPipelineName",
"details": {
"pipeline_name": "non-existent-pipeline"
}
}