工作区中的笔记本限制

笔记本服务与运行时

  • 每个账户的活跃笔记本服务数量上限为 200 个。

  • 不同工作区中的笔记本无法共享同一服务。

  • 默认情况下，同一工作区内的笔记本会连接到共享服务。

  • 用户可在工作区内创建多个服务，并根据需要将笔记本分配给不同服务。

  • Notebook services may be restarted over the weekend for container service maintenance. After a restart, you must rerun notebooks and reinstall any packages to restore variables and packages. For more information, see Service maintenance.

  • Package installation and listing behavior differs between uv and standard pip. Snowflake supports installing packages using uv pip install, and uv pip freeze lists only packages installed using uv pip install. pip freeze lists all packages available in the environment, including packages in the base image, packages installed with standard pip install, and packages installed with uv pip install.

  • 不支持与外部暂存区通信。

在工作区中使用笔记本

  • 在关闭内核之前，SQL 单元格中的查询不会出现在 Query History 窗格中：

    1. 选择 Connected。

    2. 选择 Shut down kernel。

    3. 暂停笔记本服务。

  • 重命名笔记本文件、文件夹或工作区可能会导致异常行为，包括服务断开连接、清除笔记本的输出缓存或延迟更新引用文件。

  • 如果连接断开，请尝试重新连接笔记本。如果您重命名了工作区，请创建并使用新服务。

  • 在 Git 集成工作区中查看差异或在共享工作区中查看发布历史记录时，当前不支持逐单元格呈现。整个笔记本文件以统一差异形式显示。

编辑和运行笔记本

  • 对笔记本导入的 Python 文件 (.py) 的更新不会被活动的笔记本服务自动检测。要应用更改，请重新启动笔记本内核，或在初始导入前使用 %autoreload magic 命令，以便自动检测文件更新。

  • 每个单元格的输出限制为 1 MB。

  • 以前笔记本执行的输出缓存在内部存储系统中，该系统尚未采用 Tri-Secret Secure。对此缓存的访问是静态加密的，缓存中的结果受治理规则保护。

  • 尚不支持 iPywidgets。

  • 尚不支持在 Markdown 单元格中嵌入图像或通过 URLs 使用远程图像。

    要在笔记本中嵌入图像，请将其上传到您的工作区并使用 Python 单元格进行显示，例如：

    from IPython.display import Image, display
display(Image(filename="path/to/example_image.png"))
    Copy

    为了使演示更加整洁，您可以折叠代码单元格以仅显示图像结果。

  • SQL cells cannot run EXECUTE NOTEBOOK PROJECT (non-interactive execution). To chain notebooks, use Jupyter magic commands, such as %run, which executes another notebook in the same Python process. For more information, see Jupyter magics.

  • 如果在工作区中运行笔记本时未设置执行上下文（数据库和架构）或查询仓库，则用于在代码单元格和单元格引用中显示表结果的交互式数据网格可能无法正常工作。有关设置执行上下文的信息，请参阅 设置执行上下文。

Migrating from legacy notebooks

For information about migrating legacy notebooks to Workspaces, see 将旧版笔记本迁移到工作区.

语言: 中文