UNITY_CATALOG_INITIALIZATION_FAILED のトラブルシューティング
このページでは、 DatabricksパイプラインのUNITY_CATALOG_INITIALIZATION_FAILEDエラーを診断して解決する方法について説明します。
概要
UNITY_CATALOG_INITIALIZATION_FAILED これは、クラスターの起動中にUnity Catalogパイプラインまたはワークロードのストレージを初期化できないときに表示されるキャッチオール エラーです。 その名称とは裏腹に、このエラーは通常、 Unity Catalog設定ミスが原因ではありません。 むしろ、これはほとんどの場合、根本的なインフラストラクチャの問題を示しています。つまり、 がDatabricksコントロール プレーンに到達できないネットワークの問題、またはUnity Catalogメタストアを支えるクラウド ストレージへのアクセスを妨げる権限の問題です。
このエラーは、LakeFlow Connectパイプライン、LakeFlow Spark宣言型パイプライン、およびAI検索を含む、複数のDatabricks製品で発生します。
一般的なエラーメッセージ
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.
エラーメッセージではUnity Catalog設定を確認するように指示されていますが、根本的な原因は多くの場合、以下のセクションで説明するように、ネットワークまたはクラウドの権限の問題です。
根本原因と解決策
Unity Catalogリソースが正しく構成されていません
原因 ：パイプラインが参照するカタログ、スキーマ、または接続が存在しないか、ワークスペースからアクセスできません。これはエラーメッセージ自体が説明しているケースであり、上記のインフラストラクチャの問題よりも発生頻度は低い。
解決 ：
- パイプラインで参照されているカタログとスキーマが存在し、ワークスペースからアクセスできることを確認してください。Databricksで カタログ に移動し、カタログが表示されていること、および少なくとも
USE CATALOGとUSE SCHEMA権限を持っていることを確認してください。 - LakeFlow Connectを使用している場合は、パイプラインで使用されている接続が有効であることを確認してください。 カタログ > 外部データ > 接続 に移動し、接続が一覧に表示され、アクセス可能であることを確認してください。
- クラスターまたはパイプラインに必要なUnity Catalog権限があることを確認します。 Unity Catalogの「権限の管理」を参照してください。