Gerenciar catálogos

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

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

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

Requisitos

Para visualizar, atualizar ou excluir um catálogo:

• Você deve ter um metastore do Unity Catalog vinculado ao espaço de trabalho onde você executa a tarefa.

• O cluster que você usa para executar um bloco de anotações para gerenciar um catálogo deve usar um modo de acesso compatível com o Catálogo Unity. Consulte Modos de acesso.

  Os armazéns SQL sempre suportam o 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 lhes foi atribuída a USE CATALOG permissão ou BROWSE .

Para exibir informações sobre um catálogo, você pode usar o Gerenciador de Catálogos ou um comando SQL.

Explorador de Catálogos

1. Faça login em um espaço de trabalho 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 no topo da página. Outros podem ser visualizados nas guias Esquemas, Detalhes, Permissões e Espaços de trabalho.

SQL

Execute SHOW CATALOGS em um bloco de anotações 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 detalhes completos.

Para obter mais informações, consulte DESCREVER CATÁLOGO.

Atualizar um catálogo

Para atualizar (ou alterar) um catálogo, você pode usar o Gerenciador de Catálogos 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, deves 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 de metastore ou ter MANAGE e USE CATALOG no catálogo.

Explorador de Catálogos

1. Faça login em um espaço de trabalho vinculado ao metastore do Unity Catalog.
2. Clique em Catálogo.
3. No painel Catálogo à esquerda, clique no catálogo que pretende atualizar.
4. Use os seguintes elementos de página na página de detalhes do catálogo para atualizar o catálogo:
   • Guia Visão geral : atualize o proprietário, adicione ou atualize tags, adicione ou atualize comentários. Consulte Gerenciar a propriedade de objetos do Catálogo Unity, Aplicar tags a objetos protegíveis do Catálogo Unity e Adicionar comentários a dados e ativos de IA.
   • Guia Permissões : conceda e revogue privilégios no catálogo. Consulte Gerenciar privilégios no Catálogo Unity.
   • 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 ALTER CATALOG comando em um bloco de anotações ou no editor de consultas SQL. Consulte ALTER CATALOG.
• Para conceder ou revogar privilégios, use o GRANT comando ou REVOKE . Ver GRANT e REVOKE.
• Para adicionar esquemas ao catálogo, consulte O que são esquemas no Azure Databricks?.
• Para renomear um catálogo usando SQL, você deve criar um novo catálogo e mover todos os ativos para o novo catálogo.

Excluir um catálogo

Para excluir (ou descartar) um catálogo, você pode usar o Gerenciador de Catálogos ou um comando SQL.

Permissão necessária: Proprietário do catálogo ou MANAGE e USE CATALOG no catálogo.

Explorador de Catálogos

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

1. Faça login em um espaço de trabalho vinculado ao metastore.
2. Clique em Catálogo.
3. No painel Catálogo, à esquerda, clique no catálogo que 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 bloco de anotações ou editor SQL Databricks. Os itens entre parênteses são opcionais. Substitua o espaço reservado <catalog-name>.

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

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

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

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

DROP CATALOG vaccine CASCADE