Criar e gerenciar volumes

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

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

Criar um volume

Quando você cria um volume usando SQL, Catalog Explorer ou outras ferramentas, um volume gerenciado é criado por padrão. Para criar um volume externo, associe-o 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 em nuvem para criar um volume externo.

SQL

Para criar um volume gerenciado, use a seguinte sintaxe:

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

Para criar um volume externo, adicione a LOCATION cláusula, 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>';

Explorador de Catálogos

Para criar um volume no Catalog Explorer:

1. No seu espaço de trabalho do Azure Databricks, clique em Catálogo.
2. Pesquise ou procure o esquema ao qual você deseja 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 desejar 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 onde você deseja criar o volume.
6. Forneça um comentário (opcional).
7. Clique em Criar.

Nota

Quando você define um volume, o acesso URI da nuvem aos dados sob o caminho do volume é regido pelas permissões do volume.

Consulte CREATE VOLUME.

Permissões obrigatórias

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

Recurso	Permissões necessárias
Esquema	USE SCHEMA, CREATE VOLUME
Catálogo	USE CATALOG

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 Unity.

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

Solte um volume

Use a sintaxe a seguir para soltar um volume:

DROP VOLUME IF EXISTS <volume-name>;

Consulte DROP VOLUME.

Nota

Soltar um volume gerenciado marca os arquivos contidos para exclusão, enquanto soltar um volume externo não. Consulte Diferenças de comportamento entre volumes gerenciados e externos.

Permissões obrigatórias

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

Renomear um volume

Use a sintaxe a seguir para renomear um volume:

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

Ver ALTER VOLUME.

Permissões obrigatórias

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

Alterar permissões em um volume

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 sintaxe a seguir a ser revogada WRITE FILES em um volume:

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

Consulte Gerenciar privilégios no Catálogo Unity.

Permissões obrigatórias

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

Alterar proprietário do volume

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

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

Ver ALTER VOLUME.

Permissões obrigatórias

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