您在创建笔记本时所使用的资源和 Python 库可通过笔记本运行时运行。 该运行时由站点管理员加载到您的笔记本容器中。 有两个可用运行时:标准运行时包含 ArcGIS API for Python 及几百个其他 Python 库,高级运行时除这些内容外还包含 ArcPy 及一些相关库。 可用的运行时取决于您的许可和权限。
注:
使用高级运行时的笔记本以运行 ArcGIS API for Python 以及标准运行时中的所有其他库。
将根据运行时对应的 ArcGIS Notebook Server 版本为其分配相应的版本号:
ArcGIS Notebook Server 版本 | 清单版本 | 停用日期 |
---|---|---|
11.3 | 2030 年 6 月 1 日 | |
11.2 | 2026 年 11 月 1 日 | |
11.1 | 2029 年 5 月 1 日 | |
11.0 | 2025 年 8 月 1 日 | |
10.9.1 | 2027 年 12 月 1 日 | |
10.9 | 2024 年 6 月 1 日 | |
10.8.1 | 2026 年 8 月 1 日 | |
10.7.1 | 2025 年 6 月 1 日 |
例如,11.3 的标准运行时名为 ArcGIS Notebook Server Standard 10.0。
要创建笔记本,管理员必须为您分配包含相应权限的自定义成员角色。 使用标准运行时创建笔记本需要一个权限,而使用高级运行时创建笔记本则需要另一个权限。
如果您的组织仅可使用标准运行时,并且您被分配了一个包含相应权限的角色,则可以立即开始创作笔记本。
选择笔记本运行时
创建空白笔记本时,您可以选择笔记本将使用的运行时。 供您选择的列表取决于您的权限。 如果您被授予高级 Notebook 权限,则可以选择标准或高级运行时,以及任何可用的自定义运行时。 您还可以在创建笔记本后更改其运行时,操作步骤如下所示。
注:
如果您的组织的两种运行时均可用,且站点管理员已授予您使用高级运行时创建笔记本的权限,则您创建的所有笔记本都将默认使用高级运行时。
如果您具有相应的权限,则可能想要在不同情况下使用任一运行时创建笔记本。 例如,如果您正在创作笔记本以将其共享给组织中不具有高级 Notebook 权限的其他笔记本创作者,则您希望使用标准运行时创建笔记本。
第一次使用您从未用过的运行时创建笔记本时,将为您启动一个新容器。 该容器将包括“标准”运行时,并与您的第一个容器(包括“高级”运行时的容器)分开。 请确保您的站点管理员了解这一点,并能够在必要时调整可用的系统资源。
更改笔记本运行时
建议您在新版本可用时更新笔记本运行时,以利用最新的可用 Python 库。 请按照以下步骤更改应用于现有笔记本的运行时。 此工作流仅供可以使用笔记本运行时创建笔记本的成员使用。
注:
在将笔记本运行时从“高级”更改为“标准”之前,请确保笔记本不使用 ArcPy 或仅在高级笔记本运行时中可用的其他库。 如果将标准笔记本运行时与笔记本中使用这些库的像元配合使用时,将出现错误。
- 打开笔记本的项目详细信息页面并单击设置选项卡。
在选项卡的 Notebook 部分中,在 Notebook 设置下,Notebook 运行时选项会指定笔记本使用的运行时。
- 单击下拉列表选择运行时。
注:
如果您没有高级 Notebook 权限,则下拉列表中仅会显示“标准”运行时。
- 单击保存确认。
笔记本现在即使用标准运行时,可以共享给任何具有标准运行时访问权限的成员。 将由第二个容器负责托管该笔记本。 在该笔记本中无法使用 ArcPy。
在会话期间安装模块
笔记本创作者可以在笔记本会话期间通过使用 conda 包管理系统安装两个运行时中未包含的 Python 模块或不同版本模块以供使用。 建议您使用 conda,因为 ArcGIS Notebooks 使用它来管理模块。
该方法将在 notebook 会话期间安装所需模块。 关闭 notebook 或终止属于用户的容器后,该模块将不再可用。 要使用此方法安装模块,必须与 conda 通道建立网络连接。
注:
conda 包含在两个笔记本运行时中。 无需进行安装。
例如,要在会话期间安装 scrapy 包,请使用以下其中一个命令运行 notebook 单元格,具体取决于您所使用的包管理系统:
使用 conda 包管理系统
!conda install --yes scrapy
要在使用中的 notebook 运行时中使用不同版本的 Python 模块,请在命令中指定版本号。
运行 conda 命令之后必须重新启动内核,新包才会可用。
例如,某个软件包在 1.5 版本的两个 notebook 运行时都可用,但您想使用 1.6 版本中引入的工具。 要在 notebook 会话期间使用 1.6 版本的包,请使用以下其中一个命令运行 notebook 单元格,具体取决于您所使用的包管理系统:
使用 conda 包管理系统
!conda install --yes <package name>==1.6