Visual Studio Code で Microsoft Fabric ノートブックを作成して管理する

Fabric Data Engineering Visual Studio (VS) Code 拡張機能は、Fabric でのノートブックの作成、読み取り、更新、削除 (CRUD) 操作を完全にサポートします。 この拡張機能では、ローカル ワークスペースとリモート ワークスペース間の同期もサポートされています。変更を同期すると、ローカル ワークスペースとリモート ワークスペース間の競合や相違点に対処できます。

この拡張機能を使用すると、Fabric 用リモート Apache Spark コンピューティングでノートブックを実行することもできます。

Data Engineering 拡張機能を使用してノートブックを開く

Fabric ポータルのノートブック作成ページで [ VS Code で開く ] ボタンをクリックすると、Data Engineering VS Code 拡張機能 for Fabric で同じノートブックを直接開くことができます。 VS Code で拡張機能をアクティブにして、ノートブックを 1 回開くと、ワークスペースはノートブックに自動的に接続されます。

ノートブックのリストを表示する

ノートブック ツリー ノードには、現在のワークスペース内のすべてのノートブック項目が一覧表示されます。 次の図に示されているように、VS Code での変更に基づいて、リストには最新の状態を示すさまざまな色と文字が表示されます。

• 既定値: テキストが白色で、ノートブック名の右側に文字がない場合、既定または初期化済みの状態を示します。 ノートブックはリモート ワークスペースに存在し、ローカルの VS Code にはダウンロードされません。
• 変更: 名前の右側の M 文字と黄色のテキストは、VS Code でノートブックをローカルにダウンロードして編集したことを示し、保留中の変更をリモート ワークスペースにまだ発行していません。
• ローカル: L という文字が表示されていて、テキストが緑色の場合は、ノートブックがダウンロードされていて、内容がリモート ワークスペースと同じであることを示します。
• 競合: C という文字があり、テキストが赤色の場合、ローカル バージョンとリモート ワークスペース バージョンの間に競合が存在することを示します。

ノートブックを作成する

1. VS Code エクスプローラーで、ノートブックツールバーにホバーします。 [ノートブックの作成] オプションが表示されます。

   

2. [ノートブックの作成] を選択し、名前と説明を入力します。 新しいノートブックがリモート ワークスペースに作成され、ノートブック リストに既定の状態で表示されます。

ノートブックをダウンロードする

ノートブックの内容を編集する前に、ノートブックを VS Code にダウンロードする必要があります。

1. VS Code のノートブックリストで、ノートブック名にカーソルを合わせます。 ノートブック名の横に [ダウンロード] オプションが表示されます。

   

2. [ダウンロード] を選択し、ノートブックをローカルの作業ディレクトリに保存します。

ノートブックを開く

1. VS Code エクスプローラーで、ダウンロードしたノートブックの名前をポイントします。 ノートブックの横に、[Open Notebook Folder] (ノートブック フォルダーを開く) オプションなど、いくつかのオプションが表示されます。

   

2. [Open Notebook Folder] (ノートブック フォルダーを開く) を選択します。ノートブックが VS Code エディターの画面で開きます。

ノートブックを削除する

ノートブックを削除するには:

1. VS Code エクスプローラーで、削除するノートブックの名前をポイントします。名前の右側に [Delete Notebook] (ノートブックの削除) オプションを含むオプションが表示されます。

   

2. [Delete Notebook] (ノートブックの削除) オプションを選択します。 メッセージが表示されたら、ローカル コピーのみ削除するか、ローカル コピーとリモート ワークスペース コピーの両方を削除するかを選択します。

ローカルの変更をリモート ワークスペースにパブリッシュする

ローカルの変更をリモート ワークスペースにプッシュするには:

1. VS Code エクスプローラーで、リモート ワークスペースにパブリッシュするノートブックの名前をポイントします。名前の右側に [パブリッシュ] オプションを含むオプションが表示されます。

   

2. 公開を選択します。 リモート ワークスペースのバージョンが、ローカルの VS Code の変更によって更新されます。

   • ローカル更新によってマージの競合が発生した場合は、マージが実行される前に競合を解決するように求められます。

3. 他のユーザーが Fabric ポータルで同じノートブックを開いている場合、次の図に示されているように、ローカルの VS Code の変更を受け入れるか拒否するように求められます。

   

   • 承諾: VS Code からの変更がワークスペースに正常に保存されます。
   • 拒否: VS Code からの変更は無視されます。

リモート ワークスペースから変更をプルする

ローカル バージョンを最新のワークスペース バージョンで更新するには、リモート バージョンをプルします。

1. VS Code エクスプローラーで、更新するノートブックの名前をポイントします。名前の右側に [Update Notebook] (ノートブックの更新) オプションを含むオプションが表示されます。

   

2. [Update Notebook] (ノートブックの更新) オプションを選びます。 VS Code によって、リモート ワークスペースから最新バージョンがプルされ、VS Code 差分エディターが開かれるので、2 つのノートブック ファイルを比較できます。 左側の画面はワークスペースからのもので、右側の画面はローカル バージョンからのものです。

   

3. 左側のコード/マークダウン セルを更新して問題に対処します。

4. すべての競合に対処したら、差分エディターの右上隅にある [マージ ] オプションを選択して、マージが完了することを確認します。 ([マージ] を選ぶまで、ノートブックは競合モードのままです。)

   

リモート Spark コンピューティングでノートブックを実行またはデバッグする

この拡張機能に付属しているカーネル synapse-spark-kernel を選択すると、リモート Spark コンピューティング上でコード セルを実行できます。 このカーネルを選択すると、拡張機能は実行時にすべての PySpark API 呼び出しをインターセプトし、対応する http 呼び出しをリモート Spark コンピューティングに変換します。 Python コードはローカル環境で引き続き実行されます。

関連するコンテンツ

• Visual Studio Code で Apache Spark ジョブ定義を作成および管理する
• Visual Studio Code で Microsoft Fabric レイクハウスを探索する