Gerenciar catálogos

Este artigo mostra como view, atualizar e excluir catálogos em Unity Catalog. Um catálogo contém esquemas (bancos de dados), e um esquema contém tabelas, visualizações, volumes, modelos e funções.

Para obter mais informações sobre catálogos, consulte O que são catálogos em Databricks? e Criar catálogos. Para saber como conceder e revogar o acesso a um catálogo, consulte Privilégios e objetos protegíveis do Unity Catalog.

Para saber como gerenciar um catálogo externo, um objeto Unity Catalog que espelha um banco de dados em um sistema de dados externo, consulte gerenciar e trabalhar com catálogos externos.

Requisitos

Para view, atualizar ou excluir um catálogo:

É necessário ter um metastore Unity Catalog vinculado ao workspace onde o senhor realiza a tarefa.
O cluster que o senhor usa para executar a Notebook para gerenciar um catálogo 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 diferem de acordo com a tarefa e são fornecidas em cada seção a seguir.

Ver detalhes do catálogo

Permissão necessária: Os usuários podem ver os metadados de todos os catálogos que possuem ou aos quais foi atribuída a permissão USE CATALOG ou BROWSE.

Para view informações sobre um catálogo, o senhor pode usar o Catalog Explorer ou o comando SQL.

Efetue login em um workspace vinculado ao metastore.
Clique em Catalog.
No painel Catálogo, localize o catálogo e clique em seu nome.

Alguns detalhes estão listados na parte superior da página. Outros podem ser visualizados na guia Schemas, Details, Permissions e workspace.

execução SHOW CATALOGS em um Notebook ou no editor de consultas SQL para listar todos os catálogos em um metastore ou aqueles que correspondem a uma expressão regular.

Execute o seguinte comando SQL para obter detalhes sobre um catálogo. Os itens entre parênteses são opcionais. Substitua o espaço reservado <catalog-name>.

DESCRIBE CATALOG <catalog-name>;

Use CATALOG EXTENDED para obter todos os detalhes.

Para obter mais informações, consulte DESCRIBE CATALOG.

Atualizar um catálogo

Para atualizar (ou alterar) um catálogo, o senhor pode usar o Catalog Explorer ou um comando SQL.

Permissões necessárias: As permissões necessárias para atualizar um catálogo dependem da atualização:

Para alterar o proprietário, o senhor deve ser o proprietário.
Para renomear o catálogo, 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 MODIFY e USE CATALOG no catálogo.
Para conceder e revogar permissões no catálogo, o senhor deve ser o proprietário do catálogo 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 o senhor deseja atualizar.
Use os seguintes elementos de página na página de detalhes do catálogo para atualizar o catálogo:
- 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 catálogo. Consulte gerenciar privilégios em Unity Catalog.
- O menu kebab: Renomear o catálogo.
- Botão Create schema (Criar esquema ): adiciona um esquema ao catálogo. Consulte Criar esquemas.

Para alterar o proprietário, adicionar ou atualizar tags e gerenciar a otimização preditiva nas tabelas de um catálogo, execute o comando ALTER CATALOG em um Notebook ou no editor de consultas SQL. Veja ALTER CATALOG.
Para conceder ou revogar privilégios, use o comando GRANT ou REVOKE. Consulte GRANT e REVOKE.
Para adicionar esquemas ao catálogo, consulte O que são esquemas no Databricks?
Para renomear um catálogo usando SQL, o senhor deve criar um novo catálogo e mover todos os ativos para o novo catálogo.

Excluir um catálogo

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

Permissão necessária: Proprietário do catálogo.

O senhor deve excluir todos os esquemas do catálogo, exceto information_schema, antes de excluir um catálogo. Isso inclui o esquema default criado automaticamente.

Efetue login em um workspace vinculado ao metastore.
Clique em Catalog.
No painel Catálogo, à esquerda, clique no catálogo que o senhor deseja excluir.
No painel de detalhes, clique no menu kebab à esquerda do botão Create database (Criar banco de dados ) e selecione Delete (Excluir).
Na caixa de diálogo Excluir catálogo, clique em Excluir.

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

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

Se o usuário usar DROP CATALOG sem a opção CASCADE, deverá excluir todos os esquemas do catálogo, exceto information_schema, antes de excluir o catálogo. Isso inclui o esquema default criado automaticamente.

DROP CATALOG [ IF EXISTS ] <catalog-name> [ RESTRICT | CASCADE ]

Por exemplo, para excluir um catálogo chamado vaccine e seus esquemas:

DROP CATALOG vaccine CASCADE