Aller au contenu principal
Dernière mise à jour le

Dépannage de UNITY_CATALOG_INITIALIZATION_FAILED

Cette page décrit comment diagnostiquer et résoudre l'erreur UNITY_CATALOG_INITIALIZATION_FAILED dans les pipelines Databricks.

Présentation​

UNITY_CATALOG_INITIALIZATION_FAILED Il s’agit d’une erreur générique qui apparaît lorsque Unity Catalog ne peut pas initialiser le stockage pour un pipeline ou une charge de travail pendant le Startup du cluster. Malgré son nom, la défaillance n’est généralement pas causée par une mauvaise configuration de Unity Catalog. Au lieu de cela, cela indique presque toujours un problème d'infrastructure sous-jacent : un problème de réseau empêchant le cluster d'atteindre le control plane de Databricks, ou un problème d'autorisations empêchant l'accès au stockage cloud servant de support au métastore Unity Catalog.

Cette erreur survient dans plusieurs produits Databricks, y compris les pipelines Lakeflow Connect, les LakeFlow Pipelines et la Recherche IA.

Message d’erreur général​

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.

Le message d'erreur vous invite à vérifier votre configuration Unity Catalog, mais la cause principale est souvent un problème de réseautage ou d'autorisations cloud, comme décrit dans les sections suivantes.

Causes principales et résolutions​

Les ressources Unity Catalog ne sont pas configurées correctement​

Cause : le catalogue, le schéma ou la connexion référencé(e) par le pipeline n'existe pas ou n'est pas accessible depuis le workspace. C'est le cas décrit par le message d'erreur lui-même et il est moins courant que les problèmes d'infrastructure mentionnés ci-dessus.

Résolution :

  1. Vérifiez que le catalogue et le schéma référencés dans le pipeline existent et sont accessibles depuis le Workspace. Dans Databricks, accédez à Catalogue et confirmez que le catalogue est visible et que vous disposez d'au moins les privilèges USE CATALOG et USE SCHEMA.
  2. Si vous utilisez Lakeflow Connect, vérifiez que la connexion utilisée par le pipeline est valide. Accédez à Catalogue > Données externes > Connexions et vérifiez que la connexion est répertoriée et accessible.
  3. Vérifiez que le cluster ou le pipeline dispose des privilèges Unity Catalog nécessaires. Consultez Gérer les privilèges dans Unity Catalog.
Sur cette page