工作区中的笔记本限制¶

笔记本服务与运行时¶

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

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

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

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

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

• uv 与标准 pip 的包安装和列表行为存在差异。Snowflake 支持使用 uv pip install 安装包，uv pip freeze 仅列出使用 uv pip install 安装的包。pip freeze 列出环境中可用的所有包，包括基础镜像中的包、使用标准 pip install 安装的包以及使用 uv pip install 安装的包。

• 不支持从外部暂存区安装包。

在工作区中使用笔记本¶

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

  1. 选择 Connected。

  2. 选择 Shut down kernel。

  3. 暂停笔记本服务。

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

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

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

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

编辑和运行笔记本¶

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

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

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

• 尚不支持 iPywidgets。

• Embedding remote images via URLs is not yet supported. To embed an image, upload it to your workspace and display it in a Markdown or Python cell. Example:

  CopyExpand

  ![My Image](path/to/example_image.png)
  

  Show lessSee more

  Scroll to top
  CopyExpand

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

  Show lessSee more

  Scroll to top

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

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

• 不支持将以下值用作列名称：

  • CURRENT_DATE

  • CURRENT_TIME

  • CURRENT_TIMESTAMP

  • LOCALTIME

  • LOCALTIMESTAMP

  • CURRENT_USER

  • SESSION_USER

  • SYSTEM_USER

从旧版笔记本迁移¶

有关将旧版笔记本迁移到工作区的信息，请参阅 将旧版笔记本迁移到工作区。