Gerenciar catálogos

Este artigo mostra como exibir, atualizar e excluir catálogos no Catálogo do Unity. 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 a referência de privilégios do Catálogo do Unity.

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

Requisitos

Para exibir, atualizar ou excluir um catálogo:

• Você deve ter um metastore do Catálogo do Unity vinculado ao workspace no qual você executa a tarefa.

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

  Os warehouses SQL sempre dão suporte para o Catálogo do Unity.

As permissões necessárias diferem por tarefa e são fornecidas em cada seção a seguir.

Exibir detalhes do catálogo

Permissão necessária: os usuários podem ver metadados para todos os catálogos que possuem ou nos quais receberam a USE CATALOG ou a BROWSE permissão.

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

Gerenciador de Catálogos

1. Faça logon em um workspace vinculado ao metastore.

2. Clique no 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 vistos nas guias Esquemas, Detalhes, Permissões e Workspaces.

SQL

Execute 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 comando SQL a seguir para obter detalhes sobre um catálogo. Os itens entre colchetes 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 DESCRIBE CATALOG.

Atualizar um catálogo

Para atualizar (ou alterar) um catálogo, você 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 mudar de proprietário, você deve ser o dono ou ter MANAGE no catálogo.
• Para renomear o catálogo, você deve ser o proprietário ou ter MANAGE no catálogo, e CREATE CATALOG na metastore principal.
• Para adicionar ou atualizar um comentário, você deve ser o proprietário ou ter MANAGE no catálogo.
• Para adicionar ou atualizar tags, você 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, você deve ser o proprietário do catálogo, administrador da metastore ou ter MANAGE acesso ao catálogo.

MANAGE Em um catálogo não exige nenhum privilégio de uso. Veja Requisitos de privilégio de uso para MANAGE.

Gerenciador de Catálogos

1. Faça logon em um workspace vinculado ao metastore do Catálogo do Unity.
2. Clique no 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:
   • Guia Visão geral: atualizar o proprietário, adicionar ou atualizar marcas e adicionar ou atualizar comentários. Consulte Gerenciar propriedade do objeto, Aplicar marcas a objetos protegíveis do Catálogo do Unity e Adicionar comentários a dados e ativos de IA.
   • Guia Permissões: conceder e revogar privilégios no catálogo. Consulte Gerenciar privilégios no Catálogo do Unity.
   • O menu de kebab : Renomear 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 marcas e gerenciar a otimização preditiva nas tabelas em um catálogo, execute o ALTER CATALOG comando 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 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 remover) um catálogo, você pode usar o Catalog Explorer ou um comando SQL.

Se o catálogo ou qualquer um dos objetos filho estiverem incluídos em um compartilhamento OpenSharing, remova-os do compartilhamento antes de excluir o catálogo. Para obter mais informações, consulte As exclusões em cascata ignoram a proteção de compartilhamento.

Depois de excluir um catálogo, os arquivos de dados para tabelas e volumes gerenciados são mantidos para permitir uma janela de recuperação de 7 dias. Após o término da janela de recuperação, os arquivos de dados são excluídos permanentemente (limpos) dentro de 48 horas. Os arquivos para tabelas externas e volumes externos não são excluídos. Para obter detalhes sobre o ciclo de vida do arquivo de dados, a cobrança de armazenamento e as opções de recuperação, consulte o ciclo de vida do armazenamento de objetos no Catálogo do Unity.

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

Gerenciador 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 criado default automaticamente.

1. Faça logon em um workspace vinculado ao metastore.
2. Clique no Catálogo.
3. No painel Catálogo , à esquerda, clique no catálogo que você deseja excluir.
4. No painel de detalhes, clique no à 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 comando SQL a seguir em um notebook ou no editor de SQL do Databricks. Os itens entre colchetes são opcionais. Substitua o espaço reservado <catalog-name>.

Para obter descrições de parâmetro, 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 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