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 clustering que o senhor usa para executar um 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 nos quais receberam a permissão USE CATALOG ou BROWSE.

nota

Os usuários com o privilégio BROWSE em um catálogo externo podem ver metadados obsoletos no Catalog Explorer ou ao acessar metadados por meio da API do Unity Catalog. A visibilidade dos metadados depende de quando REFRESH foi executado pela última vez para o catálogo externo.

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

Catalog Explorer

1. Efetue login em um workspace vinculado ao metastore.

2. Clique em Catálogo .

3. 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 .

SQL

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 colchetes são opcionais. Substitua o espaço reservado <catalog-name>.

SQL

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

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 você deseja atualizar.
4. 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 AI ativos.
   • Permissões tab: conceder e revogar privilégios no catálogo. Consulte gerenciar privilégios em Unity Catalog.
   • O menu de kebab: renomeie o catálogo.
   • Botão Criar esquema : adicione um esquema ao catálogo. Consulte Criar esquemas.

SQL

• 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. Consulte 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 ou MANAGE e USE CATALOG no catálogo.

Catalog Explorer

Você deve excluir todos os esquemas no catálogo, exceto information_schema, antes de excluir um catálogo. Isso inclui o esquema default criado automaticamente.

1. Efetue login em um workspace vinculado ao metastore.
2. Clique em Catálogo .
3. No painel Catálogo , à esquerda, clique no catálogo que você deseja excluir.
4. No painel de detalhes, clique no menu kebab à esquerda do botão Criar banco de dados e selecione Excluir.
5. Na caixa de diálogo Excluir catálogo , clique em Excluir .

SQL

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

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

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

SQL

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

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

SQL

DROP CATALOG vaccine CASCADE