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 em Databricks? e Criar catálogos. Para saber como conceder e revogar o acesso a um catálogo, consulte Privilégios e objetos protegíveis do Unity 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.

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

Catalog Explorer

1. Log in to a workspace that is linked to the metastore.

2. Click Catalog.

3. In the Catalog pane, find the catalog and click its name.

   Some details are listed at the top of the page. Others can be viewed on the Schemas, Details, Permissions, and Workspaces tabs.

SQL

Run SHOW CATALOGS in a notebook or the SQL query editor to list all catalogs in a metastore or those that match a regular expression.

Run the following SQL command to get details about a catalog. Items in brackets are optional. Replace the placeholder <catalog-name>.

SQL

DESCRIBE CATALOG <catalog-name>;

Use CATALOG EXTENDED to get full details.

For more information, see 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, 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 da metastore ou ter MANAGE e USE CATALOG no catálogo.

Catalog Explorer

1. Log into a workspace that is linked to the Unity Catalog metastore.
2. Click Catalog.
3. In the Catalog pane on the left, click the catalog that you want to update.
4. Use the following page elements on the catalog details page to update the catalog:
   • Overview tab: update the owner, add or update tags, add or update comments. See Manage Unity Catalog object ownership, Apply tags to Unity Catalog securable objects, and Add comments to data and AI assets.
   • Permissions tab: grant and revoke privileges on the catalog. See Manage privileges in Unity Catalog.
   • The kebab menu: Rename the catalog.
   • Create schema button: add a schema to the catalog. See Create schemas.

SQL

• To change the owner, add or update tags, and manage predictive optimization on the tables in a catalog, run the ALTER CATALOG command in a notebook or the SQL query editor. See ALTER CATALOG.
• To grant or revoke privileges, use the GRANT or REVOKE command. See GRANT and REVOKE.
• To add schemas to the catalog, see What are schemas in Databricks?.
• To rename a catalog using SQL, you must create a new catalog and move all assets into the new catalog.

Excluir um catálogo

Para excluir (ou soltar) um catálogo, o senhor 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.

Catalog Explorer

You must delete all schemas in the catalog except information_schema before you can delete a catalog. This includes the auto-created default schema.

1. Log in to a workspace that is linked to the metastore.
2. Click Catalog.
3. In the Catalog pane, on the left, click the catalog you want to delete.
4. In the detail pane, click the kebab menu to the left of the Create database button and select Delete.
5. On the Delete catalog dialog, click Delete.

SQL

Run the following SQL command in a notebook or Databricks SQL editor. Items in brackets are optional. Replace the placeholder <catalog-name>.

For parameter descriptions, see DROP CATALOG.

If you use DROP CATALOG without the CASCADE option, you must delete all schemas in the catalog except information_schema before you can delete the catalog. This includes the auto-created default schema.

SQL

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

For example, to delete a catalog named vaccine and its schemas:

SQL

DROP CATALOG vaccine CASCADE