Visual Studio Code の Databricks 拡張機能のワークスペース ディレクトリを選択します
この記事は、以前のバージョンの Visual Studio Code 用 Databricks 拡張機能に適用されます。 Visual Studio Code の Databricks 拡張機能 バージョン 2 以降のワークスペース同期情報については、「 ワークスペース フォルダーを Databricks と同期する」を参照してください。
このドキュメントは廃止されており、更新されない可能性があります。 このコンテンツに記載されている製品、サービス、またはテクノロジはサポートされなくなりました。
この記事では、Visual Studio Code の Databricks 拡張機能で使用する Databricks ワークスペース ディレクトリを選択する方法について説明します。 「Visual Studio Code の Databricks 拡張機能とは」を参照してください。
次の情報は、Databricks ワークスペースでの認証用に Visual Studio Code の Databricks 拡張機能を既に設定していることを前提としています。 「Visual Studio Code の Databricks 拡張機能の承認を設定する」を参照してください。
Visual Studio Code の Databricks 拡張機能は、作成したワークスペース ディレクトリでのみ機能します。 ワークスペース内の既存のワークスペースディレクトリは、拡張機能によって作成されていない限り、使用できません。
Visual Studio Code の 拡張機能でワークスペース ディレクトリを使用するには、バージョン 0.3.5 以降の拡張機能を使用し、DatabricksDatabricks クラスターにDatabricks Runtime 11.3 以降がインストールされているLTS 。
ワークスペースディレクトリはデフォルト設定で、拡張機能のバージョン 0.3.15 以降です。 ただし、ワークスペース ディレクトリではなく Databricks Git フォルダーを使用するように拡張機能を設定した場合は、次のように拡張機能をワークスペース ディレクトリを使用するように元に戻すことができます。
- 拡張機能とコード プロジェクトを開き、Databricks 構成プロファイルを既に設定している状態で、コマンド パレット ( [表示] > [コマンド パレット ]) に「
Preferences: Open User Settings」と入力し、[ 基本設定: ユーザー設定を開く ] をクリックします。 - [ユーザー ] タブで [拡張機能 ] を展開し、[ Databricks ] をクリックします。
- 「同期: 宛先タイプ」 で、「 ワークスペース 」を選択します。
- Visual Studio Code を終了して再起動します。
Databricks Git フォルダーの使用からワークスペース ディレクトリの使用に設定を変更した後、コードをワークスペースに手動で再同期する必要がある場合があります。 これを行うには、次の手順で新しいワークスペースディレクトリを作成した後、「 同期先」 の横にある矢印の円( 「同期を開始 」)アイコンをクリックします。
拡張機能とコード プロジェクトを開いた状態で、使用する新しい Databricks ワークスペース ディレクトリを作成するか、拡張機能を使用して前に作成した既存のワークスペース ディレクトリを選択します。
新しいワークスペース ディレクトリを作成する
新しいワークスペースディレクトリを作成するには、次の操作を行います。
-
[構成 ] ペインの [同期先] の横にある歯車 ( 同期先の構成 ) アイコンをクリックします。
-
コマンド パレット で、[ 新しい同期先の作成 ] をクリックします。
-
新しいワークスペース ディレクトリの名前を入力し、 Enter キーを押します。
この拡張機能は、ワークスペース内の
/Users/<your-username>/.ide内に指定されたディレクトリ名でディレクトリを作成し、ワークスペース ディレクトリのパスをコード プロジェクトの.databricks/project.jsonファイル ("workspacePath": "/Users/<your-username>/.ide/<your-directory-name>"など) に追加します。
リモート ワークスペース ディレクトリの名前がローカル コード プロジェクトの名前と一致しない場合は、警告アイコンが表示され、"リモート同期先の名前が現在の Visual Studio Code ワークスペース名と一致しません" というメッセージが表示されます。名前を一致させる必要がない場合は、この警告を無視できます。
-
ワークスペースディレクトリを設定したら、「 同期先 」の横にある矢印付きの円( 「同期の開始 」)アイコンをクリックして、ワークスペースディレクトリとの同期を開始します。
Visual Studio Code の Databricks 拡張機能は、ローカルの Visual Studio Code プロジェクトからリモート Databricks ワークスペース内の関連するワークスペース ディレクトリへのファイル変更の一方向の自動同期のみを実行します。 このリモート・ワークスペース・ディレクトリ内のファイルは、一時的なものとして意図されています。 これらのファイルに対する変更は、ローカル プロジェクトに同期されないため、リモート ワークスペース内から開始しないでください。
既存のワークスペースディレクトリの再利用
以前に Visual Studio Code の Databricks 拡張機能を使用して作成した既存のワークスペース ディレクトリがあり、現在の Visual Studio Code プロジェクトで再利用する場合は、次の操作を行います。
-
[構成 ] ペインの [同期先] の横にある歯車 ( 同期先の構成 ) アイコンをクリックします。
-
コマンド パレット で、一覧からワークスペース ディレクトリの名前を選択します。
この拡張機能は、ワークスペース ディレクトリのパスをコード プロジェクトの .databricks/project.json ファイル ( "workspacePath": "/Users/<your-username>/.ide/<your-directory-name>"など) に追加します。
リモート ワークスペース ディレクトリの名前がローカル コード プロジェクトの名前と一致しない場合は、警告アイコンが表示され、"リモート同期先の名前が現在の Visual Studio Code ワークスペース名と一致しません" というメッセージが表示されます。名前を一致させる必要がない場合は、この警告を無視できます。
ワークスペースディレクトリを設定したら、「 同期先 」の横にある矢印付きの円( 「同期の開始 」)アイコンをクリックして、ワークスペースディレクトリとの同期を開始します。
Visual Studio Code の Databricks 拡張機能は、ローカルの Visual Studio Code プロジェクトからリモート Databricks ワークスペース内の関連するワークスペース ディレクトリへのファイル変更の一方向の自動同期のみを実行します。 このリモート・ワークスペース・ディレクトリ内のファイルは、一時的なものとして意図されています。 これらのファイルに対する変更は、ローカル プロジェクトに同期されないため、リモート ワークスペース内から開始しないでください。