管理包和运行时

Snowflake 笔记本在针对可扩展 AI/ML 开发优化的预构建容器环境中运行，并由 Snowflake 容器运行时提供支持。

Python 版本

Snowflake Notebooks support Python versions from 3.10 to 3.12. When creating a notebook service, select the Python version that best fits your workload requirements.

预安装的 Snowflake 容器运行时包

Snowflake 容器运行时版本 2.2 包含大约 100 个包和库，支持在 Snowflake 内部执行广泛的 ML 开发任务。

以下部分列出了每个 Python 版本的 Snowflake 容器运行时版本 2.2 可用的预安装包的精选子集（每个环境 40 个条目）。

备注

要查看当前笔记本环境的预安装包的完整列表，请在 Python 单元格或笔记本终端中运行 pip freeze。

CPU 版本 2.2

以下包适用于 CPU 版本 2.2 的每个 Python 版本：

CPU 容器运行时 Python 3.10 版本 2.2 包括以下包：

包

版本

absl-py

2.3.1

aiobotocore

2.26.0

aiohappyeyeballs

2.6.1

aiohttp

3.13.3

aiohttp-cors

0.8.1

aioitertools

0.13.0

aiosignal

1.4.0

altair

5.5.0

annotated-doc

0.0.4

annotated-types

0.7.0

anyio

4.12.1

appdirs

1.4.4

argon2-cffi

25.1.0

argon2-cffi-bindings

25.1.0

arrow

1.4.0

arviz

0.23.1

asn1crypto

1.5.1

asttokens

3.0.1

async-lru

2.1.0

async-timeout

5.0.1

attrs

25.4.0

babel

2.17.0

bayesian-optimization

1.5.1

beautifulsoup4

4.14.3

bleach

6.3.0

blinker

1.9.0

boto3

1.41.5

botocore

1.41.5

cachetools

5.5.2

CausalPy

0.5.0

certifi

2026.1.4

cffi

1.17.1

charset-normalizer

3.4.4

click

8.2.1

clikit

0.6.2

cloudpickle

3.1.1

cmdstanpy

1.3.0

colorama

0.4.6

colorful

0.5.8

comm

0.2.3

GPU 版本 2.2

以下包适用于 GPU 版本 2.2 的每个 Python 版本：

GPU 容器运行时 Python 3.10 版本 2.2 包括以下包：

包

版本

absl-py

2.3.1

accelerate

1.12.0

aiobotocore

2.26.0

aiohappyeyeballs

2.6.1

aiohttp

3.13.3

aiohttp-cors

0.8.1

aioitertools

0.13.0

aiosignal

1.4.0

airportsdata

20250909

altair

5.5.0

annotated-doc

0.0.4

annotated-types

0.7.0

anyio

4.12.1

appdirs

1.4.4

argon2-cffi

25.1.0

argon2-cffi-bindings

25.1.0

arrow

1.4.0

arviz

0.23.1

asn1crypto

1.5.1

astor

0.8.1

asttokens

3.0.1

async-lru

2.1.0

async-timeout

5.0.1

attrs

25.4.0

babel

2.17.0

bayesian-optimization

1.5.1

beautifulsoup4

4.14.3

blake3

1.0.8

bleach

6.3.0

blinker

1.9.0

boto3

1.41.5

botocore

1.41.5

cachetools

5.5.2

CausalPy

0.5.0

certifi

2026.1.4

cffi

1.17.1

charset-normalizer

3.4.4

click

8.2.1

clikit

0.6.2

cloudpickle

3.1.1

安装附加包

Snowflake 支持从多个来源安装包。

来自外部存储库

在配置了用于安全访问存储库的外部访问集成 (EAIs) 后，您可以直接从外部源（例如 PyPI）安装包。除了预安装的运行时外，用户还可以访问全面的包生态系统，从而确保与外部存储库的安全连接。

您可以在 Python 单元格或笔记本终端中运行 pip install。

有关更多信息，请参阅 为 Snowflake Notebooks 设置外部访问。

从 requirements.txt 安装

您可以在 requirements.txt 文件中指定并安装所需的包版本，以确保一致的环境设置。使用以下命令安装它们：

!pip install -r requirements.txt

备注

如果 requirements.txt 中指定的包版本与受支持的 预安装包 版本冲突，Python 环境可能会崩溃。安装前请验证兼容性。

来自工作区文件

您可以下载或构建 .whl 或 .py 文件，将它们上传到您的工作区，并进行安装或导入。

  • Wheel 文件 (.whl)： 上传 .whl 文件并安装：

    !pip install file_name.whl

    如果包包含尚未安装的依赖关系，请上传完整的依赖关系树（直接上传到工作区或暂存区）。或者，附加一个 EAI，允许访问可以下载包的存储库（例如 PyPI）。

  • Python 文件 (.py)： 工作区中存储的模块可以直接导入，以便在笔记本之间共享工具和函数。例如：

    from my_utils import my_func

来自 Snowflake 暂存区

暂存区利用现有的 Snowflake 数据存储和包文件的治理控制，提供安全且受监管的包部署。使用 Snowpark 会话将包文件从 Snowflake 暂存区检索到容器环境中，以便导入和使用。例如：

from snowflake.snowpark.context import get_active_session
import sys

session = get_active_session()
session.file.get("@db.schema.stage_name/math_tools.py", "/tmp")

sys.path.append("/tmp")
import math_tools

math_tools.add_one(3)

运行时管理

运行时固定

所有笔记本服务都固定在创建时选择的运行时，除非您通过编辑服务明确更改它。例如，在 Runtime 2.0 上创建的笔记本服务在发布新的运行时版本时不会自动升级。

运行时漏洞扫描

Snowflake 每天都会扫描运行时镜像以查找安全漏洞。检测到高危或严重的常见漏洞与披露 (CVEs) 后，会在 30 天内通过发布新的运行时版本来解决。

现有的笔记本服务可以继续使用检测到 CVEs 的运行时。但是，在创建新的笔记本服务时，无法选择已知存在 CVEs 的运行时。