Gerenciar catálogos

  • Artigo

Este artigo mostra como exibir, atualizar e gerenciar 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 Privilégios do Catálogo do Unity e objetos protegíveis.

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, confira Gerenciar e trabalhar com um catálogo estrangeiro.

Requisitos

Para exibir, atualizar ou excluir um catálogo:

  • Você deve ter um metastore do Catálogo do Unity vinculado ao workspace em que executa a tarefa.

  • O cluster usado para executar um notebook para gerenciar um catálogo deve usar um modo de acesso em conformidade 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.

Ver detalhes do catálogo

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

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

Explorador do Catálogo

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

  2. Clique em Ícone do catálogo 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 os detalhes completos.

Para obter mais informações, confira DESCRIBE CATALOG.

Atualizar um catálogo

Para atualizar (ou alterar) um catálogo, você pode usar o Explorador 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.
  • Para renomear o catálogo, você deve ser o proprietário.
  • Para adicionar ou atualizar um comentário ou marcas, 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 do metastore.

Explorador do Catálogo

  1. Faça logon em um workspace vinculado ao metastore do Catálogo do Unity.
  2. Clique em Ícone do catálogo Catálogo.
  3. À esquerda do painel Catálogo, clique no catálogo que deseja atualizar.
  4. Use os seguintes elementos de página na página de detalhes do catálogo para atualizar o catálogo:

SQL

  • Para alterar o proprietário, adicionar ou atualizar marcas e gerenciar a otimização preditiva nas tabelas em um catálogo, execute o comando ALTER CATALOG 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 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 remover) um catálogo, você pode usar o Explorador de Catálogos ou um comando de SQL.

Permissões necessárias: proprietário do catálogo.

Explorador do Catálogo

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

  1. Faça logon em um workspace vinculado ao metastore.
  2. Clique em Ícone do catálogo Catálogo.
  3. À esquerda do painel Catálogo, clique no catálogo que deseja excluir.
  4. No painel de detalhes, clique no menu de três pontos 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 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âmetros, confira DROP CATALOG.

Se você usar DROP CATALOG sem a opção CASCADE, deverá excluir todos os esquemas do catálogo, exceto information_schema, para poder excluir o catálogo. Isso inclui o esquema 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