Skip to main content

Databricks Connector

Databricks Manage compute, workflow jobs, ML models, SQL queries and more within a Databricks workspace.

Connections

Databricks Personal Access Token

InputCommentsDefault
HostThe hostname of your Databricks instance. Include the entire domain name. For example, dbc-1234567890123456.cloud.databricks.com
Personal Access TokenFrom DataBricks, go to User Settings > Developer > Access Tokens > Manage > Generate New Token

Databricks Workspace Service Principal

This connection uses OAuth 2.0, a common authentication mechanism for integrations. Read about how OAuth 2.0 works here.

InputCommentsDefault
Token URLThe OAuth 2.0 Token URL for your Databricks workspace. Replace REPLACE-ME in https://dbc-REPLACE-ME.cloud.databricks.com/oidc/v1/token to reflect your workspace's URL.https://dbc-REPLACE-ME.cloud.databricks.com/oidc/v1/token
ScopesOAuth scopes to request. Defaults to all-apis.all-apis
Service Principal Client IDClient ID of your Service Principal. Make sure that your service principal has been granted the necessary permissions in your Databricks workspace. https://docs.databricks.com/en/dev-tools/auth/oauth-m2m.html#step-2-assign-workspace-level-permissions-to-the-databricks-service-principal
Service Principal Client SecretClient Secret of your Service Principal.

Actions

Create Execution Context

Create a Databricks execution context

InputCommentsDefault
Connection
Cluster IDThe unique identifier for the cluster
Languagepython
Debug RequestEnabling this flag will log out the current request.false

Get Cluster

Get a Databricks cluster by ID

InputCommentsDefault
Connection
Cluster IDThe unique identifier for the cluster
Debug RequestEnabling this flag will log out the current request.false

Get Command Status

Gets the status of and, if available, the results from a currently executing command.

InputCommentsDefault
Connection
Cluster IDThe unique identifier for the cluster
Execution Context IDThe ID of the execution context, likely created by the Create Execution Context action.
Command IDThe ID of the command to get the status of
Debug RequestEnabling this flag will log out the current request.false

Get Current User

Get the currently authenticated Databricks user or service principal.

InputCommentsDefault
Connection
Debug RequestEnabling this flag will log out the current request.false

Get SQL Warehouse

Get an SQL Warehouse

InputCommentsDefault
Connection
Warehouse IDThe ID of an SQL warehouse
Debug RequestEnabling this flag will log out the current request.false

List Clusters

Return information about all pinned clusters, active clusters, up to 200 of the most recently terminated all-purpose clusters in the past 30 days, and up to 30 of the most recently terminated job clusters in the past 30 days.

InputCommentsDefault
Connection
Debug RequestEnabling this flag will log out the current request.false

List Node Types

Returns a list of supported Spark node types. These node types can be used to launch a cluster.

InputCommentsDefault
Connection
Debug RequestEnabling this flag will log out the current request.false

List SQL Warehouses

List all SQL Warehouses in the Databricks workspace

InputCommentsDefault
Connection
Debug RequestEnabling this flag will log out the current request.false

Raw Request

Send raw HTTP request to the Databricks API.

InputCommentsDefault
Connection
URLThe URL https:///api/ is prepended to the URL you provide here. For example, if you provide "/2.0/clusters/list", the full URL will be "https://${host}/api/2.0/clusters/list". You can also provide a full URL with protocol (i.e. "https://accounts.cloud.databricks.com/api/2.0/accounts/{account_id}/scim/v2/Groups" to override the prepended base URL.
MethodThe HTTP method to use.
DataThe HTTP body payload to send to the URL.
Form DataThe Form Data to be sent as a multipart form upload.
File DataFile Data to be sent as a multipart form upload.
File Data File NamesFile names to apply to the file data inputs. Keys must match the file data keys above.
Query ParameterA list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2.
HeaderA list of headers to send with the request.
Response TypeThe type of data you expect in the response. You can request json, text, or binary data.json
TimeoutThe maximum time that a client will await a response to its request
Debug RequestEnabling this flag will log out the current request.false
Retry Delay (ms)The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled.0
Retry On All ErrorsIf true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors.false
Max Retry CountThe maximum number of retries to attempt. Specify 0 for no retries.0
Use Exponential BackoffSpecifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored.false

Restart Cluster

Restart a Databricks cluster by ID

InputCommentsDefault
Connection
Cluster IDThe unique identifier for the cluster
Debug RequestEnabling this flag will log out the current request.false

Run Command

Run a command in a Databricks execution context

InputCommentsDefault
Connection
Cluster IDThe unique identifier for the cluster
Execution Context IDThe ID of the execution context, likely created by the Create Execution Context action.
Languagepython
CommandThe executable code to run in the execution context
Debug RequestEnabling this flag will log out the current request.false

SQL: Execute an SQL Statement

Run a SQL query in the Databricks workspace. You can choose to wait for the result or asynchronously issue the request and return the statement ID.

InputCommentsDefault
Connection
Warehouse IDThe ID of an SQL warehouse
SQL StatementThe SQL statement to run
SQL ParametersThe parameters to use in the SQL statement. This should represent an array of objects, and each object should have a name and value. For example, [{ "name": "my_name", "value": "the name" }
Debug RequestEnabling this flag will log out the current request.false

Start SQL Warehouse

Start an SQL Warehouse

InputCommentsDefault
Connection
Warehouse IDThe ID of an SQL warehouse
Debug RequestEnabling this flag will log out the current request.false

Start Terminated Cluster

Start a terminated Databricks cluster by ID

InputCommentsDefault
Connection
Cluster IDThe unique identifier for the cluster
Debug RequestEnabling this flag will log out the current request.false

Stop SQL Warehouse

Stop an SQL Warehouse

InputCommentsDefault
Connection
Warehouse IDThe ID of an SQL warehouse
Debug RequestEnabling this flag will log out the current request.false

Terminate Cluster

Terminate a Databricks cluster by ID

InputCommentsDefault
Connection
Cluster IDThe unique identifier for the cluster
Debug RequestEnabling this flag will log out the current request.false