gerenciar esquemas

Este artigo mostra como view, atualizar e excluir esquemas em Unity Catalog.

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

Observação

Em Hive metastore, o senhor deve usar um comando SQL para gerenciar esquemas. O comportamento no legado Hive metastore é diferente de Unity Catalog. As permissões necessárias dependem do fato de o senhor estar ou não usando o controle de acesso da tabela. Consulte Schemas em Hive metastore e Hive metastore privileges and securable objects (legacy).

Antes de começar

Para trabalhar com esquemas no Unity Catalog:

O senhor deve ter um metastore Unity Catalog vinculado ao workspace onde realiza a criação do esquema.
O site cluster que o senhor usa para executar a Notebook para gerenciar um esquema deve usar um modo de acesso compatível com o Unity Catalog. Consulte Modos de acesso. SQL O armazém sempre oferece suporte ao site Unity Catalog.
As permissões necessárias para alterar, view, e soltar esquemas em 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 aos quais foi atribuída 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 view em um esquema, os usuários também devem ter permissão SELECT na tabela ou view.

log in para um workspace que está vinculado ao metastore Unity Catalog.
Clique em Catalog.
No painel Catalog (Catálogo ), à esquerda, clique no catálogo que contém o esquema (hive_metastore se estiver em Hive metastore).

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

execução 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. execução DESCRIBE SCHEMA para obter detalhes sobre um esquema. Consulte SHOW SCHEMAS e DESCRIBE SCHEMA.

Atualizar um esquema

Para atualizar (ou alterar) um esquema em um catálogo do Unity Catalog, o senhor 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 alterar o proprietário, o senhor deve ser o proprietário.
Para renomear o esquema, o senhor deve ser o proprietário.
Para adicionar ou atualizar um comentário ou tags, o senhor deve ser o proprietário ou ter USE SCHEMA e MODIFY no esquema e USE CATALOG no catálogo pai.
Para adicionar uma tabela, o senhor 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, o senhor 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, o senhor deve ser o proprietário do esquema, o proprietário do catálogo pai ou um administrador do metastore.

log em um workspace que está vinculado ao metastore Unity Catalog.
Clique em Catalog.
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, o senhor pode pesquisar o esquema usando o campo Tipo para filtrar no painel Catálogo.
Use os seguintes elementos de página na página de detalhes do esquema para atualizar o esquema:
- Visão geral tab: atualizar o proprietário, adicionar ou atualizar tags, adicionar ou atualizar comentários. Consulte gerenciar Unity Catalog propriedade de objetos, Aplicar tags a Unity Catalog objetos seguros e Adicionar comentários a dados e IA ativo.
- Permissões tab: conceder e revogar privilégios no esquema. Consulte gerenciar privilégios em Unity Catalog.
- O menu kebab: Renomear o esquema.
- Botão Criar: crie uma tabela ou volume no esquema. Consulte Criar ou modificar uma tabela usando o upload de arquivos e O que são volumes do Unity Catalog?

Para alterar o proprietário, adicionar ou atualizar tags, definir propriedades do esquema e gerenciar a otimização preditiva nas tabelas de um esquema, execute o comando ALTER SCHEMA em 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 dados e AI ativos a um esquema, consulte a documentação para criar o ativo (por exemplo, O que são tabelas e visualizações? ou gerenciar o ciclo de vida do modelo em Unity Catalog).
Para renomear um esquema usando SQL, o senhor deve criar um novo esquema e mover todos os ativos para o novo esquema.

Excluir um esquema

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

Permissões necessárias: Para descartar um esquema no Unity Catalog, o senhor deve ser seu proprietário.

O senhor deve excluir todas as tabelas do esquema antes de poder excluí-lo.

Efetue login em um workspace vinculado ao metastore.
Clique em Catalog.
No painel Catálogo, à esquerda, clique no esquema que o senhor deseja excluir.
No painel de detalhes, clique no menu kebab no canto superior direito e selecione Delete (Excluir).
Na caixa de diálogo Excluir esquema, clique em Excluir.

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

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

Se o senhor usar DROP SCHEMA sem a opção CASCADE, deverá excluir todas as tabelas do 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 visualizações? e What are Unity Catalog volumes (O que são volumes do Unity Catalog?).