volumes
grupo de comando
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égioUSE_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.
Exemplos
O exemplo a seguir cria um gerenciar volume:
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"
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
Exemplos
O exemplo a seguir exclui um volume:
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.
Exemplos
O exemplo a seguir lista todos os volumes em um catálogo e esquema:
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.
Exemplos
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 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.
Exemplos
O exemplo a seguir 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 o proprietário 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
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