メインコンテンツまでスキップ

管理された取り込みパイプラインのトラブルシューティング

このページでは、Databricks Lakeflow Connectにおけるマネージドインジェストパイプラインの一般的な問題と、その解決方法について説明します。コネクタ固有のトラブルシューティングについては、お使いのコネクタのドキュメントを参照してください。

一般的なパイプラインのトラブルシューティング

パイプラインのランが失敗した場合は、失敗したステップをクリックし、エラーメッセージがエラーの性質について十分な情報を提供しているかどうかを確認します。

UIでパイプラインイベントLogsを表示

右側のパネルで **[Update details]** をクリックし、次に **[Logs]** をクリックして、パイプライン詳細ページからクラスターログを確認およびdownloadすることもできます。Logsをスキャンしてエラーまたは例外を探します。

UIでパイプライン更新の詳細を表示します。

Declarative Automation Bundlesを使用した列の選択

**問題**:宣言型オートメーションバンドルを使用してマネージドインジェスションパイプラインを作成する際に、列選択機能を使用できません。

**解決策**:Databricks CLIバージョンをご確認ください。バージョンがv0.251.0未満の場合、CLIを再インストール

UI でパイプラインを編集することはできません

宣言型オートメーションバンドルまたはDatabricks CLIを使用して作成または更新されたパイプラインには、取り込みウィザードでサポートされていない構成フィールドが含まれる場合があります。ウィザードでこれらのフィールドのいずれかを使用してパイプラインを編集しようとすると、視覚モードがパイプラインで利用できないことを示す警告が表示されます。UIでこれらのパイプラインを編集するには、代わりにコードエディターモードを使用してください。

モードを切り替えるには、パイプラインエディター上部のボタン( ウィザード 、 YAML 、 JSON )を使用します。

注記

パイプラインがDeclarative Automation Bundlesバンドルによって管理されている場合は、バンドル内のパイプライン定義ファイルを直接編集してください。UIで行われた編集は、次回 bundle deploy をランする際に上書きされます。

CANNOT_WRITE_TO_INACTIVE_TABLES

CANNOT_WRITE_TO_INACTIVE_TABLES: Table 'XYZ' is marked as inactive and cannot be written to.

このエラーは、非アクティブとマークされている宛先テーブルにパイプラインが書き込もうとすると発生します。対応するソーステーブルが削除されると、テーブルは非アクティブになります。非アクティブなテーブルの仕組みに関する詳細なコンテキストについては、マネージド コネクタに関する FAQ を参照してください。

これを解決するには:

  • ソーステーブルからの取り込みを再開する場合(たとえば、再作成された場合)は、影響を受けるテーブルの完全更新を実行します。
  • ソーステーブルが意図的に削除された場合は、非アクティブな宛先テーブルを削除し、パイプラインから削除します。