メインコンテンツまでスキップ
に最終更新

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

このページでは、Databricks Git フォルダーに関する一般的なエラー メッセージと問題のトラブルシューティングに関するガイダンスを提供します。

Invalid credentials​

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

  • Git 統合設定 ( 設定 > リンクされたアカウント ) が正しいことを確認します。Git プロバイダーのユーザー名とトークンの両方を入力する必要があります。

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

  • 個人のアクセス内部またはアプリのパスワードに正しいリポジトリ アクセス権があることを確認してください。

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

  • Git コマンドラインでトークンをテストします。 山括弧内のテキスト文字列を置き換えます。

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

Secure connection...SSL problems​

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

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

タイムアウトエラー​

大規模なリポジトリのクローン作成や大規模なブランチのチェックアウトなどの操作では、タイムアウト エラーが発生する可能性があります。ただし、操作はバックグラウンドで完了する可能性があります。ワークスペースの負荷が大きい場合は、後で再試行してください。

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

404 エラー​

ノートブック以外のファイルを開いたときに 404 エラーが発生する場合は、数分待ってからもう一度お試しください。システムがワークスペースを有効にしてから、Web アプリが構成を取得するまでの間には、短い遅延が発生します。

頭を切り離した状態​

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

  • 誰かがリモート ブランチを削除します。Databricks は、コミットされていないローカルの変更をデフォルト ブランチに適用して回復しようとします。競合する変更がある場合、Databricks はそれをデフォルト ブランチ (デタッチされたヘッド) のスナップショットに適用します。
  • ユーザーまたはサービスプリンシパルが、 update repo APIを使用してタグをチェックアウトしました。

この状態から回復するには、以下の手順に従ってください。

  1. 現在のコミットから新しいブランチを作成するには 「ブランチの作成」 をクリックし、既存のブランチをチェックアウトするには 「ブランチの選択」を クリックします。
  2. 変更を保持するにはコミットしてプッシュします。変更を破棄するには、ケバブメニューアイコン。 変更点 の下にあるケバブメニュー。

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

同一または類似のファイル名を持つノートブックは、リポジトリまたはプルリクエストを作成するときにエラーを引き起こす可能性があります（例: 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 リポジトリ内のノートブック、ファイル、またはフォルダーの名前を変更します。

エラーは再クローニングを示唆しています​

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

このエラーは、フォルダーの削除中に問題が発生し、リポジトリが不整合な状態になる可能性があることを示します。リポジトリを削除して再度クローンし、状態をリセットします。

ノートブックはユーザーの編集なしで変更されているように見える​

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

この問題を診断するには、.gitattributes ファイルがあるかどうかを確認してください。 もしあなたが：

  • * text eol=crlf含めることはできません。
  • Windows を使用していない場合は、この設定を削除します。開発環境と Databricks の両方で Linux の行末が使用されます。
  • Windows を使用している場合は、設定を* text=autoに変更します。Git は内部的には Linux スタイルの行末を持つファイルを保存しますが、プラットフォーム固有の行末で自動的にチェックアウトします。

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

  1. 未処理の変更をすべてクリアしてください。
  2. ご使用の環境に合わせて、上記の説明に従って.gitattributesファイルを更新してください。
  3. 変更をコミットします。
  4. git add --renormalizeを実行します。すべての変更をコミットしてプッシュします。