在容器运行时的笔记本中管理包¶
容器运行时上的 Snowflake 笔记本目前支持用于管理包的常用 pip
命令和工作流程。这包括以下常见工作流程:
使用软件包规范(例如
requirements.txt
文件)来设置笔记本环境。查看笔记本环境中安装的所有包。
卸载包。
导出用于捕捉当前笔记本环境的软件包规范。
更新笔记本环境中的包。
除了这些工作流程外,容器运行时上的笔记本还支持其他 pip
工作流程。
先决条件¶
确保在笔记本中设置了 PyPI 的外部访问集成 (EAI),或者 Snowflake 账户中的 Artifact Repository 处于活动状态。有关 PyPI EAI 的更多信息,请参阅 在 Snowsight 中启用外部访问集成。有关 Artifact Repository 的信息,请参阅 Artifact Repository 概述。
查看笔记本环境中安装的所有包¶
要从笔记本单元格查看当前安装在笔记本环境中的包及其相应版本的完整列表,请运行以下命令:
!pip freeze
在笔记本环境中安装单个包¶
您可以在笔记本单元格中使用内联 pip
命令来安装单个包,以修改笔记本的 Python 环境。
要从笔记本单元格安装包,请运行以下命令:
!pip install <package_name>
根据包规范安装包以设置笔记本环境¶
您可以使用包规范(例如 requirements.txt
文件)修改笔记本的 Python 环境以安装所需的包。以下示例显示如何从存储在本地的 requirements.txt
文件中安装包。您还可以从存储在内部或外部暂存区的 requirements.txt
文件中安装包。
将
requirements.txt
文件上传到笔记本中。有关
requirements.txt
文件的信息,请参阅 需求文件格式 (https://pip.pypa.io/en/stable/reference/requirements-file-format/)。要从笔记本单元格安装所有包,请运行以下命令:
!pip install -r requirements.txt
在笔记本环境中更新包版本¶
在笔记本单元格上,运行与要更新到的包版本相对应的以下命令之一:
最新版本:
!pip install <package_name> --upgrade
特定版本:
!pip install <package_name> --<version>
要确认更新已完成,请在出现提示时重新启动笔记本内核。
从笔记本环境中卸载包¶
完成以下步骤,卸载您在笔记本环境中使用包规范安装的所有包。
验证笔记本环境中是否存在
requirements.txt
文件。在笔记本的单元格中运行以下命令:
!pip uninstall -r requirements.txt
要确认包已卸载,请在出现提示时重新启动笔记本内核。
将笔记本环境中的包作为包规范导出¶
您可以导出捕获笔记本环境当前状态的包规范。使用此包规范,您可以快速复制笔记本电脑环境。
在笔记本的单元格中运行以下命令:
!pip list --format=freeze <filename>.txt
要将文件上传到某个暂存区,请运行以下命令:
session.file.put("<path to file>/<filename>.txt", "@mystage/prefix1")
有关在暂存区中存储文件的更多信息,请参阅 在 Snowflake 暂存区中存储文件。