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 como explorar volumes e seus conteúdos, consulte Explorar o armazenamento e encontrar 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?
Crie 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, você 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 objetos na nuvem para criar um volume externo.
- Catalog Explorer
- SQL
Para criar um volume no Catalog Explorer:
-
Em seu site Databricks workspace, clique em
Catalog .
-
Pesquise ou procure o esquema ao qual você deseja adicionar o volume e selecione-o.
-
Clique no botão Criar volume . (Você deve ter privilégios suficientes.)
-
Insira um nome para o volume.
-
Se você 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 em que você deseja criar o volume.
-
Forneça um comentário (opcional).
-
Clique em Criar .
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>';
Quando você define um volume externo, o acesso do URI de nuvem aos dados no caminho do volume é regido pelos privilégios concedidos no volume, não pelos privilégios concedidos no local externo em que o volume está armazenado.
Consulte CREATE VOLUME.
Permissões necessárias
Você 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 um volume externo, o senhor também deve ter o privilégio CREATE EXTERNAL VOLUME
para o local externo que gerencia o armazenamento de objetos na nuvem especificado na cláusula LOCATION
. Consulte Conectar-se ao serviço e ao armazenamento de objetos na nuvem usando Unity Catalog.
Diminua um volume
- Catalog Explorer
- SQL
Para soltar um volume no Catalog Explorer:
- Em seu site Databricks workspace, clique em
Catalog .
- Pesquise ou procure o volume que você deseja reduzir e selecione-o.
- Clique
à direita do nome do volume e selecione Excluir .
- Clique em Excluir na caixa de diálogo exibida para confirmar.
Use a sintaxe a seguir para reduzir um volume:
DROP VOLUME IF EXISTS <volume-name>;
Consulte DROP VOLUME.
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
Usuários com privilégios de proprietário ou com o privilégio MANAGE
podem descartar um volume. Consulte Propriedade do volume e privilégios MANAGE
.
Renomear um volume
- Catalog Explorer
- SQL
Para renomear um volume no Catalog Explorer:
- Em seu site Databricks workspace, clique em
Catalog .
- Pesquise ou procure o volume que você deseja renomear e selecione-o.
- Clique
à direita do nome do volume e selecione Renomear .
- Insira um nome para o volume.
- Clique em Salvar .
Use a sintaxe a seguir para renomear um volume:
ALTER VOLUME <volume-name> RENAME TO <new-volume-name>
Consulte ALTER VOLUME.
Permissões necessárias
Usuários com privilégios de proprietário ou com o privilégio MANAGE
podem renomear um volume. Consulte Propriedade do volume e privilégios MANAGE
.
Alterar permissões em um volume
- Catalog Explorer
- SQL
Para alterar as permissões de um volume no Catalog Explorer, comece navegando até a UI de permissões:
- Em seu site Databricks workspace, clique em
Catalog .
- Pesquise ou procure o volume no qual você deseja modificar as permissões de alteração e selecione-o.
- Clique em Permissions (Permissões ) tab. Os privilégios concedidos e herdados no volume são exibidos.
Para conceder novos privilégios, faça o seguinte:
- Clique em Conceder .
- Digite para pesquisar um diretor. Selecione o diretor ao qual você deseja conceder privilégios. Você pode selecionar vários diretores.
- Selecione os privilégios que você deseja conceder.
- Clique em Conceder .
Se o diretor não tiver os privilégios USE CATALOG
e USE SCHEMA
no recurso pai, será exibido um aviso de que são necessários privilégios adicionais. Se o senhor tiver permissões suficientes no recurso pai para conceder esses privilégios, será exibida uma caixa de seleção para também conceder esses privilégios.
Para revogar privilégios, faça o seguinte:
- Selecione uma ou mais bolsas.
- Clique em Revogar.
- Clique em Revogar na caixa de diálogo exibida para confirmar.
Use GRANT
e REVOKE
para alterar as permissões em um volume.
Por exemplo, a sintaxe a seguir concede READ VOLUME
em um volume:
GRANT READ VOLUME ON VOLUME <volume-name> TO <principal>
A seguinte sintaxe para revogar WRITE VOLUME
em um volume:
REVOKE WRITE VOLUME ON VOLUME <volume-name> TO <principal>
Consulte gerenciar privilégios em Unity Catalog.
Permissões necessárias
Usuários com privilégios de proprietário ou com o privilégio MANAGE
podem ter permissões de um volume. Consulte Propriedade do volume e privilégios MANAGE
.
Alterar proprietário do volume
- Catalog Explorer
- SQL
Para alterar o proprietário de um volume no Catalog Explorer, faça o seguinte:
- Em seu site Databricks workspace, clique em
Catalog .
- Pesquise ou procure o volume do qual você deseja alterar a propriedade e selecione-o.
- No painel Sobre este volume , clique
ao lado de Proprietário .
- Digite para pesquisar um diretor e selecioná-lo.
- Clique em Salvar .
Use a sintaxe a seguir para alterar o proprietário de um volume:
ALTER VOLUME <volume-name> SET OWNER TO <principal-name>
Consulte ALTER VOLUME.
Permissões necessárias
Usuários com privilégios de proprietário ou com o privilégio MANAGE
podem alterar o proprietário de um volume. Consulte Propriedade do volume e privilégios MANAGE
.