volumes grupo de comando

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

Os volumes Databricks criam

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 satisfazer as seguintes condições:

• O chamador deve ser um administrador de metastore, ou 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 CREATE VOLUME privilégios no esquema pai.

Para um volume externo, devem igualmente ser satisfeitas as seguintes condições:

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

databricks volumes create CATALOG_NAME SCHEMA_NAME NAME VOLUME_TYPE [flags]

Arguments

CATALOG_NAME

    O nome do catálogo onde 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 num local externo específico. Um volume gerenciado está localizado no local padrão especificado pelo esquema pai, pelo catálogo pai ou pelo Metastore. Consulte Volumes gerenciados versus volumes externos. Valores suportados: EXTERNAL, MANAGED

Opções

--comment string

    O comentário anexado ao volume.

--json JSON

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

--storage-location string

    O local de armazenamento na nuvem.

Bandeiras 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 autor da chamada deve ser um administrador do metastore ou um proprietário do volume. Para o último caso, o chamador também deve ser o proprietário ou ter o USE_CATALOG privilégio no catálogo pai e o USE_SCHEMA privilégio no esquema pai.

databricks volumes delete NAME [flags]

Arguments

NAME

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

Opções

Bandeiras globais

Examples

O exemplo a seguir exclui um volume:

databricks volumes delete my_catalog.my_schema.my_volume

Lista de volumes Databricks

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

Os volumes retornados são filtrados com base nos privilégios do usuário chamador. Por exemplo, o administrador do metastore é capaz de listar todos os volumes. Um utilizador comum precisa ser o proprietário ou ter o privilégio READ VOLUME no volume para receber os volumes na resposta. Para o último caso, o chamador também deve ser o proprietário ou ter o USE_CATALOG privilégio no catálogo pai e o USE_SCHEMA privilégio 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

    Incluir volumes na resposta para os quais o principal pode aceder a metadados seletivos.

--max-results int

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

--page-token string

    Token opaco retornado por uma solicitação anterior.

Bandeiras globais

Examples

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

databricks volumes list my_catalog my_schema

volumes de databricks lidos

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

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

databricks volumes read NAME [flags]

Arguments

NAME

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

Opções

--include-browse

    Incluir volumes na resposta para os quais o principal pode aceder a metadados seletivos.

Bandeiras 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 autor da chamada deve ser um administrador do metastore ou um proprietário do volume. Para o último caso, o chamador também deve ser o proprietário ou ter o USE_CATALOG privilégio no catálogo pai e o USE_SCHEMA privilégio no esquema pai.

Atualmente, apenas 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 de três níveis do volume

Opções

--comment string

    O comentário anexado ao volume.

--json JSON

    A cadeia de caracteres JSON embutida 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 proprietário do volume.

Bandeiras globais

Examples

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 muda 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 o log de depuração deve ser habilitado.

-h ou --help

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

--log-file string

    Uma cadeia de caracteres que representa o ficheiro onde os registos de saída são gravados. Se esse sinalizador não for especificado, o padrão é gravar logs de saída no stderr.

--log-format Formato

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

--log-level string

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

-o, --output tipo

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

-p, --profile string

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

--progress-format Formato

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

-t, --target string

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