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 'gcs://<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:
Escolha um local externo para criar o volume.
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 |
|
Catálogo |
|
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.