指定笔记本的运行时

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

注:

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

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

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

选择笔记本运行时

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

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

更改笔记本运行时

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

注:

在将笔记本运行时从“高级”更改为“标准”之前,请确保笔记本不使用 ArcPy仅在高级笔记本运行时中可用的其他库。 如果将标准笔记本运行时与笔记本中使用这些库的像元配合使用时,将出现错误。

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

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

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

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

  3. 单击保存确认。

在会话期间安装模块

笔记本创作者可以在笔记本会话期间通过使用 Python 包管理系统安装两个运行时中未包含的 conda 模块或不同版本模块以供使用。 建议您使用 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