Gerenciar catálogos

Este artigo mostra como view, atualizar e excluir catálogos em Unity Catalog. Um catálogo contém esquemas (bancos de dados), e um esquema contém tabelas, visualizações, volumes, modelos e funções.

Para obter mais informações sobre catálogos, consulte O que são catálogos no Databricks? e Criar catálogos. Para aprender como conceder e revogar o acesso a um catálogo, consulte a referência de privilégiosUnity Catalog.

Para saber como gerenciar um catálogo externo , um objeto Unity Catalog que espelha um banco de dados em um sistema de dados externo, consulte gerenciar e trabalhar com catálogos externos.

Requisitos

Para view, atualizar ou excluir um catálogo:

• É necessário ter um metastore Unity Catalog vinculado ao workspace onde o senhor realiza a tarefa.

• O clustering que o senhor usa para executar um Notebook para gerenciar um catálogo deve usar um modo de acesso compatível com o Unity Catalog. Consulte Modos de acesso.

  SQL O armazém sempre oferece suporte ao site 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 os metadados de todos os catálogos que possuem ou nos quais receberam a permissão USE CATALOG ou BROWSE.

nota

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

Para view informações sobre um catálogo, o senhor pode usar o Catalog Explorer ou o comando SQL.

Catalog Explorer

1. Efetue login em um workspace vinculado ao metastore.

2. Clique em 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 visualizados na guia Schemas , Details , Permissions e workspace .

SQL

execução 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 seguinte comando SQL para obter detalhes sobre um catálogo. Os itens entre colchetes são opcionais. Substitua o espaço reservado <catalog-name>.

SQL

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, o senhor 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, é preciso ser o proprietário 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 no metastore pai.
• Para adicionar ou atualizar um comentário, você deve ser o proprietário ou ter MANAGE no catálogo.
• Para adicionar ou atualizar tags, é preciso ser o proprietário ou ter USE CATALOG e APPLY TAG 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 no catálogo.

MANAGE em um catálogo não requer nenhum privilégio de uso. Consulte Requisitos de privilégio de uso para MANAGE.

Catalog Explorer

1. Faça login em um workspace que esteja vinculado ao metastore Unity Catalog.
2. Clique em 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:
   • tab Visão geral : atualize o proprietário, adicione ou atualize tags, adicione ou atualize comentários. Consulte Gerenciar propriedade de objetos, Aplicar tags a objetos protegíveis Unity Catalog e Adicionar comentários a dados e AI ativa.
   • Permissões tab: conceder e revogar privilégios no catálogo. Consulte gerenciar privilégios em Unity Catalog.
   • O menu de kebab: renomeie 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 tags e gerenciar a otimização preditiva nas tabelas de 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 Databricks?
• Para renomear um catálogo usando SQL, o senhor deve criar um novo catálogo e mover todos os ativos para o novo catálogo.

Excluir um catálogo

Para excluir (ou soltar) um catálogo, o senhor pode usar o Catalog Explorer ou um comando SQL.

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

Após a exclusão de um catálogo, os arquivos de dados para tabelas e volumes gerenciados são retidos 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 permanentemente excluídos (limpos) em até 48 horas. 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 ciclo de vida do armazenamento de objetos no Unity Catalog.

atenção

Não exclua o catálogo main, mesmo que ele pareça não estar sendo usado. A exclusão pode interromper as operações de dados existentes que dependem dele.

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

Catalog Explorer

Você deve excluir todos os esquemas no catálogo, exceto information_schema, antes de excluir um catálogo. Isso inclui o esquema default criado automaticamente.

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

Para obter as descrições dos 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 excluir o catálogo. Isso inclui o esquema default criado automaticamente.

SQL

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

Por exemplo, para excluir um catálogo chamado vaccine e seus esquemas:

SQL

DROP CATALOG vaccine CASCADE