Grupo de comandos volumes

O volumes grupo de comandos dentro da CLI do Databricks contém comandos para gerenciar volumes no Catálogo do Unity. Os volumes fornecem recursos para acessar, armazenar, controlar, organizar e processar arquivos. Confira O que são volumes do Unity Catalog?.

criar volumes do databricks

Crie um novo volume.

O usuário pode criar um volume externo ou um volume gerenciado. Um volume externo será criado no local externo especificado, enquanto um volume gerenciado estará localizado no local padrão especificado pelo esquema pai, pelo catálogo pai ou pelo metastore.

Para que a criação do volume seja bem-sucedida, o usuário deve atender às seguintes condições:

• O chamador deve ser um administrador do metastore, ser o proprietário do catálogo pai e do esquema, ou ter o privilégio USE_CATALOG no catálogo pai e o privilégio USE_SCHEMA no esquema pai.
• O chamador deve ter o privilégio CREATE VOLUME no esquema pai.

Para um volume externo, as seguintes condições também precisam ser atendidas:

• O chamador deve ter o privilégio CREATE EXTERNAL VOLUME no local externo.
• Não há outras tabelas nem volumes existentes no local de armazenamento especificado. - O local de armazenamento especificado não está no local de outras tabelas, nem volumes, nem catálogos ou esquemas.

databricks volumes create CATALOG_NAME SCHEMA_NAME NAME VOLUME_TYPE [flags]

Arguments

CATALOG_NAME

    O nome do catálogo em que o esquema e o volume estão

SCHEMA_NAME

    O nome do esquema em que o volume está

NAME

    O nome do volume

VOLUME_TYPE

    O tipo do volume. Um volume externo está localizado no local externo especificado. Um volume gerenciado está localizado no local padrão especificado pelo esquema pai, pelo catálogo pai ou pelo Metastore. Consulte Volumes gerenciados versus externos. Valores com suporte: EXTERNAL, MANAGED

Opções

--comment string

    O comentário anexado ao volume.

--json JSON

    A cadeia de caracteres JSON inserida em linha ou o @path para o arquivo JSON com o corpo da solicitação.

--storage-___location string

    O local de armazenamento na nuvem.

Sinalizadores globais

Examples

O exemplo a seguir cria um volume gerenciado:

databricks volumes create my_catalog my_schema my_volume MANAGED

O exemplo a seguir cria um volume externo com um comentário:

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

exclusão de volumes do databricks

Exclua um volume do catálogo pai e do esquema especificados.

O chamador deve ser administrador do metastore ou proprietário do volume. Para o último caso, o chamador também deve ser o proprietário ou ter o privilégio USE_CATALOG no catálogo pai e o privilégio USE_SCHEMA no esquema pai.

databricks volumes delete NAME [flags]

Arguments

NAME

    O nome (totalmente qualificado) em três níveis do volume

Opções

Sinalizadores globais

Examples

O exemplo a seguir exclui um volume:

databricks volumes delete my_catalog.my_schema.my_volume

lista de volumes do databricks

Liste volumes para o metastore atual no catálogo pai e no esquema.

Os volumes retornados são filtrados com base nos privilégios do usuário de chamada. Por exemplo, o administrador do metastore é capaz de listar todos os volumes. Um usuário regular precisa ser o proprietário ou ter o privilégio READ VOLUME sobre o volume para que possa receber os volumes na resposta. Para o último caso, o chamador também deve ser o proprietário ou ter o privilégio USE_CATALOG no catálogo pai e o privilégio USE_SCHEMA no esquema pai.

Não há garantia de uma ordenação específica dos elementos na matriz.

databricks volumes list CATALOG_NAME SCHEMA_NAME [flags]

Arguments

CATALOG_NAME

    O identificador do catálogo

SCHEMA_NAME

    O identificador do esquema

Opções

--include-browse

    Indica se deve incluir na resposta os volumes para os quais a entidade de segurança tem acesso apenas a metadados seletivos.

--max-results int

    Número máximo de volumes a serem retornados (comprimento da página).

--page-token string

    Token opaco retornado por uma solicitação anterior.

Sinalizadores globais

Examples

O exemplo a seguir lista todos os volumes em um catálogo e esquema:

databricks volumes list my_catalog my_schema

leitura de volumes do databricks

Obtenha um volume do metastore para um catálogo e esquema específicos.

O chamador deve ser um administrador do metastore ou um proprietário do volume (ou ter o privilégio READ VOLUME). Para o último caso, o chamador também deve ser o proprietário ou ter o privilégio USE_CATALOG no catálogo pai e o privilégio USE_SCHEMA no esquema pai.

databricks volumes read NAME [flags]

Arguments

NAME

    O nome (totalmente qualificado) em três níveis do volume

Opções

--include-browse

    Indica se deve incluir na resposta os volumes para os quais a entidade de segurança tem acesso apenas a metadados seletivos.

Sinalizadores globais

Examples

O exemplo a seguir obtém informações sobre um volume:

databricks volumes read my_catalog.my_schema.my_volume

O exemplo a seguir obtém informações de volume, incluindo metadados de navegação:

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

Atualização de volumes do Databricks

Atualize o volume especificado no catálogo pai e no esquema especificados.

O chamador deve ser administrador do metastore ou proprietário do volume. Para o último caso, o chamador também deve ser o proprietário ou ter o privilégio USE_CATALOG no catálogo pai e o privilégio USE_SCHEMA no esquema pai.

Atualmente, somente o nome, o proprietário ou o comentário do volume podem ser atualizados.

databricks volumes update NAME [flags]

Arguments

NAME

    O nome (totalmente qualificado) em três níveis do volume

Opções

--comment string

    O comentário anexado ao volume.

--json JSON

    A cadeia de caracteres JSON inserida em linha ou o @path para o arquivo JSON com o corpo da solicitação.

--new-name string

    Novo nome para o volume.

--owner string

    O identificador do usuário que possui o volume.

Sinalizadores globais

Examples

O exemplo seguinte atualiza o comentário de um volume:

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

O exemplo a seguir altera a propriedade de um volume:

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

O exemplo a seguir renomeia um volume:

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

Sinalizadores globais

--debug

  Indica se deve habilitar o registro em log de depuração.

-h ou --help

    Exiba ajuda para a CLI do Databricks ou o grupo de comandos relacionado ou o comando relacionado.

--log-file corda

    Uma cadeia de caracteres que representa o arquivo no qual gravar os logs de saída. Se esse sinalizador não for especificado, o padrão será gravar logs de saída no stderr.

--log-format formato

    O tipo de formato de log, text ou json. O valor padrão é text.

--log-level corda

    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á desabilitado.

-o, --output tipo

    O tipo de saída de comando, text ou json. O valor padrão é text.

-p, --profile corda

    O nome do perfil no arquivo ~/.databrickscfg a ser usado para executar o comando. Se esse sinalizador não for especificado, se existir, o perfil nomeado DEFAULT será usado.

--progress-format formato

    O formato para exibir logs de progresso: default, append, inplace ou json

-t, --target corda

    Se aplicável, o destino do pacote a ser usado