Databricks SQL Analytics concepts


This feature is in Public Preview. Contact your Databricks representative to request access.

This article introduces the set of fundamental concepts you need to understand in order to use Databricks SQL Analytics effectively.


This section describes the interfaces that Databricks supports for accessing your Databricks SQL Analytics assets: UI and API.

UI: A graphical interface to dashboards and queries, SQL endpoints, query history, and alerts.

Landing page

REST API An interface that allows you to automate tasks on SQL Analytics objects.

Data management

Visualization: A graphical presentation of the result of running a query.

Dashboard: A presentation of query visualizations and commentary.

Alert: A notification that a field returned by a query has reached a threshold.

Computation management

This section describes concepts that you need to know to run SQL queries in Databricks SQL Analytics.

Query: A valid SQL statement.

SQL endpoint: A computation resource on which you execute SQL queries.

Query history: A list of executed queries and their performance characteristics.

Authentication and authorization

This section describes concepts that you need to know when you manage Databricks SQL Analytics users and groups and their access to assets.

User and group: A user is a unique individual who has access to the system. A group is a collection of users.

Personal access token: An opaque string is used to authenticate to the REST API and by Connect BI tools to Databricks Workspace clusters to connect to SQL endpoints.

Access control list: A set of permissions attached to a principal that requires access to an object. An ACL entry specifies the object and the actions allowed on the object. Each entry in an ACL specifies a principal, action type, and object.