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:
- O catálogo está definido para a sessão usando uma instrução
USE CATALOG
ou uma configuração JDBC? - A configuração Spark
spark.databricks.sql.initial.catalog.namespace
está definida no clustering? - Existe um catálogo workspace default definido para o clustering?
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.
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:
- Faça login no site workspace como administrador do workspace.
- Clique no seu nome de usuário na barra superior do workspace e selecione Configurações de administrador no menu suspenso.
- Clique na guia Avançado .
- 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
- SQL
- Log in to your workspace as a workspace admin.
- Click your username in the top bar of the workspace and select Admin Settings from the dropdown.
- Click the Advanced tab.
- On the Default catalog for the workspace row, view the catalog name.
Run the following command in a notebook or SQL Editor query that is running on a SQL warehouse or Unity Catalog-compliant cluster. The workspace default catalog is returned as long as no USE CATALOG
statement or JDBC setting has been set on the session, and as long as no spark.databricks.sql.initial.catalog.namespace
config is set for the cluster.
SELECT current_catalog();