指定笔记本的运行时

您在创建笔记本时所使用的资源和 Python 库可通过笔记本运行时运行。 该运行时由管理员加载到您的笔记本部署中。有两个可用运行时:标准运行时包含 ArcGIS API for Python几百个其他 Python,高级运行时除这些内容外还包含 ArcPy 及一些相关库。 可用的运行时取决于您的许可和权限。

注:

使用高级运行时的笔记本以运行 ArcGIS API for Python 以及标准运行时中的所有其他库。

将根据运行时对应的 ArcGIS Notebooks Services 版本为其分配相应的版本号:

ArcGIS Notebooks Services 版本清单版本停用日期

11.4

v11.0 Python

例如,11.4 的标准运行时名为 ArcGIS Notebooks Services Standard 11.0

要创建笔记本,管理员必须为您分配包含相应权限的成员角色。 使用标准运行时创建笔记本需要一个权限,而使用高级运行时创建笔记本则需要另一个权限。

选择笔记本运行时

创建新笔记本时,您可以选择笔记本将使用的运行时。 供您选择的列表取决于您的权限。 如果您被授予高级笔记本权限,则可以选择标准或高级运行时。 您还可以在创建笔记本后更改其运行时,操作步骤如下所示。

注:

如果您的组织的两种运行时均可用,且站点管理员已授予您使用高级运行时创建笔记本的权限,则您创建的所有笔记本都将默认使用高级运行时。

如果您具有相应的权限,则可能想要在不同情况下使用任一运行时创建笔记本。 例如,如果您正在创作笔记本以将其共享给组织中不具有高级笔记本权限的其他笔记本创作者,则您希望使用标准运行时创建笔记本。

第一次使用您从未用过的运行时创建笔记本时,将为您启动一个新笔记本部署。 此笔记本部署包括标准运行时,并与您的第一个笔记本部署(包含高级运行时)分开。 请确保您的站点管理员了解这一点,并能够在必要时调整可用的系统资源。

更改笔记本运行时

建议您在新版本可用时更新笔记本运行时,以利用最新的可用 Python。 请按照以下步骤更改应用于现有笔记本的运行时。 此工作流仅供可以使用笔记本运行时创建笔记本的成员使用。

注:

在更改笔记本的运行时之前,请查看笔记本中使用的可用库和相应的运行时版本。 某些代码在不同版本的库中可能会有不同的表现。 某些库并不是在所有笔记本运行时中都可用。 例如,ArcPy 仅在高级笔记本运行时中可用,因此如果切换到标准笔记本运行时,在使用 ArcPy 的笔记本中运行像元时会出现错误。

  1. 打开笔记本的项目页面并单击设置选项卡。

    在选项卡的笔记本部分中,在笔记本设置下,笔记本运行时选项会指定笔记本使用的运行时。

  2. 单击下拉列表选择运行时。
    注:

    如果您没有高级笔记本权限,则下拉列表中仅会显示“标准”运行时。

  3. 单击保存确认。

在会话期间安装模块

笔记本创作者可以在笔记本会话期间通过使用 conda 包管理系统安装两个运行时中未包含的 Python 模块或不同版本模块以供使用。 建议您使用 conda,因为 ArcGIS Notebooks 使用它来管理模块。

该方法将在笔记本会话期间安装所需模块。 笔记本关闭或用户的容器笔记本部署终止后,模块将不再可用。 要使用此方法安装模块,必须与 conda 通道建立网络连接。

注:

conda 包含在两个笔记本运行时中。 无需进行安装。

例如,要在会话期间安装 scrapy 包,请使用以下其中一个命令运行笔记本单元格,具体取决于您所使用的包管理系统:

使用 conda 包管理系统

!conda install --yes scrapy

要在使用中的笔记本运行时中使用不同版本的 Python 模块,请在命令中指定版本号。

运行 conda 命令之后必须重新启动内核,新包才会可用。

例如,某个软件包在 1.5 版本的两个笔记本运行时都可用,但您想使用 1.6 版本中引入的工具。 要在笔记本会话期间使用 1.6 版本的包,请使用以下其中一个命令运行笔记本单元格,具体取决于您所使用的包管理系统:

使用 conda 包管理系统

!conda install --yes <package name>==1.6