Comandos de la CLI de Databricks
Nota:
Esta información se aplica a las versiones 0.205 y posteriores de la CLI de Databricks. La CLI de Databricks está en versión preliminar pública.
El uso de la CLI de Databricks está sujeto a la licencia de Databricks y al aviso de privacidad de Databricks, incluidas las disposiciones de datos de uso.
En este artículo se proporciona información sobre los comandos disponibles de la CLI de Databricks. Esta información complementa la ayuda de la línea de comandos. Para obtener más información sobre cómo instalar y usar la CLI de Databricks, consulte Instalación o actualización de la CLI de Databricks y ¿Qué es la CLI de Databricks?.
La CLI de Databricks incluye los grupos de comandos enumerados en las tablas siguientes. Los grupos de comandos contienen conjuntos de comandos relacionados, que también pueden contener subcomandos. Para generar información de uso y sintaxis de un grupo de comandos, un comando individual o un subcomando:
databricks <command-group> -h
databricks <command-group> <command-name> -h
databricks <command-group> <command-name> <subcommand-name> -h
Muchos comandos de la CLI se asignan a las operaciones documentadas en Referencia de la API de REST de Azure Databricks.
Comandos del área de trabajo
Grupo | Descripción y comandos |
---|---|
fs | Comandos para administrar archivos y el sistema de archivos:cat , cp , ls , , mkdir , rm |
git-credentials |
Comandos para registrar tokens de acceso personal para que Databricks realice operaciones en nombre del usuario:create , delete , get , , list , update |
repos |
Comandos para permitir que los usuarios administren sus repositorios de Git:create , delete , get , , list , update get-permission-levels , get-permissions , , set-permissions , update-permissions |
secrets |
Comandos para administrar secretos, ámbitos secretos y permisos de acceso:create-scope , delete-acl , delete-scope , delete-secret , get-acl , get-secret , list-acls , list-scopes , list-secrets , , put-acl put-secret |
workspace |
Comandos para enumerar, importar, exportar y eliminar cuadernos y carpetas en el área de trabajo:delete , export , export-dir , get-status , import , import-dir , , list mkdirs get-permission-levels , get-permissions , , set-permissions , update-permissions |
Comandos de proceso
Grupo | Descripción y comandos |
---|---|
cluster-policies |
Comandos para controlar la capacidad de los usuarios de configurar clústeres en función de un conjunto de reglas:create , delete , edit , , get , list get-permission-levels , get-permissions , , set-permissions , update-permissions |
clusters |
Comandos que permiten crear, iniciar, editar, enumerar, finalizar y eliminar clústeres:change-owner , create , delete , edit , , events , list , list-node-types restart permanent-delete start list-zones pin resize spark-versions get unpin get-permission-levels , get-permissions , , set-permissions , update-permissions |
global-init-scripts |
Comandos que permiten a los administradores del área de trabajo configurar scripts de inicialización global para su área de trabajo:create , delete , get , , list , update |
instance-pools |
Comandos para crear, editar, eliminar y enumerar grupos de instancias mediante instancias en la nube listas para usar, lo que reduce los tiempos de inicio y escalado automático del clúster:create , delete , edit , , get , list get-permission-levels , get-permissions , , set-permissions , update-permissions |
instance-profiles |
Comandos para permitir a los administradores agregar, enumerar y quitar perfiles de instancia con los que los usuarios pueden iniciar clústeres con:add , edit , , list , remove |
libraries |
Comandos para instalar, desinstalar y obtener el estado de las bibliotecas en un clúster:all-cluster-statuses , cluster-status , , install , uninstall |
policy-families |
Comandos para ver las familias de directivas disponibles:get , list |
Comandos de trabajos
Grupo | Descripción y comandos |
---|---|
jobs |
Comandos para administrar trabajos:cancel-all-runs , cancel-run , create , delete , , export-run delete-run , get , get-run , submit run-now get-run-output list list-runs repair-run reset update get-permission-levels , get-permissions , , set-permissions , update-permissions |
Comandos de Delta Live Tables
Grupo | Descripción y comandos |
---|---|
pipelines |
Comandos para crear, editar, eliminar, iniciar y ver detalles sobre las canalizaciones: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 |
Comandos de Machine Learning
Grupo | Descripción y comandos |
---|---|
experiments |
Comandos para interactuar con experimentos, que son la unidad principal de la organización en MLflow; todas las ejecuciones de MLflow pertenecen a un experimento: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 |
Comandos para el Registro de modelos del área de trabajo:approve-transition-request , , update-comment list-models get-model-version-download-uri get-model-version get-model get-latest-versions list-transition-requests delete-webhook delete-transition-request delete-model-version-tag list-webhooks delete-model-version delete-model-tag delete-model reject-transition-request rename-model set-model-tag search-models set-model-version-tag search-model-versions test-registry-webhook delete-comment update-model-version create-model-version update-model create-transition-request transition-stage create-webhook create-comment create-model update-webhook get-permission-levels , get-permissions , , set-permissions , update-permissions |
Comandos de servicio en tiempo real
Grupo | Descripción y comandos |
---|---|
serving-endpoints |
Comandos para crear, actualizar y eliminar puntos de conexión de servicio del modelo:build-logs , create , delete , export-metrics , get , list , logs , patch , put , , query update-config get-permission-levels , get-permissions , , set-permissions , update-permissions |
Comandos de administración de identidades y acceso
Grupo | Descripción y comandos |
---|---|
account |
Comandos para administrar cuentas de Databricks: - Identidad y acceso: access-control , groups , service-principals , users , workspace-assignment - Unity Catalog: metastore-assignments , metastores , storage-credentials - Configuración: ip-access-lists , network-connectivity , settings - Aprovisionamiento: credentials , encryption-keys , networks , private-access , storage , vpc-endpoints , workspaces - Facturación: billable-usage , log-delivery - OAuth: custom-app-integration , o-auth-published-apps , published-app-integration , service-principal-secrets |
auth | Comandos para la autenticación:describe , env , login , , profiles , token |
current-user |
Comandos para recuperar información sobre el usuario o la entidad de servicio autenticados actualmente:me |
groups |
Comandos para grupos que simplifican la administración de identidades, lo que facilita la asignación de acceso al área de trabajo de Databricks, a los datos y a otros objetos protegibles:create , delete , get , list , , patch , update |
permissions |
Comandos para crear acceso de lectura, escritura, edición, actualización y administración para varios usuarios en distintos objetos y puntos de conexión:get , , set , update get-permission-levels |
service-principals |
Comandos para identidades para su uso con trabajos, herramientas automatizadas y sistemas como scripts, aplicaciones y plataformas de CI/CD:create , delete , get , list , , patch , update |
users |
Comandos para identidades de usuario reconocidas por Databricks y representadas por direcciones de correo electrónico:create , delete , get , list , , patch , update get-permission-levels , get-permissions , , set-permissions , update-permissions |
Comandos relacionados con SQL
Grupo | Descripción y comandos |
---|---|
alerts |
Comandos para realizar operaciones en alertas:create , delete , get , , list , update |
data-sources |
Comandos para crear nuevos objetos de consulta:list |
queries |
Comandos para realizar operaciones en definiciones de consulta:create , delete , get , list , , restore , update |
query-history |
Comandos para acceder al historial de consultas a través de almacenes de SQL:list |
warehouses |
Comandos para administrar almacenes de SQL, que son un recurso de proceso que permite ejecutar comandos SQL en objetos de datos dentro de 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 |
Comandos del catálogo de Unity
Grupo | Descripción y comandos |
---|---|
artifact-allowlists |
Comandos para administrar listas de permitidos de artefactos. En Databricks Runtime 13.3 y versiones posteriores, puede agregar bibliotecas y scripts de inicialización a la lista de permitidos en UC para que los usuarios puedan aprovechar estos artefactos en el proceso configurado con el modo de acceso compartido:get , update |
catalogs |
Comandos para administrar catálogos, la primera capa del espacio de nombres de tres niveles del catálogo’de Unity:create , delete , get , , list , update |
connections |
Comandos para crear una conexión a un origen de datos externo:create , delete , get , , list , update |
external-locations |
Comandos para administrar ubicaciones externas, que combinan una ruta de acceso de almacenamiento en la nube con una credencial de almacenamiento que autoriza el acceso a la ruta de acceso de almacenamiento en la nube:create , delete , get , , list , update |
functions |
Comandos para administrar funciones definidas por el usuario (UDF) en el catálogo de Unity:create , delete , get , , list , update |
grants |
Comandos para conceder acceso a los datos en el Catálogo de Unity:get , , get-effective , update |
metastores |
Comandos para administrar metastores, que son el contenedor de nivel superior de objetos en el catálogo de Unity:assign , create , current , delete , get , list , summary , unassign , , update update-assignment |
model-versions |
Comandos para administrar las versiones del modelo. Databricks proporciona una versión hospedada del Registro de modelos de MLflow en Unity Catalog.delete , get , get-by-alias , , list , update |
online-tables |
Comandos para administrar tablas en línea, que proporcionan una menor latencia y un mayor acceso de QPS a los datos de tablas delta:create , , delete , get |
quality-monitors |
Comandos para administrar monitores, que calculan y supervisan las métricas de calidad de datos o modelos de una tabla a lo largo del tiempo:create , delete , get , get-refresh , list-refreshes , , run-refresh update |
registered-models |
Comandos para administrar modelos registrados. Databricks proporciona una versión hospedada del Registro de modelos de MLflow en Unity Catalog.create , delete , delete-alias , get , list , , set-alias update |
schemas |
Comandos para administrar esquemas, que son la segunda capa del espacio de nombres de tres niveles de Catálogo de Unity:create , delete , get , , list , update |
storage-credentials |
Comandos para administrar las credenciales de almacenamiento, que son un mecanismo de autenticación y autorización para acceder a los datos almacenados en el inquilino en la nube:create , delete , get , list , , update , validate |
system-schemas |
Comandos para administrar esquemas del sistema, que son esquemas que residen en el catálogo del sistema:disable , , enable , list |
table-constraints |
Comandos para administrar restricciones de clave principal y clave externa que codifican relaciones entre campos en tablas:create , delete |
tables |
Comandos para administrar tablas, que residen en la tercera capa del espacio de nombres de tres niveles del Catálogo de Unity:delete , exists , get , , list , list-summaries |
volumes |
Comandos para administrar volúmenes, que son una funcionalidad de Catálogo de Unity (UC) para acceder, almacenar, gobernar, organizar y procesar archivos:create , delete , list , , read , update |
workspace-bindings |
Comandos para administrar enlaces de área de trabajo protegibles. Los elementos protegibles de Databricks se pueden configurar como OPEN o ISOLATED .get , get-bindings , , update , update-bindings |
Comandos de uso compartido Delta
Grupo | Descripción y comandos |
---|---|
providers |
Comandos para administrar proveedores de datos, que representan a las organizaciones que comparten datos:create , delete , get , list , , list-shares , update |
recipient-activation |
Comandos para administrar la activación de destinatarios, que solo es aplicable en el modelo de uso compartido abierto en el que el objeto destinatario tiene el tipo de autenticación TOKEN:get-activation-url-info , retrieve-token |
recipients |
Comandos para administrar destinatarios, que se crean mediante :method:recipients/create para representar una organización que desea permitir el acceso a recursos compartidos:create , delete , get , list , , rotate-token , update share-permissions |
shares |
Comandos para administrar recursos compartidos, que son contenedores creados con :method:shares/create :create , delete , get , , list , update share-permissions , update-permissions |
Comandos de configuración
Grupo | Descripción y comandos |
---|---|
ip-access-lists |
Comandos para habilitar que los administradores configuren listas de acceso IP:create , delete , get , list , , replace , update |
settings |
Comandos para permitir a los usuarios administrar la configuración en el nivel de área de trabajo:automatic-cluster-update , csp-enablement , default-namespace , , esm-enablement , restrict-workspace-admins |
token-management |
Comandos que permiten a los administradores obtener todos los tokens y eliminar tokens para otros usuarios:create-obo-token , delete , , get , list get-permission-levels , get-permissions , , set-permissions , update-permissions |
tokens |
Comandos para crear, enumerar y revocar tokens que se pueden usar para autenticar y acceder a las APIde REST de Databricks:create , , delete , list |
workspace-conf |
Comandos para actualizar la configuración del área de trabajo:get-status , set-status |
Comandos de herramientas de desarrollo
Grupo | Descripción y comandos |
---|---|
Agrupación | Comandos para administrar Conjuntos de recursos de Databricks, lo que le permite expresar los proyectos de Databricks como código:deploy , deployment , destroy , generate , init , open , run , schema , summary , , sync validate |
sync | Sincronice un directorio local con un directorio del área de trabajo. |
Comandos de vector de búsqueda
Grupo | Descripción y comandos |
---|---|
vector-search-endpoints |
Comandos para administrar puntos de conexión de vector de búsqueda, que representan los recursos de proceso para hospedar índices de búsqueda vectorial:create-endpoint , delete-endpoint , , get-endpoint , list-endpoints |
vector-search-indexes |
Comandos para administrar índices de vector de búsqueda, una representación eficaz de los vectores de inserción que admiten consultas de búsqueda cercanas (ANN) más cercanas en tiempo real y eficaces:create-index , delete-data-vector-index , delete-index , get-index , list-indexes , query-index , , sync-index upsert-data-vector-index |
Comandos del panel
Grupo | Descripción y comandos |
---|---|
dashboards |
Comandos para modificar paneles:create , delete , get , list , , restore , update |
lakeview |
Comandos que proporcionan operaciones de administración específicas para los paneles de IA/BI:create , get , get-published , migrate , publish , trash , , unpublish update |
Comandos adicionales
Grupo | Descripción y comandos |
---|---|
api | Comandos para realizar solicitudes a la API de REST de Databricks:delete , get , head , patch , , post , put |
completion | Comandos para generar el script de autocompletar para el shell especificado:bash , fish , , powershell , zsh |
configure | Configure la CLI de Databricks. |
help |
Información de uso de salida para cualquier comando. |
labs | Comandos para administrar instalaciones de Databricks Labs:clear-cache , install , installed , list , show , , uninstall upgrade |
version |
Recupere la versión de la CLI que se está usando actualmente. |
Marcas globales
Las marcas siguientes están disponibles para todos los comandos de la CLI de Databricks. Tenga en cuenta que algunas marcas no se aplican a algunos comandos. Para obtener información detallada sobre comandos específicos y sus marcas, consulte la ayuda de la línea de comandos.
Marca | Descripción |
---|---|
-h o --help |
Mostrar ayuda para la CLI de Databricks o el grupo de comandos relacionado o el comando relacionado. |
-e o --environment string |
Cadena que representa el entorno de agrupación que se va a usar si procede para el comando relacionado. |
--log-file |
Cadena que representa el objeto en el que se van a escribir los registros de salida. Si no se especifica esta marca, el valor predeterminado es escribir registros de salida en stderr. |
--log-format |
text para escribir registros de salida en texto o json para escribir registros de salida en JSON. Si no se especifica esta marca, los registros de salida se escriben como texto. |
--log-level |
Cadena que representa el nivel de formato de registro. Si no se especifica, el nivel de formato de registro está deshabilitado. |
-o o --output |
text para escribir la salida como texto o json para escribir la salida como JSON. Si no se especifica esta marca, la salida se escribe como texto. |
-p o --profile |
Cadena que representa el perfil de configuración con nombre que se va a usar en el .databrickscfg archivo. Si no se especifica esta bandera, se utiliza el perfil nombrado DEFAULT , si existe. Puede presionar Tab después de --profile o -p para mostrar una lista de perfiles de configuración disponibles entre los que elegir, en lugar de escribir manualmente el nombre del perfil de configuración. |
--progress-format |
Formato de los registros de progreso que se van a mostrar (default (valor predeterminado) o append o inplace o json ). |