工作区中的笔记本限制¶

笔记本服务与运行时¶

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

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

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

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

• 为进行容器服务维护，笔记本服务可能在周末重启。重启后，您必须重新运行笔记本并重新安装所有软件包，以恢复变量和包。

• 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.

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

在工作区中使用笔记本¶

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

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

• 使用个人工作区不再需要次要角色。

  • 如果次要角色未设置为 ALL，则用户必须选择一个对计算池和 EAIs 具有 OWNERSHIP 或 USAGE 权限的角色才能创建服务。其他个人工作区功能（如 SQL 文件和 Git 集成）仍可使用。

  • 如果账户会话策略阻止使用次要角色，则笔记本无法在个人工作区中运行。

编辑和运行笔记本¶

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

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

• 尚不支持 iPywidgets。

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

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

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

  Copy

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

• 单元格输出不会保存到 .ipynb 文件中，且无法导出。

• SQL 单元格无法运行 EXECUTE NOTEBOOK PROJECT </sql-reference/sql/execute-notebook-project>`（非交互式执行）。要链接多个笔记本，请使用 Jupyter 魔法命令（如 :code:`%run），它会在同一个 Python 进程中执行另一个笔记本。

  目前，由 %run 调用的笔记本仅支持纯 Python 进程。

• 交互式数据网格无法在工作区中的笔记本内渲染。

• 不支持单元格引用。

• SQL 单元格可以转换为以 %%sql 开头的 Python 单元格。

• 不支持单元格排队，除非使用 Run all 按顺序执行笔记本中的所有单元格。

在工作区中使用原始 Snowflake 笔记本¶

If you have an original Snowflake notebook and would like to use it in Workspaces, you must first export the .ipynb file and any supporting files, then upload them to your workspace.

如果您对特定功能的可用时间表有疑问，请咨询您的账户代表，以便其联系笔记本产品团队。