在 Visual Studio Code 中访问和管理 Microsoft Fabric 笔记本资源

Microsoft Fabric 笔记本现在支持称为 笔记本资源的功能。 借助此功能,可以在资源文件夹中存储.py格式和其他数据文件(例如 .csv 或图像文件)的代码模块。 可以从笔记本中以本地文件系统的形式访问所有这些资源文件。 本文介绍如何在 Visual Studio (VS) Code 中使用此功能,以及 Fabric 数据工程的 VS Code 扩展。

有关扩展的信息(包括如何安装扩展)请参阅 什么是 Fabric 数据工程 VS Code 扩展?

打开笔记本资源文件夹

  1. 安装扩展并在本地下载笔记本内容后,打开 VS Code。

  2. 选择 “打开笔记本文件夹 ”按钮以在 VS Code Explorer 中打开笔记本文件夹。 笔记本文件夹包含笔记本文件和资源文件夹,可在其中找到已上传到笔记本资源的所有资源文件。

    VS Code 中打开笔记本文件夹的屏幕截图。

  3. 现在可以编辑笔记本文件和资源文件。 资源文件显示在预定义内置文件夹下。 如果需要创建新文件或子文件夹,则必须在 内置 文件夹下创建它们。 (在 内置 文件夹外部创建的任何文件或文件夹都不会上传到笔记本资源。)

    VS Code 中笔记本资源文件夹的屏幕截图。

上一个屏幕截图显示了在内置文件夹下创建的 localLib 文件夹。 此文件夹包含 util.py 文件。 可以将此文件作为本地模块导入笔记本文件,如以下示例代码所示。 导入后,可以从笔记本文件中调用 util.py 文件中定义的函数。

import builtin.localLib.util as util  
util.func1()

上传笔记本资源文件

编辑笔记本文件和资源文件后,可以通过选择“ 发布资源文件夹 ”选项将笔记本资源上传到远程工作区。 上传过程会将 内置 文件夹下的所有文件和子文件夹上传到笔记本资源。 上传过程会覆盖远程工作区中的资源文件版本,并且如果您在本地删除了某些资源文件,上传过程也会删除它们。

VS Code 中上传笔记本资源的屏幕截图。

下载笔记本资源文件

若要从远程工作区下载笔记本资源,请选择 “更新资源文件夹” 选项。 下载操作会将 内置 文件夹下的所有文件和子文件夹下载到本地的笔记本文件夹中。 下载过程覆盖资源文件的本地版本。 对于远程工作区中不再存在的任何文件,下载过程会将这些文件移动到其原始父文件夹下的 _backup 子文件夹。

VS Code 中下载笔记本资源的屏幕截图。

以下屏幕截图显示了 util.py 文件移动到localLib 文件夹下的 _backup 子文件夹,因为有人在远程工作区中删除了该文件。

显示已删除的文件已移动到备份子文件夹的屏幕截图。