次の方法で共有


Synapse Visual Studio Code 拡張機能とは

Synapse Visual Studio Code 拡張機能は、Microsoft Fabric Lakehouse を探索し、Fabric ノートブックと Spark ジョブ定義を作成するための開発者向けエクスペリエンスをサポートします。 必要な前提条件の使用を開始する方法など、拡張機能の詳細について説明します。

Visual Studio (VS) Code は、最も一般的な軽量ソース コード エディターの 1 つです。デスクトップ上で実行され、Windows、macOS、Linux で使用できます。 Synapse VS Code 拡張機能をインストールすると、VS Code でノートブックと Spark ジョブ定義をローカルで作成、実行、デバッグできます。 コードを Fabric ワークスペースのリモート Spark コンピューティングにポストして、実行またはデバッグすることもできます。 この拡張機能を使用すると、VS Code でテーブルや生ファイルを含む lakehouse データを参照することもできます。

前提 条件

Synapse VS Code 拡張機能の前提条件:

  • OpenJDK8 Web サイトから Java Development Kit(JDK) をインストールします。 JRE ではなく JDK リンクを使用してください。
  • の Conda をにインストールします。
  • VS Code Jupyter 拡張機能をインストールする

必要なソフトウェアをインストールしたら、オペレーティング システムのプロパティを更新する必要があります。

ウィンドウズ

  1. Windows の設定を開き、"システム環境変数の編集" の設定を検索します。

  2. システム変数 の中で JAVA_HOMEを探します。 存在しない場合は、[新しい] ボタンをクリックし、変数名 JAVA_HOME を入力し、変数の値フィールドに Java がインストールされているディレクトリを追加します。

    たとえば、このパス C:\Program Files\Java\jdk-1.8に JDK をインストールする場合は、JAVA_HOME 変数の値をそのパスに設定します。

  3. システム変数 の中で Path 変数を探し、その行をダブルクリックします。 [新規] ボタンをクリックし、フォルダー パスを追加して、パス変数に次のフォルダー パスを追加します。

    • %JAVA_HOME%/bin

    Conda の場合は、Conda インストールの次のサブフォルダーを追加します。 これらのサブフォルダーの完全なフォルダー パスを追加する

    • \miniconda3\condsbin
    • \miniconda3\Scripts

    例: C:\Users\john.doe\AppData\Local\miniconda3\condsbin

macOS

ターミナルで conda.sh を実行します。

  1. ターミナル ウィンドウを開き、conda がインストールされているフォルダーにディレクトリを変更してから、etc/profile.d サブディレクトリに変更します。 サブディレクトリには、conda.shという名前のファイルが含まれている必要があります。

  2. source conda.shを実行します。

  3. 同じターミナル ウィンドウで、sudo conda init実行します。

  4. Java --versionを入力します。 バージョンは Java 1.8 である必要があります。

拡張機能をインストールして環境を準備する

  1. VS Code 拡張機能マーケットプレース Synapse VS Code を検索し、拡張機能をインストールします。

  2. 拡張機能のインストールが完了したら、VS Code を再起動します。 拡張機能のアイコンが VS Code アクティビティ バーに表示されます。

ローカル作業ディレクトリ

ノートブックを編集するには、ノートブック コンテンツのローカル コピーが必要です。 拡張機能のローカル作業ディレクトリは、ダウンロードしたすべてのノートブック (異なるワークスペースのノートブックも含む) のローカル ルート フォルダーとして機能します。 コマンド Synapse:Set Local Work Folderを呼び出すことで、拡張機能のローカル作業ディレクトリとしてフォルダーを指定できます。

セットアップを検証するには、拡張機能の設定を開き、そこで詳細を確認します。

選択したローカル作業ディレクトリを示す [設定] 画面のスクリーンショット。

アカウントへのサインインとサインアウト

  1. VS Code コマンド パレットから、Synapse:Sign in コマンドを入力して拡張機能にサインインします。 別のブラウザー のサインイン ページが表示されます。

  2. ユーザー名とパスワードを入力します。

  3. 正常にサインインすると、ユーザー名が VS Code ステータス バーに表示され、サインインしていることを示します。

    サインイン状態を確認する場所を示す VS Code ステータス バーのスクリーンショット。

  4. 拡張機能からサインアウトするには、Synapse: Sign offコマンドを入力します。

作業対象のワークスペースを選択する

Fabric ワークスペースを選択するには、ワークスペースが作成されている必要があります。 お持ちでない場合は、Fabric ポータルで作成できます。 詳細については、「ワークスペース 作成する」を参照してください。

ワークスペースを作成したら、[ワークスペースの選択] オプション を選びます。 アクセスできるすべてのワークスペースの一覧が表示されます。一覧から目的のものを選択します。

[ワークスペースの選択] オプションを見つける場所を示す VS Code Explorer のスクリーンショット。

現在の制限事項

  • デスクトップ モードの拡張機能では、Microsoft Spark Utilities はまだサポートされていません
  • "!" で始まるシェル コマンドはサポートされていません。

この概要では、Synapse VS Code 拡張機能をインストールして設定する方法の基本的な理解を得ます。 次の記事では、VS Code でノートブックと Spark ジョブ定義をローカルで開発する方法について説明します。