次の方法で共有

Synapse Visual Studio Code 拡張機能とは

  • [アーティクル]

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

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

前提条件

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

  • OpenJDK8 Web サイトから Java Development Kit(JDK) をインストールします。 JRE ではなく JDK リンクを使用していることを確かめます。
  • Conda をインストールします。
  • VS Code 用 Jupyter 拡張情報をインストールします

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

Windows

  1. 環境変数に JAVA_HOME を追加し、Java 1.8 のインストール ディレクトリをポイントします。 たとえば、このパス C:\Program Files\Java\jdk-1.8 に JDK をインストールする場合は、JAVA_HOME 変数の値をそのパスに設定します。

  2. システムのパス ディレクトリに、%JAVA_HOME%/bin と、Conda インストールの condabin サブフォルダーを両方とも追加します。 condabin フォルダーは、インストールしたフォルダー内に、この形式 \miniconda3\condsbin である可能性があります。 環境変数を開き、%JAVA_HOME%/bin パスと condabin パスを Path 変数に追加します。

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 エクスプローラーに [ワークスペースの選択] オプションが表示される場所を示すスクリーンショット。

現時点での制限事項

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

関連するコンテンツ

この概要では、Synapse VS Code 拡張機能をインストールしてセットアップする方法に関する基本的な事項を説明します。 以降の記事では、ローカル環境の VS Code でノートブックと Spark ジョブ定義を開発する方法について説明します。