Partilhar via


Comandos da CLI do Databricks

Nota

Essas informações se aplicam às versões 0.205 e superiores da CLI do Databricks. A CLI do Databricks está em Visualização Pública.

O uso da CLI do Databricks está sujeito à Licença do Databricks e ao Aviso de Privacidade do Databricks, incluindo quaisquer disposições de Dados de Uso.

Este artigo fornece informações sobre os comandos disponíveis da CLI do Databricks. Essas informações complementam a ajuda da linha de comando. Para obter mais informações sobre como instalar e usar a CLI do Databricks, consulte Instalar ou update a e da CLI do Databricks O que é a CLI do Databricks?.

A CLI do Databricks inclui os grupos de comandos listados no tablesa seguir. Os grupos de comandos contêm conjuntos de comandos relacionados, que também podem conter subcomandos. Para obter informações de uso e sintaxe de saída para um grupo de comandos, um comando individual ou subcomando:

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

Muitos comandos da CLI são mapeados para operações documentadas na referência da API REST do Azure Databricks.

Comandos do espaço de trabalho

Agrupar Descrição e comandos
FS Comandos para gerenciar arquivos e o sistema de arquivos:

cat, cp, ls, mkdir, rm
git-credentials Comandos para registrar tokens de acesso pessoais para que o Databricks faça operações em nome do usuário:

create, delete, get, list, update
repos Comandos para permitir que os usuários gerenciem seus repositórios git:

create, delete, get, list, update

get-permission-levels, get-permissions, set-permissions, update-permissions
secrets Comandos para gerenciar segredos, escopos secretos e permissões de acesso:

create-scope, delete-acl, , delete-scopedelete-secret, get-acl, get-secret, list-acls, list-scopeslist-secretsput-aclput-secret
workspace Comandos para list, importar, exportar e excluir blocos de anotações e pastas no espaço de trabalho:

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

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

Comandos de computação

Agrupar Descrição e comandos
cluster-policies Comandos para controlar a capacidade dos usuários de configurar clusters com base em uma set de regras:

create, delete, edit, get, list

get-permission-levels, get-permissions, set-permissions, update-permissions
clusters Comandos que permitem criar, iniciar, editar, list, encerrar e excluir clusters:

change-owner, create, , delete, editevents, get, listlist-node-typeslist-zonespermanent-deletepinresizerestartspark-versionsstartunpin

get-permission-levels, get-permissions, set-permissions, update-permissions
global-init-scripts Comandos que permitem que os administradores de espaço de trabalho configurem scripts de inicialização global para seu espaço de trabalho:

create, delete, get, list, update
instance-pools Comandos para criar, editar, eliminar e list pools de instâncias usando instâncias de nuvem pré-configuradas, o que reduz os tempos de início e dimensionamento automático do cluster.

create, delete, edit, get, list

get-permission-levels, get-permissions, set-permissions, update-permissions
instance-profiles Comandos para permitir que os administradores adicionem, liste remove perfis de instância com os quais os usuários possam iniciar clusters:

add, edit, list, remove
libraries Comandos para instalar, desinstalar e get o estado das bibliotecas num cluster:

all-cluster-statuses, cluster-status, install, uninstall
policy-families Comandos para visualizar as famílias de políticas disponíveis:

get, list

Comandos de trabalhos

Agrupar Descrição e comandos
jobs Comandos para gerenciar trabalhos:

cancel-all-runs, cancel-run, , create, , deletedelete-runexport-rungetget-runget-run-outputlistlist-runsrepair-runresetrun-nowsubmitupdate

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

Comandos do Delta Live Tables

Agrupar Descrição e comandos
pipelines Comandos para criar, editar, excluir, iniciar e exibir detalhes sobre pipelines:

create, delete, , get, get-update, list-pipeline-eventslist-pipelines, list-updates, start-updatestop,update

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

Comandos de Aprendizagem Automática

Agrupar Descrição e comandos
experiments Comandos para interagir com experimentos, que são a unidade primária de organização no MLflow; todas as execuções MLflow pertencem a um experimento:

create-experiment, , , , , create-rundelete-experimentdelete-rundelete-runsdelete-tagget-by-nameget-experimentget-historyget-runGetlist-artifactslist-experimentslog-batchlog-inputslog-metriclog-modellog-paramrestore-experimentrestore-runrestore-runssearch-experimentssearch-runsset-experiment-tagset-tagupdate-experimentupdate-run

get-permission-levels, get-permissions, set-permissions, update-permissions
model-registry Comandos para o Registro do Modelo de Espaço de Trabalho:

approve-transition-request, , , , , create-commentcreate-modelcreate-model-versioncreate-transition-requestcreate-webhookdelete-commentdelete-modeldelete-model-tagdelete-model-versiondelete-model-version-tagdelete-transition-requestdelete-webhookget-latest-versionsget-modelget-model-versionget-model-version-download-urilist-modelslist-transition-requestslist-webhooksreject-transition-requestrename-modelsearch-model-versionssearch-modelsset-model-tagset-model-version-tagtest-registry-webhooktransition-stageupdate-commentupdate-modelupdate-model-versionupdate-webhook

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

Comandos de serviço em tempo real

Agrupar Descrição e comandos
serving-endpoints Comandos para criar, updatee eliminar endpoints de serviço de modelos:

build-logs, create, , deleteexport-metrics, get, list, logs, patchputqueryupdate-config

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

Comandos de gerenciamento de identidade e acesso

Agrupar Descrição e comandos
account Comandos para gerenciar contas Databricks:

- Identidade e acesso: access-control, groups, service-principals, users, workspace-assignment
- Unidade Catalog: metastore-assignments, metastores, storage-credentials
- Definições: ip-access-lists, network-connectivity, settings
- Aprovisionamento: credentials, encryption-keys, networks, , private-access, storage, vpc-endpoints, workspaces
- Faturação: billable-usage, log-delivery
- OAuth: custom-app-integration, o-auth-published-apps, published-app-integration, , service-principal-secrets
auth Comandos para autenticação:

describe, env, login, profiles, token
current-user Comandos para recuperar informações sobre o usuário ou entidade de serviço autenticada no momento:

me
groups Comandos para grupos que simplificam o gerenciamento de identidades, facilitando a atribuição de acesso ao espaço de trabalho, dados e outros objetos protegíveis do Databricks:

create, delete, get, list, patch, update
permissions Comandos para criar, ler, escrever, editar, update e gerir o acesso de vários utilizadores em diferentes objetos e endpoints:

get, set, update

get-permission-levels
service-principals Comandos para identidades para uso com trabalhos, ferramentas automatizadas e sistemas, como scripts, aplicativos e plataformas de CI/CD:

create, delete, get, list, patch, update
users Comandos para identidades de usuário reconhecidas pelo Databricks e representadas por endereços de e-mail:

create, delete, get, list, patch, update

get-permission-levels, get-permissions, set-permissions, update-permissions
Agrupar Descrição e comandos
alerts Comandos para executar operações em alertas:

create, delete, get, list, update
data-sources Comandos para criar novos objetos de consulta:

list
queries Comandos para executar operações em definições de consulta:

create, delete, get, list, restore, update
query-history Comandos para acessar o histórico de consultas por meio de armazéns SQL:

list
warehouses Comandos para gerenciar armazéns SQL, que são um recurso de computação que permite executar comandos SQL em objetos de dados no Databricks SQL:

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

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

Comandos do Unity Catalog

Agrupar Descrição e comandos
artifact-allowlists Comandos para gerenciar listas de permissões de artefatos. No Databricks Runtime 13.3 e superior, você pode adicionar bibliotecas e scripts de inicialização à lista de permissões na UC para que os usuários possam aproveitar esses artefatos na computação configurada com o modo de acesso compartilhado:

get, update
catalogs Comandos para gerenciar catalogs, a primeira camada do namespace de três níveis do Unity Catalog:

create, delete, get, list, update
connections Comandos para criar uma conexão com uma fonte de dados externa:

create, delete, get, list, update
external-locations Comandos para gerenciar locais externos, que combinam um caminho de armazenamento em nuvem com uma credencial de armazenamento que autoriza o acesso ao caminho de armazenamento em nuvem:

create, delete, get, list, update
functions Comandos para gerenciar User-Defined Functions (UDFs) no Unity Catalog:

create, delete, get, list, update
grants Comandos para grant acesso a dados no Unity Catalog:

get, get-effective, update
metastores Comandos para gerenciar metastores, que são o contêiner de nível superior de objetos no Unity Catalog:

assign, create, , current, delete, getlist, summary, unassignupdate,update-assignment
model-versions Comandos para gerenciar versões de modelos. O Databricks fornece uma versão hospedada do MLflow Model Registry no Unity Catalog.

delete, get, get-by-alias, list, update
online-tables Comandos para gerenciar tableson-line , que fornecem menor latência e maior acesso QPS aos dados da Delta tables:

create, delete, get
quality-monitors Comandos para gerir monitores, que calculam e monitorizam dados ou métricas de qualidade de modelo para um table ao longo do tempo:

create, delete, get, get-refresh, list-refreshes, run-refresh, update
registered-models Comandos para gerenciar modelos registrados. O Databricks fornece uma versão hospedada do MLflow Model Registry no Unity Catalog.

create, delete, delete-alias, get, list, set-alias, update
schemas Comandos para gerenciar esquemas, que são a segunda camada do namespace de três níveis do Unity Catalog:

create, delete, get, list, update
storage-credentials Comandos para gerir armazenamento credentials, que são um mecanismo de autenticação e autorização para aceder a dados armazenados no seu tenant na nuvem:

create, delete, get, list, update, validate
system-schemas Comandos para gerenciar esquemas do sistema, que são esquemas que vivem dentro do sistema catalog:

disable, enable, list
table-constraints Comandos para gerenciar restrições de chave primária e chave estrangeira que codificam relações entre campos em tables:

create, delete
tables Comandos para gerenciar tables, que reside na terceira camada do namespace de três níveis do Unity Catalog:

delete, exists, get, list, list-summaries
volumes Comandos para gerenciar volumes, que são um recurso Unity Catalog (UC) para acessar, armazenar, governar, organizar e processar arquivos:

create, delete, list, read, update
workspace-bindings Comandos para gerenciar associações de espaço de trabalho protegíveis. Os protegíveis no Databricks podem ser configurados como OPEN ou ISOLATED.

get, get-bindings, update, update-bindings

Comandos de compartilhamento delta

Agrupar Descrição e comandos
providers Comandos para gerenciar dados providers, que representam as organizações que compartilham dados:

create, delete, get, list, list-shares, update
recipient-activation Comandos para gerenciar a ativação de destinatários, que só é aplicável no modelo de compartilhamento aberto where o objeto de destinatário tem o tipo de autenticação TOKEN:

get-activation-url-info, retrieve-token
recipients Comandos para gerenciar recipients, que você cria usando :method:recipients/create para representar uma organização à qual você deseja permitir acesso a shares:

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

share-permissions
shares Comandos para gerenciar shares, que são contêineres instanciados com :method:shares/create:

create, delete, get, list, update

share-permissions, update-permissions

Comandos de configurações

Agrupar Descrição e comandos
ip-access-lists Comandos para permitir que os administradores configurem listas de acesso IP:

create, delete, get, list, replace, update
settings Comandos para permitir que os usuários gerenciem configurações no nível do espaço de trabalho:

automatic-cluster-update, csp-enablement, default-namespace, esm-enablement, restrict-workspace-admins
token-management Comandos que permitem que os administradores get todos os tokens e eliminem tokens para outros utilizadores:

create-obo-token, delete, get, list

get-permission-levels, get-permissions, set-permissions, update-permissions
tokens Comandos para criar, liste revoke tokens que podem ser usados para autenticar e acessar APIs REST do Databricks:

create, delete, list
workspace-conf Comandos para as configurações do espaço de trabalho update.

get-status, set-status

Comandos das ferramentas de desenvolvedor

Agrupar Descrição e comandos
pacote Comandos para gerenciar Databricks Asset Bundles, que permitem expressar seus projetos Databricks como código:

deploy, deployment, , destroygenerate, init, open, run, schemasummarysyncvalidate
sync Sincronize um diretório local com um diretório de espaço de trabalho.

Comandos de pesquisa vetorial

Agrupar Descrição e comandos
vector-search-endpoints Comandos para gerenciar pontos de extremidade de pesquisa vetorial, que representam os recursos de computação para hospedar índices de pesquisa vetorial:

create-endpoint, delete-endpoint, get-endpoint, list-endpoints
vector-search-indexes Comandos para gerenciar índices de pesquisa vetorial, uma representação eficiente de seus vetores de incorporação que suporta consultas de pesquisa de vizinho mais próximo (ANN) em tempo real e eficientes:

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

Comandos do painel

Agrupar Descrição e comandos
dashboards Comandos para modificar painéis:

create, delete, get, list, restore, update
lakeview Comandos que fornecem operações de gerenciamento específicas para painéis de IA/BI:

create, get, , get-published, migratepublish, trash, unpublish,update

Comandos adicionais

Agrupar Descrição e comandos
api Comandos para fazer solicitações à API REST do Databricks:

delete, get, head, patch, post, put
Conclusão Comandos para generate o script de preenchimento automático para o shell especificado:

bash, fish, powershell, zsh
configurar Configure a CLI do Databricks.
help Informações de uso de saída para qualquer comando.
laboratórios Comandos para gerenciar instalações do Databricks Labs:

clear-cache, install, installed, list, show, uninstall, upgrade
version Recupere a versão da CLI que está sendo usada no momento.

Bandeiras globais

Os sinalizadores a seguir estão disponíveis para todos os comandos da CLI do Databricks. Observe que alguns sinalizadores não se aplicam a alguns comandos. Para obter informações detalhadas sobre comandos específicos e seus sinalizadores, consulte a ajuda da linha de comando.

Sinalizador Description
-h ou --help Exiba a ajuda para a CLI do Databricks ou para o grupo de comandos relacionado ou para o comando relacionado.
-e ou --environment string Uma cadeia de caracteres que representa o ambiente de pacote a ser usado, se aplicável, para o comando relacionado.
--log-file Uma cadeia de caracteres que representa o para gravar logs de saída. Se esse sinalizador não for especificado, o padrão é gravar logs de saída no stderr.
--log-format text para gravar logs de saída em texto ou json para gravar logs de saída em JSON. Se esse sinalizador não for especificado, os logs de saída serão gravados como texto.
--log-level Uma cadeia de caracteres que representa o nível de formato de log. Se não for especificado, o nível de formato de log será desativado.
-o ou --output text para escrever saída como texto ou json para escrever saída como JSON. Se esse sinalizador não for especificado, a saída será escrita como texto.
-p ou --profile Uma cadeia de caracteres que representa o perfil de configuração nomeado a ser usado em seu .databrickscfg arquivo. Se esse sinalizador não for especificado, o DEFAULT perfil nomeado será usado, se existir. Você pode pressionar Tab após --profile ou -p para exibir uma list de perfis de configuração disponíveis existentes para escolher, em vez de inserir o nome do perfil de configuração manualmente.
--progress-format O formato para exibição de logs de progresso (default (o padrão) ou append ou inplacejson).