Grupo de comandos environments

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 environments grupo de comandos de la CLI de Databricks permite administrar los recursos del entorno. Environments API proporciona funcionalidades de administración para distintos tipos de entornos, incluidos los entornos base de nivel de área de trabajo que definen la versión y las dependencias del entorno que se usarán en cuadernos y trabajos sin servidor.

entornos de databricks create-workspace-base-environment

Cree un nuevo entorno base de área de trabajo. Se trata de una operación de larga duración que genera de forma asincrónica un entorno materializado para optimizar la resolución de dependencias.

databricks environments create-workspace-base-environment DISPLAY_NAME [flags]

Argumentos

DISPLAY_NAME

    Nombre para mostrar legible para el entorno base del área de trabajo.

Options

--base-environment-type BaseEnvironmentType

    Tipo de entorno base (CPU o GPU). Valores admitidos: CPU, GPU

--filepath string

    La ruta de acceso de los volúmenes del catálogo de Unity o los archivos del área de trabajo al archivo YAML del entorno.

--json JSON

    La cadena JSON en línea o el archivo JSON @path con el cuerpo de la solicitud.

--name string

    Nombre del recurso del entorno base del área de trabajo.

--no-wait

    No espere a que llegue DONE el estado.

--request-id string

    Identificador único de esta solicitud.

--timeout duration

    Cantidad máxima de tiempo para alcanzar DONE el estado.

--workspace-base-environment-id string

    Identificador que se va a usar para el entorno base del área de trabajo, que se convertirá en el componente final del nombre del recurso.

Marcas globales

Examples

En el ejemplo siguiente se crea un entorno base del área de trabajo de CPU:

databricks environments create-workspace-base-environment "My Python Env" --base-environment-type CPU --filepath /Workspace/environments/env.yaml

entornos de databricks delete-workspace-base-environment

Elimine un entorno base del área de trabajo. La eliminación de un entorno base puede afectar a los cuadernos y trabajos vinculados. Esta operación es irreversible.

databricks environments delete-workspace-base-environment NAME [flags]

Argumentos

NAME

    Obligatorio. Nombre del recurso del entorno base del área de trabajo que se va a eliminar. Formato: workspace-base-environments/{workspace_base_environment}.

Options

Marcas globales

Examples

En el ejemplo siguiente se elimina un entorno base del área de trabajo:

databricks environments delete-workspace-base-environment workspace-base-environments/my-env-id

entornos de databricks get-default-workspace-base-environment

Obtenga la configuración predeterminada del entorno base del área de trabajo. Devuelve la configuración del entorno base predeterminada actual para el proceso de CPU y GPU.

databricks environments get-default-workspace-base-environment NAME [flags]

Argumentos

NAME

    Nombre de recurso estático del entorno base del área de trabajo predeterminada. Formato: default-workspace-base-environment.

Options

Marcas globales

Examples

En el ejemplo siguiente se obtiene el entorno base del área de trabajo predeterminada:

databricks environments get-default-workspace-base-environment default-workspace-base-environment

entornos de databricks get-operation

Obtenga el estado de una operación de ejecución prolongada. Los clientes pueden usar este método para sondear el resultado de la operación.

databricks environments get-operation NAME [flags]

Argumentos

NAME

    Nombre del recurso de operación.

Options

Marcas globales

Examples

En el ejemplo siguiente se obtiene el estado de una operación de larga duración:

databricks environments get-operation operations/1234567890

entornos de databricks get-workspace-base-environment

Obtenga un entorno base del área de trabajo por su nombre.

databricks environments get-workspace-base-environment NAME [flags]

Argumentos

NAME

    Obligatorio. Nombre del recurso del entorno base del área de trabajo que se va a recuperar. Formato: workspace-base-environments/{workspace_base_environment}.

Options

Marcas globales

Examples

En el ejemplo siguiente se obtiene un entorno base del área de trabajo:

databricks environments get-workspace-base-environment workspace-base-environments/my-env-id

entornos de databricks list-workspace-base-environments

Enumere todos los entornos base del área de trabajo en el área de trabajo.

databricks environments list-workspace-base-environments [flags]

Argumentos

Ninguno

Options

--page-size int

    Número máximo de entornos que se van a devolver por página.

--page-token string

    Token de página para la paginación.

Marcas globales

Examples

En el ejemplo siguiente se enumeran todos los entornos base del área de trabajo:

databricks environments list-workspace-base-environments

entornos de databricks refresh-workspace-base-environment

Actualice el entorno materializado para un entorno base del área de trabajo. Se trata de una operación de larga duración que regenera de forma asincrónica el entorno materializado. El entorno materializado existente permanece disponible hasta que expire.

databricks environments refresh-workspace-base-environment NAME [flags]

Argumentos

NAME

    Obligatorio. Nombre del recurso del entorno base del área de trabajo que se va a actualizar. Formato: workspace-base-environments/{workspace_base_environment}.

Options

--no-wait

    No espere a que llegue DONE el estado.

--timeout duration

    Cantidad máxima de tiempo para alcanzar DONE el estado.

Marcas globales

Examples

En el ejemplo siguiente se actualiza un entorno base del área de trabajo:

databricks environments refresh-workspace-base-environment workspace-base-environments/my-env-id

entornos de databricks update-default-workspace-base-environment

Actualice la configuración predeterminada del entorno base del área de trabajo. Establece los entornos base especificados como valores predeterminados del área de trabajo para el proceso de CPU o GPU.

databricks environments update-default-workspace-base-environment NAME UPDATE_MASK [flags]

Argumentos

NAME

    Nombre del recurso de este recurso singleton. Formato: default-workspace-base-environment.

UPDATE_MASK

    Máscara de campo que especifica qué campos se van a actualizar. Rutas de acceso de campo válidas: cpu_workspace_base_environment, gpu_workspace_base_environment. Use * para actualizar todos los campos.

Options

--cpu-workspace-base-environment string

    El entorno base del área de trabajo predeterminado para el proceso de CPU.

--gpu-workspace-base-environment string

    El entorno base del área de trabajo predeterminado para el proceso de GPU.

--json JSON

    La cadena JSON en línea o el archivo JSON @path con el cuerpo de la solicitud.

--name string

    Nombre del recurso de este recurso singleton.

Marcas globales

Examples

En el ejemplo siguiente se establece el entorno base del área de trabajo de CPU predeterminada:

databricks environments update-default-workspace-base-environment default-workspace-base-environment cpu_workspace_base_environment --cpu-workspace-base-environment workspace-base-environments/my-cpu-env

entornos de databricks update-workspace-base-environment

Actualice un entorno base del área de trabajo existente. Se trata de una operación de larga duración que regenera de forma asincrónica el entorno materializado. El entorno materializado existente permanece disponible hasta que expire.

databricks environments update-workspace-base-environment NAME DISPLAY_NAME [flags]

Argumentos

NAME

    Nombre del recurso del entorno base del área de trabajo. Formato: workspace-base-environments/{workspace_base_environment}.

DISPLAY_NAME

    Nombre para mostrar legible para el entorno base del área de trabajo.

Options

--base-environment-type BaseEnvironmentType

    Tipo de entorno base (CPU o GPU). Valores admitidos: CPU, GPU

--filepath string

    La ruta de acceso de los volúmenes del catálogo de Unity o los archivos del área de trabajo al archivo YAML del entorno.

--json JSON

    La cadena JSON en línea o el archivo JSON @path con el cuerpo de la solicitud.

--name string

    Nombre del recurso del entorno base del área de trabajo.

--no-wait

    No espere a que llegue DONE el estado.

--timeout duration

    Cantidad máxima de tiempo para alcanzar DONE el estado.

Marcas globales

Examples

En el ejemplo siguiente se actualiza un entorno base del área de trabajo:

databricks environments update-workspace-base-environment workspace-base-environments/my-env-id "Updated Python Env" --filepath /Workspace/environments/updated-env.yaml

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

    Tipo de salida del comando, text o json. El valor predeterminado es text.

-p, --profile cadena

    Nombre del perfil en el archivo ~/.databrickscfg que se usará para 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 procede, el destino del paquete que se va a usar