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
eUSE 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
ouREVOKE
. 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