Gerenciar o catálogo padrão

Este artigo apresenta o catálogo padrão do Catálogo do Unity, explica como decidir qual catálogo usar como padrão e mostra como alterá-lo.

Qual é o catálogo padrão no Catálogo do Unity?

Um catálogo padrão é configurado para cada workspace habilitado para o Catálogo do Unity. O catálogo padrão permite que você execute operações de dados sem especificar um catálogo. Se você omitir o nome do catálogo de nível superior ao executar operações de dados, o catálogo padrão será assumido.

Um administrador de espaço de trabalho pode exibir ou alternar o catálogo padrão usando a interface do usuário de Configurações de Administrador. Você também pode definir o catálogo padrão para um cluster usando uma configuração do Spark.

A configuração de catálogo padrão do workspace se aplica somente ao usar a computação que atenda aos requisitos de computação do Catálogo do Unity. Especificamente, isso significa que você está usando um SQL Warehouse ou um cluster configurado com o modo de acesso padrão ou dedicado. Recursos de computação que não são compatíveis com o Catálogo do Unity são usados hive_metastore como o catálogo padrão.

Os comandos que não especificam o catálogo (por exemplo GRANT CREATE TABLE ON SCHEMA myschema TO mygroup) são avaliados para o catálogo na seguinte ordem:

1. O catálogo está definido para a sessão usando uma instrução USE CATALOG ou uma configuração JDBC?
2. A configuração spark.databricks.sql.initial.catalog.namespace do Spark está definida no cluster?
3. Há um catálogo padrão de workspace definido para o cluster?

A configuração de catálogo padrão quando o Catálogo do Unity está habilitado

O catálogo padrão que foi inicialmente configurado para seu workspace depende de como seu workspace foi habilitado para o Catálogo do Unity:

• Para alguns espaços de trabalho que foram habilitados automaticamente para o Catálogo do Unity, o catálogo do espaço de trabalho foi definido como o catálogo padrão. Confira Habilitação automática do Catálogo do Unity.
• Para todos os outros espaços de trabalho, o catálogo hive_metastore foi definido como o catálogo padrão.

Ao migrar do metastore do Hive para o Catálogo do Unity, você pode definir o catálogo padrão como hive_metastore para evitar afetar o código que faz referência ao metastore do Hive.

Alterar o catálogo padrão

Um administrador de workspace pode alterar o catálogo padrão do workspace. Qualquer pessoa com permissão para criar ou editar um recurso de cálculo pode definir um catálogo padrão diferente para o recurso de cálculo.

Para configurar um catálogo padrão diferente para um workspace:

1. Acesse seu espaço de trabalho como administrador do espaço de trabalho.
2. Clique no seu nome de usuário na barra superior do espaço de trabalho e selecione Configurações do Administrador na lista suspensa.
3. Clique na guia Avançado.
4. No Catálogo padrão do workspace, insira o nome do catálogo e clique em Salvar.

Reinicie seus clusters e warehouses SQL para que a alteração entre em vigor. Todos os clusters e os warehouses SQL novos e reiniciados usarão esse catálogo como o padrão do workspace.

Você também pode substituir o catálogo padrão de um cluster específico definindo a seguinte configuração do Spark no cluster. Essa abordagem não está disponível para armazéns SQL:

spark.databricks.sql.initial.catalog.namespace

Para obter instruções, consulte Configuração do Spark.

Exibir o catálogo padrão atual

Para obter o catálogo padrão atual para seu workspace, você pode usar uma instrução SQL em um notebook ou consulta do Editor do SQL. Um administrador do ambiente de trabalho pode obter o catálogo padrão usando a interface de configurações do administrador.

Configurações de administração

1. Faça login no espaço de trabalho como administrador.
2. Clique no seu nome de usuário na barra superior da área de trabalho e selecione Configurações do Administrador na lista suspensa.
3. Clique na guia Avançado.
4. Na linha Catálogo padrão do workspace, exiba o nome do catálogo.

SQL

Execute o comando a seguir em uma consulta no Notebook ou no Editor de SQL em execução em um warehouse SQL ou em um cluster em conformidade com o Unity Catalog. O catálogo padrão do workspace é retornado desde que nenhuma instrução USE CATALOG ou configuração JDBC tenha sido definida na sessão e desde que nenhuma configuração spark.databricks.sql.initial.catalog.namespace seja definida para o cluster.

SELECT current_catalog();

Excluir o catálogo do workspace

Para workspaces com o Catálogo do Unity habilitado por padrão, o catálogo de workspaces é mantido mesmo após você excluir o workspace. Isso preserva seus dados. Se você quiser remover completamente o catálogo de workspaces e todos os dados associados, poderá usar métodos de exclusão forçada ao excluir o workspace. Para obter detalhes, consulte Force delete the workspace catalog.