Gerenciar o catálogo default

Este artigo apresenta o catálogo default Unity Catalog , explica como decidir qual catálogo usar como default e mostra como alterá-lo.

O que é o catálogo default em Unity Catalog?

Um catálogo default é configurado para cada workspace que está habilitado para Unity Catalog. O catálogo default permite que o senhor realize operações de dados sem especificar um catálogo. Se o senhor omitir o nome do catálogo de nível superior ao realizar operações de dados, o catálogo default será assumido.

Um administrador do workspace pode view ou alternar o catálogo default usando a interface de usuário Admin Settings. O senhor também pode definir o catálogo default para um clustering usando uma configuração Spark.

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 spark.databricks.sql.initial.catalog.namespace está definida no clustering?
3. Existe um catálogo workspace default definido para o clustering?

important

A configuração pipeline para DLT define um catálogo default que substitui o workspace default.

A configuração do catálogo default quando Unity Catalog está ativado

O catálogo default que foi inicialmente configurado para seu workspace depende de como seu workspace foi habilitado para Unity Catalog:

• Em alguns espaços de trabalho que foram ativados para Unity Catalog automaticamente, o catálogoworkspace foi definido como o catálogo default. Consulte Ativação automática do Unity Catalog.
• Para todos os outros espaços de trabalho, o catálogo hive_metastore foi definido como o catálogo default.

Quando estiver migrando do Hive metastore para o Unity Catalog, o senhor pode definir o catálogo default como hive_metastore para evitar afetar o código existente que faz referência ao Hive metastore.

Alterar o catálogo default

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

atenção

Alterar o catálogo padrão pode causar problemas nas operações de dados existentes que dependem dele.

Para configurar um catálogo default diferente para um workspace:

1. Faça login no site workspace como administrador do workspace.
2. Clique no seu nome de usuário na barra superior do workspace e selecione Configurações de administrador no menu suspenso.
3. Clique na guia Avançado .
4. No catálogo padrão da linha workspace, digite o nome do catálogo e clique em Save (Salvar) .

Reinicie o armazém SQL e o clustering para que a alteração tenha efeito. Todos os armazéns e clusters SQL novos e reiniciados usarão esse catálogo como workspace default.

O senhor também pode substituir o catálogo default de um clustering específico definindo a seguinte configuração Spark no clustering. Essa abordagem não está disponível para o armazém SQL:

spark.databricks.sql.initial.catalog.namespace

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

Veja o catálogo atual do site default

Para obter o catálogo default atual do seu workspace, o senhor pode usar uma instrução SQL em uma consulta do Notebook ou do SQL Editor. Um administrador do workspace pode obter o catálogo do default usando a interface do usuário de configurações do administrador.

Admin Settings

1. Faça login no site workspace como administrador do workspace.
2. Clique no seu nome de usuário na barra superior do workspace e selecione Configurações de administrador no menu suspenso.
3. Clique na guia Avançado .
4. No catálogo padrão da linha workspace, view o nome do catálogo.

SQL

Execute o seguinte comando em uma consulta do Notebook ou do SQL Editor que esteja sendo executada em um clustering compatível com o SQL warehouse ou o Unity Catalog. O catálogo workspace default é 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 esteja definida para o clustering.

SQL

SELECT current_catalog();