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 no Catalog Explorer:

1. Em seu site Databricks workspace, clique em Catalog.

2. Pesquise ou procure o esquema ao qual deseja adicionar o volume e selecione-o.

3. Clique no botão Create Volume. (O senhor deve ter privilégios suficientes).

4. Digite um nome para o volume.

5. 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.

6. Forneça um comentário (opcional).

7. 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>';

Observação

Quando o senhor define um volume externo, o acesso do URI cloud aos dados no 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 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 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 cloud especificado na cláusula LOCATION. Consulte Conectar-se ao serviço e armazenamento de objetos cloud usando Unity Catalog.

Diminuir um volume

Para soltar um volume no Catalog Explorer:

1. Em seu site Databricks workspace, clique em Catalog.

2. Pesquise ou procure o volume que o senhor deseja soltar e selecione-o.

3. Clique no link à direita do nome do volume e selecione Delete (Excluir).

4. Clique em Excluir na caixa de diálogo que aparece para confirmar.

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

Para renomear um volume no Catalog Explorer:

1. Em seu site Databricks workspace, clique em Catalog.

2. Procure ou navegue até o volume que deseja renomear e selecione-o.

3. Clique em à direita do nome do volume e selecione Rename (Renomear).

4. Digite um nome para o volume.

5. Clique em Salvar.

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

Para alterar as permissões de um volume no Catalog Explorer, comece navegando até a UI de permissões:

1. Em seu site Databricks workspace, clique em Catalog.

2. Pesquise ou procure o volume no qual deseja modificar as permissões de alteração e selecione-o.

3. Clique em Permissions (Permissões ) tab. São exibidos os privilégios concedidos e herdados no volume.

Para conceder novos privilégios, faça o seguinte:

1. Clique em Conceder.

2. Digite para pesquisar um diretor. Selecione o diretor que deseja conceder privilégios. O senhor pode selecionar vários mandantes.

3. Selecione os privilégios que o senhor deseja conceder.

4. Clique em Conceder.

Observação

Se o principal 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:

1. Selecione um ou mais subsídios.

2. Clique em Revoke (Revogar).

3. Clique em Revoke na caixa de diálogo que aparece para confirmar.

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

Para alterar o proprietário de um volume no Catalog Explorer, faça o seguinte

1. Em seu site Databricks workspace, clique em Catalog.

2. Pesquise ou procure o volume para o qual deseja alterar a propriedade e selecione-o.

3. No painel About this volume (Sobre este volume ), clique em ao lado de Owner (Proprietário).

4. Digite para procurar um diretor e selecione-o.

5. Clique em Salvar.

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.