Partilhar via

Gerenciar catálogos

  • Artigo

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 ícone CatálogoCatá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 espaço reservado <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 ícone CatálogoCatá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:

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 ícone CatálogoCatálogo.
  3. No painel Catálogo, à esquerda, clique no catálogo que deseja excluir.
  4. No painel de detalhes, clique no menu kebab menu Kebab à 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 espaço reservado <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