Gerenciar esquemas

Este artigo mostra como exibir, atualizar e excluir esquemas no Unity Catalog.

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

Nota

No metastore do Hive, você deve usar comandos SQL para gerenciar esquemas. O comportamento no metastore herdado do Hive difere do Unity Catalog. As permissões necessárias dependem se você está ou não usando o controle de acesso à tabela. Consulte Esquemas no metastore do Hive e privilégios do metastore do Hive e objetos protegíveis (legado).

Antes de começar

Para trabalhar com esquemas no Unity Catalog:

• Você deve ter um metastore do Unity Catalog vinculado ao espaço de trabalho onde você executa a criação do esquema.
• O cluster que você usa para executar um bloco de anotações para gerenciar um esquema deve usar um modo de acesso compatível com o Catálogo Unity. Consulte Modos de acesso. Os armazéns SQL sempre suportam o Unity Catalog.
• As permissões necessárias para alterar, visualizar e soltar esquemas no Unity Catalog estão listadas nas seções a seguir.

Localizar e visualizar esquemas

No Unity Catalog, os usuários podem ver todos os esquemas nos quais lhes foi atribuída a USE SCHEMA permissão, juntamente com a USE CATALOG permissão 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 SELECT permissão na tabela ou exibição.

Explorador de Catálogos

1. Faça login em um espaço de trabalho vinculado ao metastore do Unity Catalog.
2. Clique em Catálogo.
3. No painel Catálogo à esquerda, clique no catálogo que contém o esquema (hive_metastorese estiver no metastore do Hive).

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

SQL

Execute SHOW SCHEMAS em um bloco de anotações 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 detalhes sobre um esquema. Consulte MOSTRAR ESQUEMAS e DESCREVER ESQUEMA.

Atualizar um esquema

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

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

• Para mudar 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 tags, 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 de metastore.

Explorador de Catálogos

1. Faça login em um espaço de trabalho vinculado ao metastore do Unity Catalog.

2. Clique em Catálogo.

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

   Como alternativa, você pode pesquisar o esquema usando o campo Tipo 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 : atualize o proprietário, adicione ou atualize tags, adicione ou atualize comentários. Consulte Gerenciar a propriedade de objetos do Catálogo Unity, Aplicar tags a objetos protegíveis do Catálogo Unity e Adicionar comentários a dados e ativos de IA.
   • Guia Permissões : conceda e revogue privilégios no esquema. Consulte Gerenciar privilégios no Catálogo Unity.
   • O menu kebab: renomeie o esquema.
   • Botão Criar : crie uma tabela ou volume no esquema. Consulte Criar ou modificar uma tabela usando o upload de arquivo e O que são volumes do Catálogo Unity?.

SQL

• Para alterar o proprietário, adicionar ou atualizar tags, definir propriedades de esquema e gerenciar a otimização preditiva nas tabelas em um esquema, execute o ALTER SCHEMA comando em um bloco de anotações ou no editor de consultas SQL. Consulte ALTER SCHEMA.
• Para conceder ou revogar privilégios, use o GRANT comando ou REVOKE . Ver GRANT e REVOKE.
• Para adicionar tabelas, volumes e outros dados e ativos de 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 Unity Catalog).
• Para renomear um esquema usando SQL, você deve criar um novo esquema e mover todos os ativos para o novo esquema.

Excluir um esquema

Para excluir (ou descartar) um esquema em um catálogo do Unity Catalog, você pode usar o Catalog Explorer ou um comando SQL.

Permissões necessárias: para soltar um esquema no Unity Catalog, você deve ser seu proprietário.

Explorador de Catálogos

Você deve excluir todas as tabelas no esquema antes de poder excluí-lo.

1. Faça login em um espaço de trabalho vinculado ao metastore.
2. Clique em Catálogo.
3. No painel Catálogo, à esquerda, clique no esquema que deseja excluir.
4. No painel de detalhes, clique no menu kebab 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 bloco de anotações ou no editor de consultas SQL. Os itens entre parênteses são opcionais. Substitua o espaço reservado <schema-name>.

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

Se você usar DROP SCHEMA sem a CASCADE opção, deverá excluir todas as tabelas no esquema antes de poder 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óximos passos

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