Pular para o conteúdo principal

volumes grupo de comando

nota

Esta informação se aplica a Databricks CLI versões 0.205 e acima. A CLI do Databricks está em pré-visualização pública.

Databricks CLI O uso está sujeito à LicençaDatabricks e à Política de PrivacidadeDatabricks, incluindo qualquer disposição sobre Dados de Uso.

O grupo de comandos volumes dentro do Databricks CLI contém comando para gerenciar volumes em Unity Catalog. Os volumes fornecem recursos para acessar, armazenar, gerenciar, organizar e processar arquivos. Consulte O que são volumes de armazenamento de dados do Microsoft ( Unity Catalog )?.

volumes de databricks criados

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 será localizado no local default, 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 administrador da metastore, proprietário do catálogo e do esquema principal ou ter o privilégio USE_CATALOG no catálogo principal e o privilégio USE_SCHEMA no esquema principal.
  • O chamador deve ter o privilégio CREATE VOLUME no esquema principal.

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

  • O chamador deve ter o privilégio CREATE EXTERNAL VOLUME no local externo.
  • Não existem outras tabelas nem volumes no local de armazenamento especificado. - O local de armazenamento especificado não está abaixo do local de outras tabelas, nem volumes, catálogos ou esquemas.
databricks volumes create CATALOG_NAME SCHEMA_NAME NAME VOLUME_TYPE [flags]

Argumentos

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 gerenciar está localizado no local default especificado pelo esquema pai, pelo catálogo pai ou pelo Metastore. Consulte gerenciar versus volumes externos. Valores suportados: EXTERNAL, MANAGED

Opções

--comment string

O comentário anexado ao volume.

--json JSON

As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.

--storage-location string

O local de armazenamento na nuvem.

Bandeiras globais

Exemplos

O exemplo a seguir cria um gerenciar volume:

Bash
databricks volumes create my_catalog my_schema my_volume MANAGED

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

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

volumes de databricks excluídos

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

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

databricks volumes delete NAME [flags]

Argumentos

NAME

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

Opções

Bandeiras globais

Exemplos

O exemplo a seguir exclui um volume:

Bash
databricks volumes delete my_catalog.my_schema.my_volume

lista de volumes de databricks

Liste os volumes do metastore atual no catálogo e no esquema principais.

Os volumes retornados são filtrados com base nos privilégios do usuário chamador. Por exemplo, o administrador da metastore pode listar todos os volumes. Um usuário comum precisa ser o proprietário ou ter o privilégio READ VOLUME no volume para receber os volumes na resposta. No último caso, o chamador também deve ser o proprietário ou ter o privilégio USE_CATALOG no catálogo principal e o privilégio USE_SCHEMA no esquema principal.

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

databricks volumes list CATALOG_NAME SCHEMA_NAME [flags]

Argumentos

CATALOG_NAME

O identificador do catálogo

SCHEMA_NAME

O identificador do esquema

Opções

--include-browse

Se deve incluir volumes na resposta para os quais o diretor só pode acessar metadados seletivos.

--max-results int

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

--page-token string

Tokens opacos retornados por uma solicitação anterior.

Bandeiras globais

Exemplos

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

Bash
databricks volumes list my_catalog my_schema

volumes de dados lidos

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

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

databricks volumes read NAME [flags]

Argumentos

NAME

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

Opções

--include-browse

Se deve incluir volumes na resposta para os quais o diretor só pode acessar metadados seletivos.

Bandeiras globais

Exemplos

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

Bash
databricks volumes read my_catalog.my_schema.my_volume

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

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

atualização de volumes do databricks

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

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

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

databricks volumes update NAME [flags]

Argumentos

NAME

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

Opções

--comment string

O comentário anexado ao volume.

--json JSON

As cadeias de caracteres JSON ou o caminho @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.

Bandeiras globais

Exemplos

O exemplo a seguir atualiza o comentário de um volume:

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

O exemplo a seguir altera o proprietário de um volume:

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

O exemplo a seguir renomeia um volume:

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

Bandeiras globais

--debug

Se deve habilitar o registro de depuração.

-h ou --help

Exibir ajuda para o comando Databricks CLI ou para o grupo de comandos relacionado ou para o comando relacionado.

--log-file string

Uma string que representa o arquivo no qual a saída logs deve ser gravada. Se este sinalizador não for especificado, o default deverá gravar a saída logs no stderr.

--log-format Formato

O tipo de formato do log, text ou json. O valor de default é text.

--log-level string

Uma string que representa o nível de formato do log. Se não for especificado, o nível de formato do log será desativado.

-o, --output Tipo

O tipo de saída do comando, text ou json. O valor de default é text.

-p, --profile string

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

--progress-format Formato

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

-t, --target string

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