Criar e gerenciar volumes

Este artigo contém exemplos de sintaxe para criar, gerenciar e remover volumes do Catálogo do Unity.

• Para obter instruções sobre como carregar, gerenciar ou trabalhar com arquivos em volumes, consulte Gerenciar arquivos em volumes.
• Para obter detalhes sobre como explorar volumes e seu conteúdo, consulte Explorar o armazenamento e localizar arquivos de dados.
• Para obter uma visão geral sobre volumes, consulte O que são volumes do Catálogo do Unity?.
• Para obter detalhes sobre volumes gerenciados e externos, consulte Volumes gerenciados versus externos.
• Para obter detalhes de permissão do Catálogo do Unity, consulte Quais são os privilégios de volumes?.

Criar um volume

Quando você cria um volume usando o SQL, o Explorador de Catálogo ou outras ferramentas, um volume gerenciado é criado por padrão. Para criar um volume externo, associe o volume a um local externo.

As instruções a seguir incluem sintaxe de exemplo para criar volumes gerenciados e, opcionalmente, especificar um local de armazenamento de objetos de nuvem para criar um volume externo.

Explorador do Catálogo

Para criar um volume no Explorador de Catálogos:

1. No workspace do Azure Databricks, clique em Catálogo.
2. Pesquise ou procure o esquema ao qual você quer adicionar o volume e selecione-o.
3. Clique no botão Criar Volume. (Você deve ter privilégios suficientes.)
4. Insira um nome para o volume.
5. Se você quiser criar um volume externo, faça o seguinte:
   1. Escolha um local externo para criar o volume.
   2. Edite o caminho para refletir o subdiretório em que você quer criar o volume.
6. Forneça um comentário (opcional).
7. Clique em Criar.

SQL

Para criar um volume gerenciado, use a seguinte sintaxe:

CREATE VOLUME <catalog>.<schema>.<volume-name>;

Para criar um volume externo, adicione a cláusula LOCATION, como no exemplo a seguir:

CREATE EXTERNAL VOLUME <catalog>.<schema>.<external-volume-name>
LOCATION 'abfss://<container-name>@<storage-account>.dfs.core.windows.net/<path>/<directory>';

Consulte CREATE VOLUME.

Permissões necessárias

Você deve ter as seguintes permissões para criar um volume:

Por padrão, os volumes gerenciados são criados no local de armazenamento gerenciado associado ao esquema que contém. Consulte Especificar um local de armazenamento gerenciado no catálogo do Unity.

Para criar volumes externos, você também deve ter o privilégio CREATE EXTERNAL VOLUME para o local externo que gerencia o armazenamento de objetos de nuvem especificado na cláusula LOCATION. Confira Conectar-se ao armazenamento de objetos de nuvem usando o Catálogo do Unity.

Remover um volume

Explorador do Catálogo

Para remover um volume no Gerenciador de Catálogos:

1. No workspace do Azure Databricks, clique em Catálogo.
2. Pesquise ou procure o volume que você deseja remover e selecione-o.
3. Clique no à direita do nome do volume e selecione Excluir.
4. Clique em Excluir na caixa de diálogo que aparece para confirmar.

SQL

Use a seguinte sintaxe para remover um volume:

DROP VOLUME IF EXISTS <volume-name>;

Consulte DROP VOLUME.

Permissões necessárias

Somente usuários com privilégios de proprietário podem remover um volume. Consulte Propriedade do volume.

Renomear um volume

Explorador do Catálogo

Para renomear um volume no Gerenciador de Catálogos:

1. No workspace do Azure Databricks, clique em Catálogo.
2. Pesquise ou procure o volume que você deseja renomear e selecioná-lo.
3. Clique em à direita do nome do volume e selecione Renomear.
4. Insira um nome para o volume.
5. Clique em Save (Salvar).

SQL

Use a seguinte sintaxe para renomear um volume:

ALTER VOLUME <volume-name> RENAME TO <new-volume-name>

Consulte ALTER VOLUME.

Permissões necessárias

Somente usuários com privilégios de proprietário podem renomear um volume. Consulte Propriedade do volume.

Alterar permissões em um volume

Explorador do Catálogo

Para alterar permissões de um volume no Gerenciador de Catálogos, comece navegando até a interface do usuário de permissões:

1. No workspace do Azure Databricks, clique em Catálogo.
2. Pesquise ou procure o volume no qual você deseja modificar as permissões de alteração e selecione-o.
3. Clique na guia Permissões . As privleges concedidas e herdadas no volume são exibidas.

Para conceder novos privilégios, faça o seguinte:

1. Clique em Conceder.
2. Digite para pesquisar uma entidade de segurança. Selecione a entidade de segurança que você deseja conceder privilégios. Você pode selecionar várias entidades de segurança.
3. Selecione os privilégios que você deseja conceder.
4. Clique em Conceder.

Para revogar privilégios, faça o seguinte:

1. Selecione uma ou mais concessões.
2. Clique em Revogar.
3. Clique em Revogar na caixa de diálogo que parece confirmar.

SQL

Use GRANT e REVOKE para alterar permissões em um volume.

Por exemplo, a sintaxe a seguir concede READ FILES em um volume:

GRANT READ FILES ON VOLUME <volume-name> TO <principal>

A seguinte sintaxe para revogar WRITE FILES em um volume:

REVOKE WRITE FILES ON VOLUME <volume-name> TO <principal>

Consulte Gerenciar privilégios no Catálogo do Unity.

Permissões necessárias

Somente usuários com privilégios de proprietário podem alterar as permissões de um volume. Consulte Propriedade do volume.

Alterar proprietário de volume

Explorador do Catálogo

Para alterar o proprietário de um volume no Catalog Explorer, faça o seguinte:

1. No workspace do Azure Databricks, clique em Catálogo.
2. Pesquise ou procure o volume para o qual você deseja alterar a propriedade e selecione-o.
3. No painel Sobre esse volume, clique no ao lado de Owner.
4. Digite para pesquisar uma entidade de segurança e selecioná-la.
5. Clique em Save (Salvar).

SQL

Use a seguinte sintaxe para alterar o proprietário de um volume:

ALTER VOLUME <volume-name> SET OWNER TO <principal-name>

Consulte ALTER VOLUME.

Permissões necessárias

Somente usuários com privilégios de proprietário podem alterar o proprietário de um volume. Consulte Propriedade do volume.