Criar e gerenciar volumes

Este artigo contém exemplos de sintaxe para criar, gerenciar e eliminar volumes do site Unity Catalog.

Para obter instruções sobre como fazer upload, gerenciar ou trabalhar com arquivos em volumes, consulte Gerenciar arquivos em volumes.
Para obter detalhes sobre a exploração de volumes e seus conteúdos, consulte Explorar o armazenamento e localizar arquivos de dados.
Para obter uma visão geral dos volumes, consulte O que são volumes do Unity Catalog?
Para obter detalhes sobre gerenciar e volumes externos, consulte gerenciar vs. volumes externos.
Para obter detalhes sobre as permissões do Unity Catalog, consulte Quais são os privilégios dos volumes?

Criar um volume

Quando o senhor cria um volume usando o SQL, o Catalog Explorer ou outras ferramentas, um volume gerenciar é criado pelo default. Para criar um volume externo, o senhor associa o volume a um local externo.

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

Para criar um volume gerenciar, 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 's3://<external-location-bucket-path>/<directory>';

Para criar um volume no Catalog Explorer:

Em seu site Databricks workspace, clique em Catalog.
Pesquise ou procure o esquema ao qual deseja adicionar o volume e selecione-o.
Clique no botão Create Volume. (O senhor deve ter privilégios suficientes).
Digite um nome para o volume.
Se o senhor 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 onde o senhor deseja criar o volume.
Forneça um comentário (opcional).
Clique em Criar.

Observação

Quando o senhor define um volume, o acesso do URI cloud aos dados no caminho do volume é regido pelas permissões do volume.

Consulte CREATE VOLUME.

Permissões necessárias

O senhor deve ter as seguintes permissões para criar um volume:

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

Pelo site default, os volumes gerenciar são criados no local de armazenamento gerenciar associado ao esquema que os contém. Consulte Especificar um local de armazenamento gerenciar em Unity Catalog.

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

Diminuir um volume

Use a seguinte sintaxe para eliminar um volume:

DROP VOLUME IF EXISTS <volume-name>;

Consulte DROP VOLUME.

Observação

O descarte de um volume gerenciar marca os arquivos contidos para exclusão, enquanto o descarte de um volume externo não o faz. Veja as diferenças de comportamento entre volumes gerenciar e externos.

Permissões necessárias

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

Renomear um volume

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 as permissões em um volume

Use GRANT e REVOKE para alterar as 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 revoga WRITE FILES em um volume:

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

Consulte Gerenciar privilégios no Unity Catalog.

Permissões necessárias

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

Alterar o proprietário do volume

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.