# About the Databricks activities

> Databricks activities for the Integration Service connector, for job orchestration, notebook management, Unity Catalog, Genie, and Vector Search.

:::note
The Databricks connector is available as a preview feature.
:::

Databricks activities enable you to automate a Databricks workspace over its REST API: submit and monitor notebook job runs, manage Unity Catalog volumes and functions, import and export notebooks, converse with Genie, and query Vector Search indexes.

## How it works

To enable the outbound automation between UiPath and Databricks, the activities establish an authenticated connection using the UiPath Databricks connector. The connector calls the Databricks workspace REST API as a service principal, using OAuth 2.0 client credentials (machine-to-machine).

Building your first project requires completing the steps in the [Databricks authentication](https://docs.uipath.com/integration-service/automation-cloud/latest/user-guide/uipath-databricks-http-authentication) guide from the connector documentation first.

## Long-running operations

Several Databricks operations are asynchronous. The activities follow the Databricks API model for these:

* **SQL** — [Execute a SQL Query](https://docs.uipath.com/activities/other/latest/integration-service/uipath-databricks-http-execute-sql-query) waits synchronously for the duration set in **Wait Timeout**. For statements that run longer than that, setting **Wait Timeout** to `0s` and **On Wait Timeout** to `CONTINUE` causes the activity to return a statement ID immediately, which can then be polled with [Get SQL Statement Result](https://docs.uipath.com/activities/other/latest/integration-service/uipath-databricks-http-get-sql-statement-result).
* **Jobs** — [Run a Job Now](https://docs.uipath.com/activities/other/latest/integration-service/uipath-databricks-http-run-job-now) and [Run a Notebook](https://docs.uipath.com/activities/other/latest/integration-service/uipath-databricks-http-run-notebook) return a run ID immediately, which can be polled with [Get a Job Run](https://docs.uipath.com/activities/other/latest/integration-service/uipath-databricks-http-get-job-run) until the run reaches a terminal state; the result is then available through [Get a Job Run Output](https://docs.uipath.com/activities/other/latest/integration-service/uipath-databricks-http-get-job-run-output).
* **Genie** — [Start a Conversation](https://docs.uipath.com/activities/other/latest/integration-service/uipath-databricks-http-start-conversation) and [Create a Conversation Message](https://docs.uipath.com/activities/other/latest/integration-service/uipath-databricks-http-create-conversation-message) return a message that is still being generated, which can be polled with [Get a Conversation Message](https://docs.uipath.com/activities/other/latest/integration-service/uipath-databricks-http-get-conversation-message) until its status is `COMPLETED`; the rows are then available through [Get Genie Query Results](https://docs.uipath.com/activities/other/latest/integration-service/uipath-databricks-http-get-genie-query-results).

## Endpoints without a predefined activity

Use the [Databricks HTTP Request](https://docs.uipath.com/activities/other/latest/integration-service/uipath-databricks-http-http-request) activity to call any Databricks workspace REST API endpoint with the same connection.

## Triggers

This connector does not support triggers.