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 geridos e externos, consulte volumes geridos vs. externos.
- Para obter detalhes sobre permissões 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.
Explorador de Catálogos
Para criar um volume no Catalog Explorer:
- No seu espaço de trabalho do Azure Databricks, clique no ícone do Catálogo
Catálogo. - 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 desejar 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 você deseja criar o volume.
- Forneça um comentário (opcional).
- 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 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>';
Nota
Quando você define um volume externo, o acesso URI da nuvem aos dados sob o caminho do volume é regido pelos privilégios concedidos no volume, não pelos privilégios concedidos no local externo onde o volume está armazenado.
Ver 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 gerido no Unity Catalog.
Para criar volumes externos, você também deve ter o privilégio de CREATE EXTERNAL VOLUME para o local externo que gerencia o armazenamento de objetos na nuvem especificado na cláusula LOCATION. Consulte Conectar-se ao armazenamento e serviços de objetos na nuvem usando o Unity Catalog.
Solte um volume
Explorador de Catálogos
Para remover um volume no Explorador de Catálogos:
- No seu espaço de trabalho do Azure Databricks, clique Catálogo.
- Pesquise ou procure o volume que deseja remover e selecione-o.
- Clique no
à direita do nome do volume e selecione Apagar. - Clique em Excluir na caixa de diálogo que aparece para confirmar.
SQL
Use a sintaxe a seguir para soltar um volume:
DROP VOLUME IF EXISTS <volume-name>;
Ver 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
Utilizadores com privilégios de proprietário ou o privilégio de MANAGE podem eliminar um volume. Consulte Propriedade do volume e GERIR PRIVILÉGIOS.
Renomear um volume
Explorador de Catálogos
Para renomear um volume no Gerenciador de Catálogos:
- No seu espaço de trabalho do Azure Databricks, clique Catálogo.
- Pesquise ou procure o volume que deseja renomear e selecione-o.
- Clique no menu à direita do nome do volume e selecione Renomear.
- Insira um nome para o volume.
- Clique em Guardar.
SQL
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
Os usuários com privilégios de proprietário ou o privilégio de MANAGE podem renomear um volume. Consulte Propriedade do volume e GERIR PRIVILÉGIOS.
Alterar permissões em um volume
Explorador de Catálogos
Para alterar as permissões de um volume no Gerenciador de Catálogos, comece navegando até a interface do usuário de permissões:
- No seu espaço de trabalho do Azure Databricks, clique Catálogo.
- Pesquise ou procure o volume no qual você deseja modificar as permissões de alteração e selecione-o.
- Clique na guia Permissões . Privilégios concedidos e herdados no volume são exibidos.
Para conceder novos privilégios, faça o seguinte:
- Clique Conceder.
- Digite para procurar uma entidade de segurança. Selecione o principal ao qual deseja conceder privilégios. Você pode selecionar vários entidades principais.
- Selecione os privilégios que deseja conceder.
- Clique Conceder.
Nota
Se a entidade de segurança não tiver USE CATALOG privilégios e USE SCHEMA em recursos pai, será exibido um aviso de que privilégios adicionais são necessários. Se você tiver permissões suficientes nos recursos pai para conceder esses privilégios, uma caixa de seleção aparecerá para também conceder esses privilégios.
Para revogar privilégios, faça o seguinte:
- Selecione uma ou mais subvenções.
- Clique Revogar.
- Clique Revogar na janela de diálogo que aparece para confirmar.
SQL
Use GRANT e REVOKE para alterar 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 sintaxe a seguir a ser revogada WRITE VOLUME em um volume:
REVOKE WRITE VOLUME ON VOLUME <volume-name> TO <principal>
Consulte Gerenciar privilégios no Catálogo Unity.
Permissões obrigatórias
Usuários com privilégios de proprietário ou o privilégio de MANAGE podem gerir as permissões de um volume. Consulte Propriedade do volume e GERIR PRIVILÉGIOS.
Alterar proprietário do volume
Explorador de Catálogos
Para alterar o proprietário de um volume no Gerenciador de Catálogos, faça o seguinte:
- No seu espaço de trabalho do Azure Databricks, clique no ícone Catálogo Catálogo.
- Pesquise ou procure pelo volume do qual pretende alterar a propriedade e selecione-o.
-
No painel Sobre este volume, clique ao
lado de Proprietário. - Digite para procurar uma entidade de segurança e selecione-a.
- Clique em Guardar.
SQL
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
Os usuários com privilégios de proprietário ou o privilégio de MANAGE podem alterar o proprietário de um volume. Consulte Propriedade do volume e GERIR PRIVILÉGIOS.