Compartilhar via

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 Crie 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, 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 Unity vinculado ao workspace onde 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.

Observação

Os usuários com o BROWSE privilégio em um catálogo estrangeiro podem ver metadados obsoletos no Catalog Explorer ou ao acessar metadados por meio da API do Catálogo do Unity. A visibilidade dos metadados depende de quando REFRESH foi executada pela última vez para o catálogo estrangeiro.

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 ícone Dados.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 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 etiquetas, 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 do metastore ou ter MANAGE e USE CATALOG no catálogo.

Gerenciador de Catálogos

  1. Faça logon em um workspace vinculado ao metastore do Catálogo do Unity.
  2. Clique no ícone Dados.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:

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 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 Catalog Explorer ou um comando SQL.

Permissão necessária: proprietário do catálogo ou MANAGE e USE CATALOG 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 ícone Dados.Catálogo.
  3. No painel Catálogo , à esquerda, clique no catálogo que você deseja excluir.
  4. No painel de detalhes, clique no ícone de 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â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