次の方法で共有

Databricks Git フォルダーのエラーとトラブルシューティング

Databricks Git フォルダーの一般的なエラー メッセージへの対応や、問題のトラブルシューティングは、次のガイダンスに従って行ってください。

Invalid credentials

次の操作を試してみてください。

  • Git 統合設定 ([設定]>[リンクされたアカウント]) が正しいことを確認します。

    • Git プロバイダーのユーザー名とトークンの両方を入力する必要があります。

  • [設定]>[リンクされたアカウント] で、正しい Git プロバイダーを選択していることを確認します。

  • 個人用アクセス トークンまたはアプリのパスワードに、リポジトリへの適切なアクセス権があることを確認します。

  • Git プロバイダーで SSO が有効になっている場合は、SSO 用のトークンを承認します。

  • Git コマンド ラインを使用してトークンをテストします。 山かっこで囲まれたテキスト文字列を置き換えます。

    git clone https://<username>:<personal-access-token>@github.com/<org>/<repo-name>.git

Secure connection...SSL problems

このエラーは、Azure Databricks から Git サーバーにアクセスできない場合に発生します。 プライベート Git サーバーにアクセスするには、Azure Databricks アカウント チームにお問い合わせください

<link>: Secure connection to <link> could not be established because of SSL problems

Microsoft Entra ID 資格情報エラー

Encountered an error with your <ms-entra-id> credentials. Please try logging out of <ms-entra-id> and logging back in.

このエラーは、最近チームが Microsoft Entra ID の多要素認証 (MFA) ポリシーを使用するように移行した場合に、発生する可能性があります。 この問題を解決するには、portal.azure.com に移動してログアウトすることで、Microsoft Entra ID からログアウトする必要があります。再度ログインすると、MFA を使用してログインするように求めるメッセージが表示されます。

それでも問題が解決しない場合は、すべての Azure サービスから完全にログアウトした後、もう一度ログインしてみてください。

タイムアウト エラー

大きなリポジトリのクローンや大きなブランチのチェックアウトなどの負荷の高い操作では、タイムアウト エラーが発生することがありますが、操作はバックグラウンドで完了する可能性があります。 その時点でワークスペースに大きな負荷がかかっていた場合は、後でもう一度試すこともできます。

大規模なリポジトリを操作するには、スパース チェックアウトを試してください。

404 エラー

ノートブック以外のファイルを開こうとして 404 エラーが発生する場合は、数分待ってからもう一度やり直してください。 ワークスペースが有効になってから、webapp が構成フラグを取得するまでに、数分間の遅延が発生します。

デタッチされた HEAD 状態

Databricks Git フォルダーは、次の場合にデタッチされた HEAD 状態になる可能性があります。

  • リモート ブランチが削除された。 Databricks は、ブランチ上のコミットされていないローカル変更を既定のブランチに適用して、復旧を試みます。 既定のブランチに競合する変更がある場合、Databricks は既定のブランチのスナップショット (デタッチされた HEAD) に変更を適用します。
  • ユーザーまたはサービス プリンシパルが、update repo API を使用してタグ上のリモート リポジトリをチェックアウトした。

この状態から復旧するには、次の手順を行います。

  1. [create branch] ボタンをクリックして、現在のコミットに基づいて新しいブランチを作成するか、[ブランチの選択] ドロップダウンを使用して既存のブランチをチェックアウトします。
  2. 変更を保持する場合は、コミットしてプッシュします。 変更を破棄するには、[変更] の下にある kebab をクリックします。

ノートブック名の競合を解決する

同じまたは類似するファイル名を持つ別のノートブックがあると、リポジトリまたは pull request を作成するときにエラー (Cannot perform Git operation due to conflicting names、A folder cannot contain a notebook with the same name as a notebook, file, or folder (excluding file extensions). など) が発生します

ファイル拡張子が異なる場合でも、名前の競合が発生する可能性があります。 たとえば、次の 2 つのファイルは競合します。

  • notebook.ipynb
  • notebook.py

図: ノートブック、ファイル、またはフォルダーの名前の競合。

名前の競合を解決するには

  • エラー状態の原因となっているノートブック、ファイル、またはフォルダーの名前を変更します。
    • リポジトリを複製するときにこのエラーが発生した場合は、リモート Git リポジトリ内のノートブック、ファイル、またはフォルダーの名前を変更する必要があります。

エラーがクローンし直しを提案する

There was a problem with deleting folders. The repo could be in an inconsistent state and re-cloning is recommended.

このエラーは、リポジトリからフォルダーを削除しているときに問題が発生したことを示します。 これによりリポジトリが不整合な状態になる可能性があり、削除されていなければならないフォルダーがまだ存在しています。 このエラーが発生した場合は、リポジトリを削除してクローンし直し、状態をリセットすることをお勧めします。

No experiment...found または MLflow UI エラー

No experiment for node foundより前に最後にログに記録された MLflow ノートブックの実験で作業しているときに、Azure Databricks のエラー メッセージ または MLflow のエラーが表示されることがあります。 このエラーを解決するには、その実験に関連付けられているノートブックで新しい実行をログに記録します。

注意

これはノートブックの実験にのみ適用されます。 Git フォルダーで新しい実験を作成することはサポートされていません。

目に見えるユーザー編集が何もないのに、ノートブックが変更済みとして表示される

ユーザーが何も編集していないのに、ノートブックのすべての行が変更されたように表示される場合、行の末尾の文字が変更されている可能性があります。 Databricks では Linux スタイルの LF 行末文字が使われており、これは Windows システムからコミットされたファイルの行末と異なる場合があります。

ノートブックが変更済みとして表示されていても、明確なユーザー編集が表示されない場合、"変更" は通常非表示の "行末" 文字に変更される可能性があります。 行末文字は、オペレーティング システムやファイル形式によって異なる場合があります。

この問題を診断するには、.gitattributes ファイルがあるかどうかを調べます。 ある場合:

  • * text eol=crlf が含まれていてはなりません。
  • 環境として Windows を使っていない場合は、設定を削除します。 ネイティブ開発環境と Databricks の両方で、Linux の行末文字を使います。
  • Windows を使っている場合は、設定を * text=auto に変更します。 Git は Linux スタイルの行末を使ってすべてのファイルを内部的に格納するようになりますが、チェックアウトするとプラットフォーム固有 (Windows など) の行末文字に自動的になります。

Windows の行末文字を含むファイルを Git に既にコミットしている場合は、次の手順を実行します。

  1. 未処理の変更をすべてクリアします。
  2. 上で推奨したように .gitattributes ファイルを更新します。 変更をコミットします。
  3. git add --renormalize を実行します。 すべての変更をコミットしてプッシュします。