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 acesso a um catálogo, consulte privilégios e objetos securitizáveis do Unity Catalog.

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 metadados de todos os catálogos que possuem ou nos quais lhes foi atribuída a permissão USE CATALOG 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 no Catálogo.

3. No painel Catálogo, localize o catálogo e clique no 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 marcador de posição <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, 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, 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 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 no 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:
   • Aba Visão geral: atualize o proprietário, adicione ou atualize tags, adicione ou atualize comentários. Consulte Gerir a propriedade de objetos do Unity Catalog, Aplicar tags a objetos protegíveis no Unity Cataloge Adicionar comentários aos 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 kebab: Renomeie o catálogo.
   • Criar esquema botão: 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 bloco de anotações ou no editor de consultas SQL. Ver ALTER CATALOG.
• Para conceder ou revogar privilégios, use o comando GRANT 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 associados ao catálogo.

Explorador de Catálogos

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

1. Faça login em um espaço de trabalho vinculado ao metastore.
2. Clique no Catálogo.
3. No painel Catálogo, à esquerda, clique no catálogo que deseja excluir.
4. No painel de detalhes, clique no ícone do à esquerda do botão Criar banco de dados e selecione Eliminar.
5. Na caixa de diálogo Eliminar catálogo, clique em Eliminar.

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 marcador de posição <catalog-name>.

Para obter descrições de 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 poder excluir o catálogo. Isso inclui o esquema de 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