Grupo de comandos volumes

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 volumes grupo de comandos de la CLI de Databricks contiene comandos para administrar volúmenes en el catálogo de Unity. Los volúmenes proporcionan características para acceder, almacenar, gobernar, organizar y procesar archivos. Consulte ¿Qué son los volúmenes de Unity Catalog?.

creación de volúmenes de databricks

Cree un nuevo volumen.

El usuario podría crear un volumen externo o un volumen administrado. Se creará un volumen externo en la ubicación externa especificada, mientras que un volumen administrado se ubicará en la ubicación predeterminada especificada por el esquema primario, o el catálogo primario o el metastore.

Para que la creación del volumen se realice correctamente, el usuario debe cumplir las condiciones siguientes:

• El autor de la llamada debe ser un administrador de metastore, o ser el propietario del catálogo primario y el esquema, o tener el privilegio USE_CATALOG en el catálogo primario y el privilegio USE_SCHEMA en el esquema primario.
• El autor de la llamada debe tener CREATE VOLUME privilegio en el esquema principal.

En el caso de un volumen externo, también es necesario cumplir las siguientes condiciones:

• El autor de la llamada debe tener CREATE EXTERNAL VOLUME privilegios en la ubicación externa.
• No hay otras tablas ni volúmenes existentes en la ubicación de almacenamiento especificada. - La ubicación de almacenamiento especificada no está en la ubicación de otras tablas, ni volúmenes, ni catálogos ni esquemas.

databricks volumes create CATALOG_NAME SCHEMA_NAME NAME VOLUME_TYPE [flags]

Arguments

CATALOG_NAME

    Nombre del catálogo donde se encuentran el esquema y el volumen.

SCHEMA_NAME

    Nombre del esquema donde está el volumen.

NAME

    Nombre del volumen

VOLUME_TYPE

    Tipo del volumen. Un volumen externo se encuentra en la ubicación externa especificada. Un volumen administrado se encuentra en la ubicación predeterminada que especifica el esquema primario o el catálogo primario o metastore. Consulte Volúmenes administrados frente a externos. Valores admitidos: EXTERNAL, MANAGED

Options

--comment string

    Comentario adjunto al volumen.

--json JSON

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

--storage-location string

    Ubicación de almacenamiento en la nube.

Marcas globales

Examples

En el ejemplo siguiente se crea un volumen administrado:

databricks volumes create my_catalog my_schema my_volume MANAGED

En el ejemplo siguiente se crea un volumen externo con un comentario:

databricks volumes create my_catalog my_schema my_external_volume EXTERNAL --storage-location s3://my-bucket/my-volume --comment "External volume for data processing"

eliminación de volúmenes de databricks

Elimine un volumen del catálogo primario y el esquema especificados.

El autor de la llamada debe ser un administrador de metastore o un propietario del volumen. En este último caso, el autor de la llamada también debe ser el propietario o tener el privilegio USE_CATALOG en el catálogo primario y el privilegio USE_SCHEMA en el esquema primario.

databricks volumes delete NAME [flags]

Arguments

NAME

    Nombre de tres niveles (totalmente cualificado) del volumen

Options

Marcas globales

Examples

En el ejemplo siguiente se elimina un volumen:

databricks volumes delete my_catalog.my_schema.my_volume

lista de volúmenes de databricks

Enumere los volúmenes del metastore actual del catálogo y el esquema primarios.

Los volúmenes devueltos se filtran en función de los privilegios del usuario que llama. Por ejemplo, el administrador de metastore puede enumerar todos los volúmenes. Un usuario normal debe ser el propietario o tener el READ VOLUME privilegio en el volumen para recibir los volúmenes en la respuesta. En este último caso, el autor de la llamada también debe ser el propietario o tener el privilegio USE_CATALOG en el catálogo primario y el privilegio USE_SCHEMA en el esquema primario.

No hay ninguna garantía de una ordenación específica de los elementos de la matriz.

databricks volumes list CATALOG_NAME SCHEMA_NAME [flags]

Arguments

CATALOG_NAME

    Identificador del catálogo

SCHEMA_NAME

    Identificador del esquema

Options

--include-browse

    Si se deben incluir volúmenes en la respuesta para los que el principal solo puede acceder a metadatos selectivos.

--max-results int

    Número máximo de volúmenes que se van a devolver (longitud de página).

--page-token string

    Token opaco devuelto por una solicitud anterior.

Marcas globales

Examples

En el ejemplo siguiente se enumeran todos los volúmenes de un catálogo y un esquema:

databricks volumes list my_catalog my_schema

volúmenes de databricks leídos

Obtenga un volumen de datos específico de la tienda de metadatos para un catálogo y esquema.

El autor de la llamada debe ser un administrador de metastore o un propietario de (o tener el privilegio READ VOLUME) en el volumen. En este último caso, el autor de la llamada también debe ser el propietario o tener el privilegio USE_CATALOG en el catálogo primario y el privilegio USE_SCHEMA en el esquema primario.

databricks volumes read NAME [flags]

Arguments

NAME

    Nombre de tres niveles (totalmente cualificado) del volumen

Options

--include-browse

    Si se deben incluir volúmenes en la respuesta para los que el principal solo puede acceder a metadatos selectivos.

Marcas globales

Examples

En el ejemplo siguiente se obtiene información sobre un volumen:

databricks volumes read my_catalog.my_schema.my_volume

En el siguiente ejemplo se obtiene información sobre el volumen, incluidos los metadatos de navegación:

databricks volumes read my_catalog.my_schema.my_volume --include-browse

Actualización de volúmenes de Databricks

Actualice el volumen especificado en el catálogo y esquema principal especificados.

El autor de la llamada debe ser un administrador de metastore o un propietario del volumen. En este último caso, el autor de la llamada también debe ser el propietario o tener el privilegio USE_CATALOG en el catálogo primario y el privilegio USE_SCHEMA en el esquema primario.

Actualmente, solo se puede actualizar el nombre, el propietario o el comentario del volumen.

databricks volumes update NAME [flags]

Arguments

NAME

    Nombre de tres niveles (totalmente cualificado) del volumen

Options

--comment string

    Comentario adjunto al volumen.

--json JSON

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

--new-name string

    Nuevo nombre del volumen.

--owner string

    El identificador del usuario que tiene la propiedad del volumen.

Marcas globales

Examples

En el ejemplo siguiente se actualiza el comentario de un volumen:

databricks volumes update my_catalog.my_schema.my_volume --comment "Updated comment for my volume"

En el ejemplo siguiente se cambia el propietario de un volumen:

databricks volumes update my_catalog.my_schema.my_volume --owner someone@example.com

En el ejemplo siguiente se cambia el nombre de un volumen:

databricks volumes update my_catalog.my_schema.my_volume --new-name my_new_volume_name

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