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.
Explorador de Catálogos
Para criar um volume no Catalog Explorer:
- No seu espaço de trabalho do Azure Databricks, clique em
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.
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 e serviços de objetos na nuvem usando o Unity Catalog.
Solte um volume
Explorador de Catálogos
Para soltar um volume no Gerenciador de Catálogos:
- No seu espaço de trabalho do Azure Databricks, clique em Catálogo.
- Pesquise ou procure o volume que deseja soltar e selecione-o.
- Clique à
direita do nome do volume e selecione Excluir. - 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>;
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
Explorador de Catálogos
Para renomear um volume no Gerenciador de Catálogos:
- No seu espaço de trabalho do Azure Databricks, clique em Catálogo.
- Pesquise ou procure o volume que deseja renomear e selecione-o.
- Clique à 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
Somente usuários com privilégios de proprietário podem renomear um volume. Consulte Propriedade do volume.
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 em 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 em Conceder.
- Digite para procurar uma entidade de segurança. Selecione a entidade de segurança à qual deseja conceder privilégios. Você pode selecionar vários principais.
- Selecione os privilégios que deseja conceder.
- Clique em 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 em Revogar.
- Clique em Revogar na caixa 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 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
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 em Catálogo.
- Pesquise ou procure o volume para o 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
Somente usuários com privilégios de proprietário podem alterar o proprietário de um volume. Consulte Propriedade do volume.