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 mudar o proprietário, você deve ser o proprietário.
• Para renomear o catálogo, você deve ser o proprietário.
• Para adicionar ou atualizar um comentário ou tags, você deve ser o proprietário ou ter 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 ou um administrador de metastore.

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.

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