Pular para o conteúdo principal
Última atualização em

Solução de problemas UNITY_CATALOG_INITIALIZATION_FAILED

Esta página descreve como diagnosticar e resolver o erro UNITY_CATALOG_INITIALIZATION_FAILED no pipeline Databricks .

Visão geral​

UNITY_CATALOG_INITIALIZATION_FAILED É um erro genérico que aparece quando Unity Catalog não consegue inicializar o armazenamento para um pipeline ou carga de trabalho durante startup cluster . Apesar do nome, a falha geralmente não é causada por uma configuração incorreta Unity Catalog . Em vez disso, quase sempre indica um problema subjacente de infraestrutura: um problema de rede que impede o cluster de alcançar o plano de controle Databricks ou um problema de permissões que impede o acesso ao armazenamento cloud que suporta o metastore do Unity Catalog .

Este erro ocorre em vários produtos Databricks, incluindo os pipelines do LakeFlow Connect, os Pipelines Declarativos do LakeFlow Spark e o AI Search.

Mensagem de erro geral​

Encountered an error with Unity Catalog while setting up the pipeline on cluster [CLUSTER_ID].
Ensure that your Unity Catalog configuration is correct, and that required resources
(e.g., catalog, schema) exist and are accessible. Also verify that the cluster has
appropriate permissions to access Unity Catalog.

A mensagem de erro instrui você a verificar a configuração do seu Unity Catalog , mas a causa raiz geralmente é um problema de permissões de rede ou cloud , conforme descrito nas seções a seguir.

Causas raiz e soluções​

O recursoUnity Catalog não está configurado corretamente.​

Causa : O catálogo, esquema ou conexão referenciado pelo pipeline não existe ou não está acessível a partir do workspace. Este é o caso descrito pela própria mensagem de erro e é menos comum do que os problemas de infraestrutura mencionados acima.

Resolução :

  1. Verifique se o catálogo e o esquema referenciados no pipeline existem e estão acessíveis a partir do workspace. No Databricks, vá para Catálogo e confirme que o catálogo está visível e que você tem pelo menos privilégios USE CATALOG e USE SCHEMA .
  2. Se você estiver usando LakeFlow Connect, verifique se a conexão usada pelo pipeline é válida. Acesse Catálogo > Dados Externos > Conexões e confirme se a conexão está listada e acessível.
  3. Verifique se o cluster ou pipeline possui os privilégios necessários Unity Catalog . Consulte a seção sobre privilégios de gerenciamento no Unity Catalog.
Nesta página