Gerenciar catalogs

Este artigo mostra como exibir, updatee excluir catalogs no Unity Catalog. Um catalog contém (bancos de dados), e um schema contém tables, views, volumes, modelos e funções.

Para obter mais informações sobre catalogs, consulte O que são catalogs no Azure Databricks? e Criar catalogs. Para saber como grant e revoke acesso a um catalog, consulte privilégios e objetos protegíveis Catalog do Unity.

Para saber como gerenciar um catalog estrangeiro, um objeto Catalog do Unity que espelha um banco de dados em um sistema de dados externo, consulte Gerenciar e trabalhar com catalogs estrangeiros.

Requisitos

Para exibir, updateou excluir um catalog:

• Você precisa ter um metastore Unity Catalog vinculado ao workspacewhere em que você executa a tarefa.

• O cluster que você usa para executar um runbook para gerenciar um catalog precisa usar um modo de acesso compatível com o Catalogdo Unity. Consulte Modos de acesso.

  Os sql warehouses sempre dão suporte ao Unity Catalog.

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

Exibir detalhes do catalog

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

Para exibir informações sobre um catalog, você pode usar Catalog Explorer ou um comando SQL.

Explorador Catalog

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

2. Clique no ícone Catalog.

3. No painel Catalog, localize o catalog 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 list todos os catalogs em um repositório de metadados ou aqueles que correspondem a uma expressão regular.

Execute o comando SQL a seguir para get detalhes sobre um catalog. Os itens entre colchetes são opcionais. Substitua o espaço reservado <catalog-name>.

DESCRIBE CATALOG <catalog-name>;

Use CATALOG EXTENDED para get detalhes completos.

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

Update um catalog

Para update (ou alterar) um catalog, você pode usar o Catalog Explorer ou um comando SQL.

Permissões necessárias: as permissões necessárias para update um catalog dependem do update:

• Para alterar o proprietário, você precisa ser o proprietário ou ter MANAGE e USE CATALOG no catalog.
• Para renomear o catalog, você deve ser o proprietário ou ter MANAGE e USE CATALOG no catalog.
• Para adicionar ou update um comentário ou tags, você precisa ser o proprietário ou ter MANAGE ou MODIFY e USE CATALOG no catalog.
• Para ter as permissões grant e revoke no catalog, você deve ser o proprietário do catalog, um administrador do metastore, ou ter MANAGE e USE CATALOG no catalog.

Catalog Explorador

1. Entre em uma área de trabalho vinculada ao metastore do Unity Catalog.
2. Clique no ícone Catalog.
3. No painel Catalog à esquerda, clique no catalog que você deseja update.
4. Use os seguintes elementos de página na página de detalhes do catalog para update o catalog:
   • Guia Visão geral: update o proprietário, adicionar ou update marcas, adicionar ou update comentários. Consulte Gerenciar propriedade de objeto Catalog do Unity, Aplicar marcas a objetos protegíveis Catalog do Unity e Adicionar comentários a dados e ativos de IA.
   • Guia Permissões: privilégios grant e revoke no catalog. Veja Gerenciar privilégios no Catalog do Unity.
   • O menu kebab : Renomear o catalog.
   • Criar schema botão: adicione um schema ao catalog. Consulte Criar esquemas.

SQL

• Para alterar o proprietário, adicionar ou update marcas e gerenciar a otimização preditiva no tables em um catalog, execute o comando ALTER CATALOG em um notebook ou no editor de consultas SQL. Consulte ALTER CATALOG.
• Para privilégios grant ou revoke, use os comandos GRANT ou REVOKE. Consulte GRANT e REVOKE.
• Para adicionar esquemas ao catalog, consulte O que são esquemas no Azure Databricks?.
• Para renomear um catalog usando o SQL, você deve criar um novo catalog e mover todos os ativos para o novo catalog.

Excluir um catalog

Para excluir (ou remover) um catalog, você pode usar Catalog Explorer ou um comando SQL.

Permissão necessária: proprietário do Catalog ou MANAGE e USE CATALOG no catalog.

Explorador de Catalog

Você deve excluir todos os esquemas no catalog, exceto information_schema, antes de poder excluir um catalog. Isso inclui o defaultschemacriado automaticamente.

1. Faça logon em um workspace vinculado ao metastore.
2. Clique no ícone Catalog.
3. No painel Catalog, à esquerda, clique no catalog que você deseja excluir.
4. No painel de detalhes, clique no menu kebab à esquerda do botão Criar banco de dados e selectExcluir.
5. Na caixa de diálogo Excluir catalog, 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 catalog, exceto information_schema antes de excluir o catalog. Isso inclui o defaultschemacriado automaticamente.

DROP CATALOG [ IF EXISTS ] <catalog-name> [ RESTRICT | CASCADE ]

Por exemplo, para excluir um catalog chamado vaccine e os respectivos esquemas:

DROP CATALOG vaccine CASCADE