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

To create a volume in Catalog Explorer:

1. In your Databricks workspace, click Catalog.
2. Search or browse for the schema that you want to add the volume to and select it.
3. Click the Create Volume button. (You must have sufficient privileges.)
4. Enter a name for the volume.
5. If you wish to create an external volume, do the following:
   1. Choose an external location in which to create the volume.
   2. Edit the path to reflect the sub-directory where you want to create the volume.
6. Provide a comment (optional).
7. Click Create.

SQL

To create a managed volume, use the following syntax:

SQL

CREATE VOLUME <catalog>.<schema>.<volume-name>;

To create an external volume, add the LOCATION clause, as in the following example:

SQL

CREATE EXTERNAL VOLUME <catalog>.<schema>.<external-volume-name>
LOCATION 's3://<external-location-bucket-path>/<directory>';

nota

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

To drop a volume in Catalog Explorer:

1. In your Databricks workspace, click Catalog.
2. Search or browse for the volume that you want to drop and select it.
3. Click the to the right of the volume name and select Delete.
4. Click Delete in the dialog that appears to confirm.

SQL

Use the following syntax to drop a volume:

SQL

DROP VOLUME IF EXISTS <volume-name>;

See DROP VOLUME.

nota

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

To rename a volume in Catalog Explorer:

1. In your Databricks workspace, click Catalog.
2. Search or browse for the volume that you want to rename and select it.
3. Click the to the right of the volume name and select Rename.
4. Enter a name for the volume.
5. Click Save.

SQL

Use the following syntax to rename a volume:

SQL

ALTER VOLUME <volume-name> RENAME TO <new-volume-name>

See 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

To change permissions a volume in Catalog Explorer, start by navigating to the permissions UI:

1. In your Databricks workspace, click Catalog.
2. Search or browse for the volume that you want to modify change permissions on and select it.
3. Click the Permissions tab. Granted and inherited privleges on the volume are displayed.

To grant new privileges, do the following:

1. Click Grant.

2. Type to search for a principal. Select the principal you wish to grant privileges. You can select multiple principals.

3. Select the privileges you wish to grant.

4. Click Grant.

nota

If the principal does not have USE CATALOG and USE SCHEMA privileges on parent resources, a warning appears that additional privileges are required. If you have sufficient permissions on the parent resources to grant those privileges, a checkbox appears to also grant those privileges.

To revoke privileges, do the following:

1. Select one or more grants.
2. Click Revoke.
3. Click Revoke in the dialog that appears to confirm.

SQL

Use GRANT and REVOKE to change permissions on a volume.

For example, the following syntax grants READ VOLUME on a volume:

SQL

GRANT READ VOLUME ON VOLUME <volume-name> TO <principal>

The following syntax to revokes WRITE VOLUME on a volume:

SQL

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

To change the owner of a volume in Catalog Explorer, do the following:

1. In your Databricks workspace, click Catalog.
2. Search or browse for the volume that you want to change ownership for and select it.
3. In the About this volume pane, click the next to Owner.
4. Type to search for a principal and select it.
5. Click Save.

SQL

Use the following syntax to change the owner of a volume:

SQL

ALTER VOLUME <volume-name> SET OWNER TO <principal-name>

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