指定 notebook 的运行时

您在创建 notebook 时所使用的资源和 Python 库可通过 notebook 运行时运行。 有两个可用运行时:标准运行时包含 ArcGIS API for Python几百个其他 Python,高级运行时除这些内容外还包含 ArcPy 及一些相关库。 可用的运行时取决于您的许可和权限。

注:

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

要创建 notebook,管理员必须为您分配包含相应权限的自定义成员角色。 根据所需的 notebook 运行时,您必须分配有使用标准运行时或高级运行时的权限。 高级运行时权限还允许您将高级运行时与 GPU 运行时配合使用。

如果您的组织仅可使用标准运行时,并且您被分配了一个包含相应权限的角色,则可以立即开始创作 notebook。

选择 notebook 运行时

创建空白 notebook 时,您可以选择 notebook 将使用的运行时。 供您选择的列表取决于您的权限;如果您被授予高级 Notebooks 权限,则可以选择标准或高级运行时。 您也可以在创建 notebook 后更改运行时

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

更改 notebook 运行时

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

注:

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

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

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

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

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

  3. 单击保存确认。

在会话期间安装模块

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

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

注:

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

例如,要在会话期间安装 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