Gerenciar esquemas

Este artigo mostra como exibir, atualizar e excluir esquemas no Catálogo do Unity.

Consulte também O que são esquemas no Azure Databricks? e Criar esquemas.

Antes de começar

Para trabalhar com esquemas no Catálogo do Unity:

• Você deve ter um metastore do Catálogo do Unity vinculado ao workspace em que executa a criação do esquema.
• O cluster que você usa para executar um notebook para gerenciar um esquema deve usar um modo de acesso em conformidade com o Catálogo do Unity. Consulte Modos de acesso. Os warehouses SQL sempre dão suporte para o Catálogo do Unity.
• As permissões necessárias para alterar, exibir e remover esquemas no Catálogo do Unity são listadas nas seções a seguir.

Localizar e exibir esquemas

No Catálogo do Unity, os usuários podem ver todos os esquemas nos quais receberam a permissão USE SCHEMA, juntamente com a permissão USE CATALOG no catálogo pai do esquema. Para acessar ou listar uma tabela ou exibição em um esquema, os usuários também devem ter permissão SELECT na tabela ou exibição.

Explorador do Catálogo

1. Faça logon em um workspace vinculado ao metastore do Catálogo do Unity.
2. Clique em Catálogo.
3. No painel Catálogo à esquerda, clique no catálogo que contém o esquema (hive_metastore se ele estiver no metastore do Hive).

Como alternativa, você pode pesquisar o esquema usando o campo Digitar para filtrar no painel Catálogo.

SQL

Execute SHOW SCHEMAS em um notebook ou no editor de consultas SQL para listar todos os esquemas em um catálogo ou aqueles que correspondem a uma expressão regular. Execute DESCRIBE SCHEMA para obter os detalhes sobre um esquema. Consulte SHOW SCHEMAS e DESCRIBE SCHEMA.

Atualizar um esquema

Para atualizar (ou alterar) um esquema em um catálogo do Catálogo do Unity, você pode usar o Explorador de Catálogos ou um comando SQL.

Permissões necessárias: as permissões necessárias para atualizar um esquema no Catálogo do Unity dependem da atualização:

• Para alterar o proprietário, você deve ser o proprietário.
• Para renomear o esquema, você deve ser o proprietário.
• Para adicionar ou atualizar um comentário ou marcas, você deve ser o proprietário ou ter USE SCHEMA e MODIFY no esquema e USE CATALOG no catálogo pai.
• Para adicionar uma tabela, você deve ser o proprietário do esquema ou ter USE SCHEMA e CREATE TABLE no esquema e USE CATALOG no catálogo pai.
• Para adicionar um volume, você deve ser o proprietário do esquema ou ter USE SCHEMA e CREATE VOLUME no esquema e USE CATALOG no catálogo pai.
• Para conceder e revogar permissões no esquema, você deve ser o proprietário do esquema, o proprietário do catálogo pai ou um administrador do metastore.

Explorador do Catálogo

1. Faça logon em um workspace vinculado ao metastore do Catálogo do Unity.

2. Clique em Catálogo.

3. No painel Catálogo à esquerda, clique no catálogo que contém o esquema e clique no esquema para abrir a página de detalhes do esquema.

   Como alternativa, você pode pesquisar o esquema usando o campo Digitar para filtrar no painel Catálogo.

4. Use os seguintes elementos de página na página de detalhes do esquema para atualizar o esquema:

   • Guia Visão geral: atualizar o proprietário, adicionar ou atualizar marcas e adicionar ou atualizar comentários. Consulte Gerenciar propriedade de objeto do Catálogo do Unity, Aplicar marcas a objetos protegíveis do Catálogo do Unity e Adicionar comentários a ativos de dados e IA.
   • Guia Permissões: conceder e revogar privilégios no esquema. Consulte Gerenciar privilégios no Catálogo do Unity.
   • O menu de kebab : Renomear o esquema.
   • Botão Criar: criar uma tabela ou volume no esquema. Consulte Criar ou modificar uma tabela usando o upload de arquivos e O que são volumes do Catálogo do Unity?.

SQL

• Para alterar o proprietário, adicionar ou atualizar marcas, definir propriedades do esquema e gerenciar a otimização preditiva nas tabelas em um esquema, execute o comando ALTER SCHEMA em um notebook ou no editor de consultas SQL. Consulte ALTER SCHEMA.
• Para conceder ou revogar privilégios, use o comando GRANT ou REVOKE. Consulte GRANT e REVOKE.
• Para adicionar tabelas, volumes e outros ativos de dados e IA a um esquema, consulte a documentação para criar o ativo (por exemplo , O que são tabelas e exibições? ou Gerenciar o ciclo de vida do modelo no Catálogo do Unity).
• Para renomear um esquema usando SQL, você deve criar um esquema e mover todos os ativos para o novo esquema.

Excluir um esquema

Para excluir (ou remover) um esquema em um catálogo do Catálogo do Unity, você pode usar o Explorador de Catálogos ou um comando SQL.

Permissões necessárias: para remover um esquema no Catálogo do Unity, você deve ser seu proprietário.

Explorador do Catálogo

Você deve excluir todas as tabelas do esquema para excluí-lo.

1. Faça logon em um workspace vinculado ao metastore.
2. Clique em Catálogo.
3. No painel Catálogo, à esquerda, clique no esquema que você deseja excluir.
4. No painel de detalhes, clique no menu de três linhas horizontais no canto superior direito e selecione Excluir.
5. Na caixa de diálogo Excluir esquema, clique em Excluir.

SQL

Execute o seguinte comando SQL em um notebook ou no editor de consultas SQL. Os itens entre colchetes são opcionais. Substitua o espaço reservado <schema-name>.

Para obter descrições de parâmetros, confira DROP SCHEMA.

Se você usar DROP SCHEMA sem a opção CASCADE, deverá excluir todas as tabelas do esquema para excluí-lo.

DROP SCHEMA [ IF EXISTS ] <schema-name> [ RESTRICT | CASCADE ]

Por exemplo, para excluir um esquema chamado inventory_schema e suas tabelas:

DROP SCHEMA inventory_schema CASCADE

Próximas etapas

Para saber como adicionar tabelas e volumes ao seu esquema, consulte O que são tabelas e exibições? e O que são volumes do Catálogo do Unity?.