使用 Python 代码片段

在 ArcGIS Enterprise 11.0 中引入，ArcGIS Notebook Server 允许您浏览可重用代码的预写部分（称为代码片段）并将其插入到笔记本中。

创建代码片段

您可以从笔记本创建代码片段。 所创建的代码片段可以用于同一笔记本或其他笔记本。 所创建的代码片段存储在笔记本代码片段库项目中，此项目用于组织您的代码片段，并且支持共享。

要创建代码片段，您必须先创建一个笔记本代码片段库，以便在其中存储代码片段。 代码片段库最多可包含 100 个片段。

创建笔记本代码片段库

要创建代码片段库，请完成以下步骤：

1. 在笔记本编辑器的顶部功能区上，单击代码片段。
2. 单击添加按钮 ，然后选择创建库项目。
3. 输入库的标题和摘要，然后选择性地添加标签，这些标签用于表示存储在库中的代码片段。
4. （可选）选择我的内容中的文件夹来保存您的代码片段库。
5. 单击创建。

在创建代码片段库后，它会像任何其他项目一样存储在组织中。 要管理代码片段库，可在代码片段窗格中单击更多选项按钮 ，然后单击管理库项目。 在管理代码片段库项目窗口中，可以新建代码片段库，对于每个代码片段库，可以共享、编辑、查看项目详细信息页面，然后将库标记为已弃用。

添加代码片段

创建库后，即可向其中添加代码片段。 要添加代码片段，请执行以下操作：

1. 在笔记本编辑器的顶部功能区上，单击代码片段。
2. 单击添加按钮 ，然后选择添加代码片段。
3. 输入代码片段的标题，选择要添加代码片段的库，然后输入描述。

   选择代码片段库项目下拉列表显示了可向其添加片段的库。 该列表还指示了该库中的片段数。

4. 通过执行以下操作之一添加片段代码：
   • 如果笔记本使用运行时版本 8.0 或更高版本，需选择要添加为代码片段的单元格，然后单击从活动单元格复制。
   • 如果笔记本使用运行时版本 7.0 或较早版本，需输入代码片段的代码。

     注：

     从笔记本单元格中复制并粘贴代码而不是直接输入代码，以避免缩进错误或其他语法错误。

5. 单击保存。

您可以单击代码片段的更多选项按钮 ，更改代码片段。 更多选项下拉菜单提供用于编辑、弃用和删除片段的选项。

插入代码片段

使用代码片段窗格，完成以下步骤以插入代码片段：

1. 在笔记本编辑器的顶部功能区上，单击代码片段。
2. 浏览要插入的代码片段所在的代码片段库。
3. 单击代码片段的查看详细信息以查看代码预览。
4. 找到要插入的代码片段后，单击代码片段窗格中的添加按钮 或单击代码预览窗格中的插入笔记本，将代码片段作为新单元格插入到笔记本中。

以下是添加到笔记本的代码片段示例。

# curated code snippet inserted from the Code snippets pane
from arcgis.gis import GIS
def check_org_credits_agol(gis: GIS):
    if "admin" in gis.__dict__:
        credits = gis.admin.credits.credits
        print(f"This ArcGIS Online organization has {credits} credits.")
    else:
        print("Please connect to the ArcGIS Online organization as an administrator to check credits.")

# create a GIS instance to pass to the code snippet function
gis_agol = GIS("https://www.arcgis.com/", "<admin_username>")

# call the code snippet function with your GIS instance
check_org_credits_agol(gis_agol)

Esri 代码片段

所有可用的代码片段均为 Esri 精选内容。 这些精选的代码片段允许您在笔记本中实施常见的 GIS 工作流。 将代码片段编写为 Python 函数，这些函数可被插入到笔记本中并支持全范围调用。 将代码片段添加到笔记本后，也可以对其进行编辑。

注：

在 11.0 中，精选代码片段的名称和描述仅提供英文版本。

以下是可以插入到笔记本中的可用代码片段：

1. GIS 管理 - 执行常见 GIS 管理任务的代码片段

   注：

   其中许多代码片段需要管理员连接。

   • 检查剩余配额（仅限 ArcGIS Online）
   • 检查特定用户的配额（仅限 ArcGIS Online）
   • 获取图层项目的基础服务 URL
   • 查询失败的笔记本任务
   • 查询门户日志并另存为 CSV（仅限 ArcGIS Enterprise）
   • 登录门户（适用于 ArcPy）
2. 内容管理 - 代码片段有助于管理 GIS 中的内容和笔记本工作区目录中的文件。
   • 在工作空间目录中复制地理数据库
   • 使用空要素类创建文件地理数据库
   • 在工作空间目录中创建文件夹
   • 将文件项目从门户下载到工作空间目录
   • 列出数据集
   • 列出文件
   • 从工作空间目录中移除文件地理数据库
   • 从工作空间目录中移除文件夹
   • 将文件解压到工作空间目录
3. 数据科学和分析 - 可以使用 ArcGIS API for Python、ArcPy 和其他 Python 库在您的数据科学和分析工作流中实施的代码片段。

   注：

   使用高级笔记本运行时以运行需要 ArcPy 的代码片段。 有关笔记本运行时的详细信息，请参阅指定笔记本的运行时。

   • 将要素类转换为要素图层
   • 将要素类转换为启用空间功能的 DataFrame
   • 将要素图层转换为启用空间功能的 DataFrame
   • 将启用空间功能的 DataFrame 转换为要素类
   • 显示来自 URL 的图像
   • 显示来自工作空间目录的图像
   • 填充缺失值
   • 列出要素类中的字段
   • 列出图层中的字段
   • 列出项目中的图层
   • 绘制启用空间功能的 DataFrame（快速入门）
   • 使用分类间隔渲染器绘制启用空间功能的 DataFrame
   • 使用简单渲染器绘制启用空间功能的 DataFrame
   • 使用唯一值渲染器绘制启用空间功能的 DataFrame
   • 将启用空间功能的 DataFrame 发布为要素图层