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.

nota

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 clustering que o senhor usa para executar um 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 eliminar esquemas em Unity Catalog estão listadas nas seções a seguir.

Localizar e view 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.

Catalog Explorer

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

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

SQL

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, você deve ser o proprietário ou ter MANAGE e USE SCHEMA no esquema e USE CATALOG no catálogo principal.
• Para renomear o esquema, você deve ser o proprietário ou ter MANAGE e USE SCHEMA no esquema e USE CATALOG no catálogo principal.
• Para adicionar ou atualizar um comentário, você deve ser o proprietário ou ter USE SCHEMA e MANAGE ou MODIFY no esquema e USE CATALOG no catálogo principal.
• Para adicionar ou atualizar uma tag, você deve ser o proprietário ou ter USE SCHEMA e MODIFY no esquema e USE CATALOG no catálogo principal.
• 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 principal.
• 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 principal.
• Para conceder e revogar permissões no esquema, você deve ser o proprietário do esquema, o proprietário do catálogo principal, um administrador da metastore ou ter MANAGE e USE SCHEMA no esquema e USE CATALOG no catálogo principal.

Catalog Explorer

1. Faça login em um workspace que esteja vinculado ao metastore 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:

   • 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 AI ativos.
   • Permissões tab: conceder e revogar privilégios no esquema. Consulte gerenciar privilégios em Unity Catalog.
   • O menu kebab: renomeie o esquema.
   • Botão Criar : crie uma tabela ou volume no esquema. Consulte Criar ou modificar uma tabela usando upload de arquivos e O que são volumes do Unity Catalog?

SQL

• 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 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 dados e AI ativos a um esquema, consulte a documentação para criar o ativo (por exemplo, O que é uma tabela? 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.

Catalog Explorer

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

1. Efetue login 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 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 Notebook ou no editor de consultas SQL. Os itens entre colchetes são opcionais. Substitua o espaço reservado <schema-name>.

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

Se você usar DROP SCHEMA sem a opção CASCADE, deverá excluir todas as tabelas no esquema antes de excluí-las.

SQL

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

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

SQL

DROP SCHEMA inventory_schema CASCADE

Próximas etapas

Para saber como adicionar tabelas e volumes ao seu esquema, consulte O que é uma tabela? e What are Unity Catalog volumes (O que são volumes do Unity Catalog?).