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 workspace 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.

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 existente 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. Faça logon no workspace como administrador do workspace.
2. Clique no nome de usuário na barra superior do workspace e selecione Configurações do Administrador na lista suspensa.
3. Clique na guia Avançado.
4. No Catálogo padrão da linha 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.name

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 de workspace pode obter o catálogo padrão usando a interface do usuário de Configurações de Administrador.

Configurações de administração

1. Faça logon no workspace como administrador do workspace.
2. Clique no nome de usuário na barra superior do workspace 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 do Notebook ou do Editor do SQL em execução em um warehouse SQL ou cluster em conformidade com o Catálogo do Unity. 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();