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 endpoints and query history.

Data management

SQL endpoint: A connection to a set of internal data objects on which you run SQL queries.

External data source: A connection to a set of external data objects on which you run SQL queries.

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 that can be run on a connection.

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 <SQA> 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 Business intelligence tools 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.