Databricks CLI commands

Note

This information applies to Databricks CLI versions 0.205 and above, which are in Public Preview. To find your version of the Databricks CLI, run databricks -v.

This article provides information about available Databricks CLI commands. This information supplements the command line help. For more information about installing and using the Databricks CLI, see Install or update the Databricks CLI and What is the Databricks CLI?.

The Databricks CLI includes the command groups listed in the following tables. Command groups contain sets of related commands, which can also contain subcommands. To output usage and syntax information for a command group, an individual command, or subcommand:

  • databricks <command-group> -h
  • databricks <command-group> <command-name> -h
  • databricks <command-group> <command-name> <subcommand-name> -h

Many CLI commands map to operations that are documented in the Azure Databricks REST API reference.

Workspace commands

Group Description and commands
fs Commands for managing files and the file system:

cat, cp, ls, mkdir, rm
git-credentials Commands for registering personal access tokens for Databricks to do operations on behalf of the user:

create, delete, get, list, update
repos Commands for allowing users to manage their git repos:

create, delete, get, list, update

get-permission-levels, get-permissions, set-permissions, update-permissions
secrets Commands for managing secrets, secret scopes, and access permissions:

create-scope, delete-acl, delete-scope, delete-secret, get-acl, get-secret, list-acls, list-scopes, list-secrets, put-acl, put-secret
workspace Commands to list, import, export, and delete notebooks and folders in the workspace:

delete, export, export-dir, get-status, import, import-dir, list, mkdirs

get-permission-levels, get-permissions, set-permissions, update-permissions

Compute commands

Group Description and commands
cluster-policies Commands to control users' ability to configure clusters based on a set of rules:

create, delete, edit, get, list

get-permission-levels, get-permissions, set-permissions, update-permissions
clusters Commands that allow you to create, start, edit, list, terminate, and delete clusters:

change-owner, create, delete, edit, events, get, list, list-node-types, list-zones, permanent-delete,pin, resize, restart, spark-versions, start, unpin

get-permission-levels, get-permissions, set-permissions, update-permissions
global-init-scripts Commands that enable workspace administrators to configure global initialization scripts for their workspace:

create, delete, get, list, update
instance-pools Commands to create, edit, delete, and list instance pools using ready-to-use cloud instances which reduces a cluster start and auto-scaling times:

create, delete, edit, get, list

get-permission-levels, get-permissions, set-permissions, update-permissions
instance-profiles Commands to allow admins to add, list, and remove instance profiles that users can launch clusters with:

add, edit, list, remove
libraries Commands to install, uninstall, and get the status of libraries on a cluster:

all-cluster-statuses, cluster-status, install, uninstall
policy-families Commands to view available policy families:

get, list

Jobs commands

Group Description and commands
jobs Commands to manage jobs:

cancel-all-runs, cancel-run, create, delete, delete-run, export-run, get, get-run, get-run-output, list, list-runs, repair-run, reset, run-now, submit, update

get-permission-levels, get-permissions, set-permissions, update-permissions

Delta Live Tables commands

Group Description and commands
pipelines Commands to create, edit, delete, start, and view details about pipelines:

create, delete, get, get-update, list-pipeline-events, list-pipelines, list-updates, start-update, stop, update

get-permission-levels, get-permissions, set-permissions, update-permissions

Machine Learning commands

Group Description and commands
experiments Commands for interacting with experiments, which are the primary unit of organization in MLflow; all MLflow runs belong to an experiment:

create-experiment, create-run, delete-experiment, delete-run, delete-runs, delete-tag, get-by-name, get-experiment, get-history, get-runGet, list-artifacts, list-experiments, log-batch, log-inputs, log-metric, log-model, log-param, restore-experiment, restore-run, restore-runs, search-experiments, search-runs, set-experiment-tag, set-tag, update-experiment, update-run

get-permission-levels, get-permissions, set-permissions, update-permissions
model-registry Commands for the Workspace Model Registry:

approve-transition-request, create-comment, create-model, create-model-version, create-transition-request, create-webhook, delete-comment, delete-model, delete-model-tag, delete-model-version, delete-model-version-tag, delete-transition-request, delete-webhook, get-latest-versions, get-model, get-model-version,get-model-version-download-uri, list-models, list-transition-requests, list-webhooks, reject-transition-request, rename-model, search-model-versions, search-models, set-model-tag, set-model-version-tag, test-registry-webhook, transition-stage, update-comment, update-model, update-model-version, update-webhook

get-permission-levels, get-permissions, set-permissions, update-permissions

Real-time serving commands

Group Description and commands
serving-endpoints Commands to create, update, and delete model serving endpoints:

build-logs, create, delete, export-metrics, get, list, logs, patch, put, query, update-config

get-permission-levels, get-permissions, set-permissions, update-permissions

Identity and access management commands

Group Description and commands
account Commands for managing Databricks accounts:

* Identity and access: access-control, groups, service-principals, users, workspace-assignment
* Unity Catalog: metastore-assignments, metastores, storage-credentials
* Settings: ip-access-lists, network-connectivity, settings
* Provisioning: credentials, encryption-keys, networks, private-access, storage, vpc-endpoints, workspaces
* Billing: billable-usage, log-delivery
* OAuth: custom-app-integration, o-auth-published-apps, published-app-integration, service-principal-secrets
auth Commands for authentication:

describe, env, login, profiles, token
current-user Commands to retrieve information about currently authenticated user or service principal:

me
groups Commands for groups that simplify identity management, making it easier to assign access to Databricks workspace, data, and other securable objects:

create, delete, get, list, patch, update
permissions Commands to create read, write, edit, update and manage access for various users on different objects and endpoints:

get, set, update

get-permission-levels
service-principals Commands for identities for use with jobs, automated tools, and systems such as scripts, apps, and CI/CD platforms:

create, delete, get, list, patch, update
users Commands for user identities recognized by Databricks and represented by email addresses:

create, delete, get, list, patch, update

get-permission-levels, get-permissions, set-permissions, update-permissions
Group Description and commands
alerts Commands to perform operations on alerts:

create, delete, get, list, update
data-sources Commands for making new query objects:

list
queries Commands to perform operations on query definitions:

create, delete, get, list, restore, update
query-history Commands to access the history of queries through SQL warehouses:

list
warehouses Commands to manage SQL warehouses, which are a compute resource that lets you run SQL commands on data objects within Databricks SQL:

create, delete, edit, get, get-workspace-warehouse-config, list, set-workspace-warehouse-config, start, stop

get-permission-levels, get-permissions, set-permissions, update-permissions

Unity Catalog commands

Group Description and commands
artifact-allowlists Commands to manage artifact allow lists. In Databricks Runtime 13.3 and above, you can add libraries and init scripts to the allowlist in UC so that users can leverage these artifacts on compute configured with shared access mode:

get, update
catalogs Commands to manage catalogs, the first layer of Unity Catalog's three-level namespace:

create, delete, get, list, update
connections Commands to create a connection to an external data source:

create, delete, get, list, update
external-locations Commands to manage external locations, which combine a cloud storage path with a storage credential that authorizes access to the cloud storage path:

create, delete, get, list, update
functions Commands to manage User-Defined Functions (UDFs) in Unity Catalog:

create, delete, get, list, update
grants Commands to grant access to data in Unity Catalog:

get, get-effective, update
metastores Commands to manage metastores, which are the top-level container of objects in Unity Catalog:

assign, create, current, delete, get, list, summary, unassign, update, update-assignment
model-versions Commands to manage model versions. Databricks provides a hosted version of MLflow Model Registry in Unity Catalog.

delete, get, get-by-alias, list, update
online-tables Commands to manage online tables, which provide lower latency and higher QPS access to data from Delta tables:

create, delete, get
quality-monitors Commands to manage monitors, which compute and monitor data or model quality metrics for a table over time:

create, delete, get, get-refresh, list-refreshes, run-refresh, update
registered-models Commands to manage registered models. Databricks provides a hosted version of MLflow Model Registry in Unity Catalog.

create, delete, delete-alias, get, list, set-alias, update
schemas Commands to manage schemas, which are the second layer of Unity Catalog's three-level namespace:

create, delete, get, list, update
storage-credentials Commands to manage storage credentials, which are an authentication and authorization mechanism for accessing data stored on your cloud tenant:

create, delete, get, list, update, validate
system-schemas Commands to manage system schemas, which are schemas that live within the system catalog:

disable, enable, list
table-constraints Commands to manage primary key and foreign key constraints that encode relationships between fields in tables:

create, delete
tables Commands to manage tables, which resides in the third layer of Unity Catalog's three-level namespace:

delete, exists, get, list, list-summaries
volumes Commands to manage volumes, which are a Unity Catalog (UC) capability for accessing, storing, governing, organizing and processing files:

create, delete, list, read, update
workspace-bindings Commands to manage securable workspace bindings. Securables in Databricks can be configured as OPEN or ISOLATED.

get, get-bindings, update, update-bindings

Delta sharing commands

Group Description and commands
providers Commands to manage data providers, which represent the organizations who share data:

create, delete, get, list, list-shares, update
recipient-activation Commands to manage recipient activation, which is only applicable in the open sharing model where the recipient object has the TOKEN authentication type:

get-activation-url-info, retrieve-token
recipients Commands to manage recipients, which you create using :method:recipients/create to represent an organization which you want to allow access to shares:

create, delete, get, list, rotate-token, update

share-permissions
shares Commands to manage shares, which are containers instantiated with :method:shares/create:

create, delete, get, list, update

share-permissions, update-permissions

Settings commands

Group Description and commands
ip-access-lists Commands to enable admins to configure IP access lists:

create, delete, get, list, replace, update
settings Commands to allow users to manage settings at the workspace level:

automatic-cluster-update, csp-enablement, default-namespace, esm-enablement, restrict-workspace-admins
token-management Commands that enable administrators to get all tokens and delete tokens for other users:

create-obo-token, delete, get, list

get-permission-levels, get-permissions, set-permissions, update-permissions
tokens Commands to create, list, and revoke tokens that can be used to authenticate and access Databricks REST APIs:

create, delete, list
workspace-conf Commands to update workspace settings:

get-status, set-status

Developer tools commands

Group Description and commands
bundle Commands to manage Databricks Asset Bundles, which let you express your Databricks projects as code:

deploy, deployment, destroy, generate, init, run, schema, sync, validate
sync Synchronize a local directory to a workspace directory.

Vector search commands

Group Description and commands
vector-search-endpoints Commands to manage vector search endpoints, which represent the compute resources to host vector search indexes:

create-endpoint, delete-endpoint, get-endpoint, list-endpoints
vector-search-indexes Commands to manage vector search indexes, an efficient representation of your embedding vectors that supports real-time and efficient approximate nearest neighbor (ANN) search queries:

create-index, delete-data-vector-index, delete-index, get-index, list-indexes, query-index, sync-index, upsert-data-vector-index

Dashboard commands

Group Description and commands
dashboards Commands for modifying dashboards:

create, delete, get, list, restore, update
lakeview Commands that provide specific management operations for AI/BI dashboards:

create, get, get-published, migrate, publish, trash, unpublish, update

Additional commands

Group Description and commands
api Commands to make requests to the Databricks REST API:

delete, get, head, patch, post, put
completion Commands to generate the autocompletion script for the specified shell:

bash, fish, powershell, zsh
configure Configure the Databricks CLI.
help Output usage information for any command.
labs Commands to manage Databricks Labs installations:

clear-cache, install, installed, list, show, uninstall, upgrade
version Retrieve the version of the CLI currently being used.

Global flags

The following flags are available to all Databricks CLI commands. Note that some flags do not apply to some commands. For detailed information about specific commands and their flags, see the command-line help.

Flag Description
-h or --help Display help for the Databricks CLI or the related command group or the related command.
-e or --environment string A string representing the bundle environment to use if applicable for the related command.
--log-file A string representing the to write output logs to. If this flag is not specified then the default is to write output logs to stderr.
--log-format text to write output logs to text or json to write output logs to JSON. If this flag is not specified then output logs are written as text.
--log-level A string representing the log format level. If not specified then the log format level is disabled.
-o or --output text to write output as text or json to write output as JSON. If this flag is not specified then output is written as text.
-p or --profile A string representing the named configuration profile to use within your .databrickscfg file. If this flag is not specified then the DEFAULT named profile is used if one exists. You can press Tab after --profile or -p to display a list of existing available configuration profiles to choose from instead of entering the configuration profile name manually.
--progress-format The format for progress logs to display (default (the default) or append or inplace or json).