指定笔记本的运行时

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

注:

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

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

选择笔记本运行时

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

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

更改笔记本运行时

建议您在新版本可用时更新笔记本运行时,以利用最新的可用 Python

注:

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

从项目页面更改笔记本的运行时

请按照以下步骤在项目页面中更改应用于现有笔记本的运行时。 此工作流仅供可以使用笔记本运行时创建笔记本的成员使用。

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

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

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

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

  3. 单击保存确认。

从 Notebooks 主页更改笔记本运行时

您可以从主页更改应用于现有的一个或多个笔记本的运行时。 这些工作流仅由可以使用笔记本运行时创建笔记本的成员完成。

从主页更改单个笔记本的运行时

要从主页更改应用于单个现有笔记本的运行时,请按照下列步骤操作:

  1. 打开 Notebooks 主页,然后在要更新的笔记本上单击以选项 > 更新运行时
  2. 从下拉菜单中选择新的运行时。
  3. 单击更新

从主页更改一个或多个笔记本运行时

要从主页一次更改多个笔记本的运行时,请按照下列步骤操作:

  1. 打开 Notebooks 主页并选择一个或多个笔记本。
  2. 单击更新运行时
  3. 单击所有选定项目将所有选定的笔记本更新到相同的运行时
    1. 从下拉菜单中选择新的运行时。
    2. 单击更新
  4. 单击每个项目,分别为每个选定的笔记本选择运行时。
    1. 选择每个笔记本项目的运行时。
    2. 单击更新

在会话期间安装模块

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

该方法将在 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