Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Grupo de comandos
Note
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.
El apps grupo de comandos de la CLI de Databricks permite administrar aplicaciones. Las aplicaciones se ejecutan directamente en la instancia de Databricks de un cliente, se integran con sus datos, usan y amplían los servicios de Databricks y permiten a los usuarios interactuar mediante el inicio de sesión único. Consulte Aplicaciones de Databricks.
creación de aplicaciones de databricks
Cree una nueva aplicación.
databricks apps create NAME [flags]
Arguments
NAME
Nombre de la aplicación. El nombre debe contener únicamente caracteres alfanuméricos en minúsculas y guiones. Debe ser único dentro del área de trabajo.
Options
--budget-policy-id string
ID de política de presupuesto para la app.
--description string
Descripción de la aplicación.
--json JSON
La cadena JSON en línea o el archivo JSON @path con el cuerpo de la solicitud.
--no-compute
Si es verdadero, la aplicación no se iniciará después de la creación.
--no-wait
No espere a alcanzar el estado ACTIVE.
--timeout duration
Cantidad máxima de tiempo para alcanzar el estado ACTIVO (valor predeterminado de 20m0s).
Examples
En el ejemplo siguiente se crea una aplicación básica:
databricks apps create my-analytics-app --description "Analytics dashboard app"
En el ejemplo siguiente se crea una aplicación sin iniciarla:
databricks apps create my-data-app --description "Data processing app" --no-compute
En el ejemplo siguiente se crea una aplicación con un tiempo de espera personalizado:
databricks apps create my-ml-app --description "Machine learning app" --timeout 30m
elimina aplicaciones de databricks
Eliminar una aplicación.
databricks apps delete NAME [flags]
Arguments
NAME
Nombre de la aplicación.
Options
Examples
En el ejemplo siguiente se elimina una aplicación:
databricks apps delete my-analytics-app
Despliegue de aplicaciones de Databricks
Cree una implementación de aplicación para la aplicación con el nombre proporcionado.
databricks apps deploy APP_NAME [flags]
Arguments
APP_NAME
Nombre de la aplicación.
Options
--deployment-id string
Id. único de la implementación.
--json JSON
La cadena JSON en línea o el archivo JSON @path con el cuerpo de la solicitud.
--mode AppDeploymentMode
Modo del que la implementación administrará el código fuente. Valores admitidos: AUTO_SYNC, SNAPSHOT.
--no-wait
No espere a alcanzar el estado SUCCEEDED.
--source-code-path string
Ruta del sistema de archivos del área de trabajo del código fuente que se usa para crear la implementación de la aplicación.
--timeout duration
Cantidad máxima de tiempo para alcanzar el estado SUCCEEDED (valor predeterminado de 20m0s).
Examples
En el ejemplo siguiente se crea una implementación con el modo de sincronización automática:
databricks apps deploy my-analytics-app --source-code-path /Workspace/Users/someone@example.com/my-app --mode AUTO_SYNC
En el ejemplo siguiente se crea una implementación con el modo de instantánea:
databricks apps deploy my-data-app --source-code-path /Workspace/Users/someone@example.com/data-app --mode SNAPSHOT
En el ejemplo siguiente se crea una implementación con un identificador de implementación personalizado:
databricks apps deploy my-ml-app --deployment-id "v1.2.3" --source-code-path /Workspace/Users/someone@example.com/ml-app
obtener aplicaciones de Databricks
Obtenga información para la aplicación con el nombre proporcionado.
databricks apps get NAME [flags]
Arguments
NAME
Nombre de la aplicación.
Options
Examples
En el ejemplo siguiente se obtiene información de la aplicación:
databricks apps get my-analytics-app
En el ejemplo siguiente se obtiene información de la aplicación en formato JSON:
databricks apps get my-data-app --output json
En el ejemplo siguiente se obtiene información de la aplicación mediante un perfil específico:
databricks apps get my-ml-app --profile production
Aplicaciones de Databricks obtener despliegue
Obtenga información para la implementación de la aplicación con el nombre y el identificador de implementación proporcionados.
databricks apps get-deployment APP_NAME DEPLOYMENT_ID [flags]
Arguments
APP_NAME
Nombre de la aplicación.
DEPLOYMENT_ID
Id. único de la implementación.
Options
Examples
En el ejemplo siguiente se obtiene información de implementación:
databricks apps get-deployment my-analytics-app v1.0.0
En el ejemplo siguiente se obtiene información de implementación en formato JSON:
databricks apps get-deployment my-data-app v2.1.0 --output json
En el ejemplo siguiente se obtiene información de implementación mediante un perfil específico:
databricks apps get-deployment my-ml-app latest --profile production
Lista de aplicaciones de Databricks
Enumere todas las aplicaciones del área de trabajo.
databricks apps list [flags]
Arguments
None
Options
--page-size int
Límite superior para los elementos devueltos.
--page-token string
Token de paginación para ir a la página siguiente de aplicaciones.
Examples
En el ejemplo siguiente se enumeran todas las aplicaciones:
databricks apps list
En el ejemplo siguiente se enumeran las aplicaciones con un tamaño de página específico:
databricks apps list --page-size 10
En el ejemplo siguiente se enumeran las aplicaciones con paginación:
databricks apps list --page-token "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
databricks apps list-deployments
Enumere todas las implementaciones de aplicaciones para la aplicación con el nombre proporcionado.
databricks apps list-deployments APP_NAME [flags]
Arguments
APP_NAME
Nombre de la aplicación.
Options
--page-size int
Límite superior para los elementos devueltos.
--page-token string
Token de paginación para ir a la página siguiente de aplicaciones.
Examples
En el ejemplo siguiente se enumeran todas las implementaciones de una aplicación:
databricks apps list-deployments my-analytics-app
En el ejemplo siguiente se enumeran las implementaciones con un tamaño de página específico:
databricks apps list-deployments my-data-app --page-size 10
Registros de aplicaciones de Databricks
Stream stdout/stderr logs for a Databricks app using its log stream (Transmitir registros stdout/stderr para una aplicación de Databricks mediante su flujo de registro). De forma predeterminada, este comando captura los registros más recientes hasta --tail-lines y se cierra. El filtrado del lado servidor está disponible mediante --search y el filtrado del lado cliente está disponible mediante --source APP|SYSTEM.
databricks apps logs NAME [flags]
Arguments
NAME
Nombre de la aplicación.
Options
-f, --follow
Continúe con los registros de streaming hasta que se cancele o se alcance un tiempo de espera especificado.
--tail-lines int
Número de líneas de registro recientes que se van a mostrar antes del streaming. Establézcalo en 0 para mostrar todo. Opción predeterminada: 200
--timeout duration
Tiempo máximo de transmisión cuando --follow está configurado. Establézcalo en 0 para deshabilitar el tiempo de espera.
--search string
Envíe un término de búsqueda al servicio de registro antes del streaming.
--source strings
Restringa los registros a orígenes APP o SYSTEM.
--output-file string
Ruta de acceso de archivo opcional para escribir registros además de stdout.
Examples
En el ejemplo siguiente se capturan los registros más recientes de una aplicación:
databricks apps logs my-analytics-app
En el ejemplo siguiente se transmiten los registros continuamente hasta que se interrumpen:
databricks apps logs my-analytics-app --follow
En el ejemplo siguiente se capturan las últimas 500 líneas de registros:
databricks apps logs my-data-app --tail-lines 500
En el ejemplo siguiente se transmiten registros con un tiempo de espera de 10 minutos:
databricks apps logs my-ml-app --follow --timeout 10m
En el ejemplo siguiente se filtran los registros por un término de búsqueda:
databricks apps logs my-analytics-app --search "error"
En el ejemplo siguiente se restringen los registros solo a la salida de nivel de aplicación:
databricks apps logs my-data-app --source APP
En el ejemplo siguiente se escriben registros en stdout y en un archivo:
databricks apps logs my-ml-app --output-file /tmp/app-logs.txt
aplicaciones de databricks ejecutar-local
Inicie una aplicación localmente.
databricks apps run-local [flags]
Arguments
None
Options
--app-port int
Puerto en el que se ejecutará la aplicación (valor predeterminado 8000).
--debug
Habilite el modo de depuración.
--debug-port string
Puerto en el que se va a ejecutar el depurador.
--entry-point string
Especifique el punto de entrada personalizado con configuración (archivo .yml) para la aplicación. Tiene como valor predeterminado app.yml.
--env strings
Establezca las variables de entorno.
--port int
Puerto en el que se va a ejecutar el proxy de la aplicación (valor predeterminado 8001).
--prepare-environment
Prepara el entorno para ejecutar la aplicación. Requiere instalar uv.
Examples
En el ejemplo siguiente se ejecuta una aplicación localmente con la configuración predeterminada:
databricks apps run-local
En el ejemplo siguiente se ejecuta una aplicación localmente en un puerto específico:
databricks apps run-local --app-port 9000 --port 9001
Iniciar aplicaciones de Databricks
Inicie la última implementación activa de la aplicación en el área de trabajo.
databricks apps start NAME [flags]
Arguments
NAME
Nombre de la aplicación.
Options
--no-wait
No espere a alcanzar el estado ACTIVE.
--timeout duration
Cantidad máxima de tiempo para alcanzar el estado ACTIVO (valor predeterminado de 20m0s).
Examples
En el ejemplo siguiente se inicia una aplicación:
databricks apps start my-analytics-app
En el ejemplo siguiente se inicia una aplicación sin esperar:
databricks apps start my-data-app --no-wait
En el ejemplo siguiente se inicia una aplicación con un tiempo de espera personalizado:
databricks apps start my-ml-app --timeout 30m
las aplicaciones de Databricks se detienen
Detenga la implementación activa de la aplicación en el área de trabajo.
databricks apps stop NAME [flags]
Arguments
NAME
Nombre de la aplicación.
Options
--no-wait
No espere a alcanzar el estado STOPPED.
--timeout duration
Cantidad máxima de tiempo para alcanzar el estado STOPPED (valor predeterminado de 20m0s).
Examples
En el ejemplo siguiente se detiene una aplicación:
databricks apps stop my-analytics-app
En el ejemplo siguiente se detiene una aplicación sin esperar:
databricks apps stop my-data-app --no-wait
En el ejemplo siguiente se detiene una aplicación con un tiempo de espera personalizado:
databricks apps stop my-ml-app --timeout 30m
actualización de aplicaciones de Databricks
Actualice la aplicación con el nombre proporcionado.
databricks apps update NAME [flags]
Arguments
NAME
Nombre de la aplicación. El nombre debe contener únicamente caracteres alfanuméricos en minúsculas y guiones. Debe ser único dentro del área de trabajo.
Options
--budget-policy-id string
ID de política de presupuesto para la app.
--description string
Descripción de la aplicación.
--json JSON
La cadena JSON en línea o el archivo JSON @path con el cuerpo de la solicitud.
Examples
En el ejemplo siguiente se actualiza la descripción de una aplicación:
databricks apps update my-analytics-app --description "Updated analytics dashboard"
El comando "databricks apps get-permission-levels" para obtener niveles de permiso en aplicaciones de Databricks.
Obtiene los niveles de permisos de la aplicación.
databricks apps get-permission-levels APP_NAME [flags]
Arguments
APP_NAME
Aplicación para obtener o administrar permisos.
Options
Examples
En el ejemplo siguiente se obtienen niveles de permisos para una aplicación:
databricks apps get-permission-levels my-analytics-app
aplicaciones de databricks get-permissions
Obtenga los permisos de una aplicación. Las aplicaciones pueden heredar permisos de su objeto raíz.
databricks apps get-permissions APP_NAME [flags]
Arguments
APP_NAME
Aplicación para obtener o administrar permisos.
Options
Examples
En el ejemplo siguiente se obtienen permisos para una aplicación:
databricks apps get-permissions my-analytics-app
En el ejemplo siguiente se obtienen permisos mediante un perfil específico:
databricks apps get-permissions my-ml-app --profile production
databricks aplicaciones establecer-permisos
Establecer permisos de aplicación.
Establece los permisos en un objeto, reemplazando los permisos existentes si existen. Elimina todos los permisos directos si no se especifica ninguno. Los objetos pueden heredar permisos de su objeto raíz.
databricks apps set-permissions APP_NAME [flags]
Arguments
APP_NAME
Aplicación para obtener o administrar permisos.
Options
--json JSON
La cadena JSON en línea o el archivo JSON @path con el cuerpo de la solicitud.
Examples
En el ejemplo siguiente se establecen permisos mediante la configuración de JSON:
databricks apps set-permissions my-analytics-app --json '{"access_control_list": [{"user_name": "someone@example.com", "permission_level": "CAN_USE"}]}'
databricks apps update-permissions (actualizar permisos)
Actualice los permisos en una aplicación. Las aplicaciones pueden heredar permisos de su objeto raíz.
databricks apps update-permissions APP_NAME [flags]
Arguments
APP_NAME
Aplicación para obtener o administrar permisos.
Options
--json JSON
La cadena JSON en línea o el archivo JSON @path con el cuerpo de la solicitud.
Examples
En el ejemplo siguiente se actualizan los permisos mediante la configuración de JSON:
databricks apps update-permissions my-analytics-app --json '{"access_control_list": [{"user_name": "someone@example.com", "permission_level": "CAN_MANAGE"}]}'
Marcas globales
--debug
Indica si se va a habilitar el registro de depuración.
-h o --help
Mostrar ayuda para la CLI de Databricks o el grupo de comandos relacionado o el comando relacionado.
--log-file cadena
Cadena que representa el archivo en el que se van a escribir registros de salida. Si no se especifica esta marca, el valor predeterminado es escribir registros de salida en stderr.
--log-format formato
Tipo de formato de registro: text o json. El valor predeterminado es text.
--log-level cadena
Cadena que representa el nivel de formato de registro. Si no se especifica, el nivel de formato de registro está deshabilitado.
-o, --output tipo
El tipo de salida del comando, ya sea text o json. El valor predeterminado es text.
-p, --profile cadena
Nombre del perfil en el archivo ~/.databrickscfg para usarlo al ejecutar el comando. Si no se especifica esta marca, si existe, se usa el perfil denominado DEFAULT .
--progress-format formato
Formato para mostrar los registros de progreso: default, append, inplaceo json
-t, --target cadena
Si es aplicable, el objetivo del paquete que se va a usar