
Databricks Query
CertifiedRun a SQL query on Databricks
Databricks Query
Run a SQL query on Databricks
Executes a SQL statement on a Databricks cluster through the JDBC driver. Renders connection values and SQL from the RunContext, then streams results to internal storage as an Ion text file. Arrow is disabled with the Databricks JDBC driver on Java 21, which may reduce fetch throughput.
type: io.kestra.plugin.databricks.sql.QueryExamples
id: databricks_sql_query
namespace: company.team
tasks:
- id: sql_query
type: io.kestra.plugin.databricks.sql.Query
accessToken: "{{ secret('DATABRICKS_TOKEN') }}"
host: <your-host>
httpPath: <your-httpPath>
sql: SELECT 1
Properties
host *Requiredstring
Databricks host
Server hostname without protocol, e.g. adb-12345.7.azuredatabricks.net
httpPath *Requiredstring
Databricks cluster HTTP Path
HTTP Path from the cluster connection details (Advanced options → JDBC/ODBC).
sql *Requiredstring
SQL query to execute
SQL text rendered with Flow variables before execution
accessToken string
Databricks access token
Personal Access Token passed as the JDBC password; render from secrets
catalog string
Catalog used for the connection
Sets ConnCatalog on the JDBC URL when provided
pluginDefaultsRef Non-dynamicstring
Reference (ref) of the pluginDefaults to apply to this task.
properties object
Additional JDBC properties
Optional map merged into the Databricks driver properties after authentication
schema string
Schema used for the connection
Sets ConnSchema on the JDBC URL when provided
timeZoneId string
Time zone for temporal values
Timezone used when converting date/time columns; defaults to the worker JVM time zone
Outputs
size integer
Number of fetched rows
uri string
uriResult file URI
Internal storage URI of the Ion text file containing fetched rows
Metrics
fetch.size counter
Query result size