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 mais informações sobre catálogos, consulte O que são catálogos em Azure Databricks? e Create catálogos. Para saber como conceder e revogar o acesso a um catálogo, consulte a referência de privilégios do Catálogo Unity.

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 mudar de proprietário, deve ser o proprietário ou ter MANAGE no catálogo.
• Para renomear o catálogo, deve ser o proprietário ou ter MANAGE no catálogo, e CREATE CATALOG na metastore principal.
• Para adicionar ou atualizar um comentário, deve ser o proprietário ou ter MANAGE no catálogo.
• Para adicionar ou atualizar etiquetas, deve ser o proprietário ou ter USE CATALOG e APPLY TAG estar no catálogo.
• Para conceder e revogar permissões no catálogo, deve ser o proprietário do catálogo, administrador da metastore ou ter MANAGE acesso ao catálogo.

MANAGE Num catálogo não requer quaisquer privilégios de uso. Veja Requisitos de privilégios de utilização para MANAGE.

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 dos objetos, Aplicar etiquetas a objetos seguros do Unity Catalog 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 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, veja O que são esquemas em 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.

Se o catálogo ou qualquer dos respetivos objetos subordinados estiverem incluídos numa partilha do OpenSharing, remova-os da partilha antes de eliminar o catálogo. Para mais informações, consulte Cascade deletes bypass share protection.

Depois de eliminar um catálogo, os ficheiros de dados para tabelas e volumes geridos são mantidos para permitir uma janela de recuperação de 7 dias. Após o fim da janela de recuperação, os ficheiros de dados são permanentemente eliminados (eliminados) no prazo de 48 horas. Ficheiros para tabelas externas e volumes externos não são eliminados. Para detalhes sobre o ciclo de vida dos ficheiros de dados, faturação de armazenamento e opções de recuperação, consulte Ciclo de vida de armazenamento de objetos no Unity Catalog.

Permissão necessária: Proprietário do catálogo ou MANAGE no 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