要素图层

要素图层输出将数据管道数据集写入托管要素图层或托管表。 您可以创建要素图层或表、替换现有要素图层或表中的数据，或者向现有要素图层或表添加和更新记录。

参数

下表概述了要素图层输出中使用的参数：

参数	描述
输入数据集	将作为要素图层写入的数据集。
几何	包含将在输出要素图层中使用的位置的点、线或面几何字段。 如果未指定任何几何字段，则输出将为一个托管表。
时间类型	制定输出要素图层的时间类型。 选项包括时刻、间隔或无。 无为默认值。
时间	包含将在输出图层中使用的时间戳的时间字段。 如果时间类型为时刻，则此参数为必需项。
开始时间	包含将在输出图层中使用的开始时间戳的时间字段。 如果时间类型为间隔，则此参数为必需项。
结束时间	包含将在输出图层中使用的结束时间戳的时间字段。 如果时间类型为间隔，则此参数为必需项。
输出方法	指定将用于写入输出结果的方法。 选项包括创建（默认设置）、替换或添加并更新。
要素图层	要替换为新数据的托管要素图层或表。 如果输出方法为替换或添加并更新，则此参数是必需的。
唯一标识符	字段，其中包含每条记录的唯一值。 使用添加和更新输出方法更新要素图层中的现有记录时，此参数为必需项。
输出名称	输出要素图层或表的名称。
如果图层已存在，则覆盖	指定是否将覆盖具有提供的输出名称的现有图层（已选中）。
文件夹	将保存要素图层或表的输出文件夹。
字符串字段长度	用于指定所有输出字符串字段的长度的可选参数。 默认为 4000 个单字节字符。

用法说明

要运行数据管道，必须至少配置一个输出。

使用输入数据集参数识别要作为托管要素图层或表写入的数据集。

使用几何参数可以选择在输出上设置几何。 如果输入数据集具有单个几何字段，则默认情况下将指定该字段。 如果输入数据集包含多个几何字段，请指定将在要素图层中使用的几何字段。 此参数中未指定的几何字段将被删除，并且在输出中不可用。 如果未指定任何几何字段，则输出结果将为一个表格。

或者，您可以通过为时间类型指定一个值来设置输出时间。 选项如下：

• 时刻 - 单个时间点。 使用时间参数指定表示记录时间的字段。 时间字段必须是日期类型。
• 间隔 - 由开始时间和结束时间表示的时间间隔。 使用开始时间参数指定表示记录开始时间的字段，使用结束时间参数指定表示记录结束时间的字段。 时间字段必须是日期类型。
• 无 - 输出要素图层不具有时间。

日期字段将存储在要素图层和表中，采用从新纪元开始的毫秒格式和协调世界时间 (UTC)。 根据您查看数据的位置，这些值将以不同方式显示。 例如，查询要素服务 REST 端点将返回从新纪元开始的毫秒数值，例如 1667411518878。 Data Pipelines 编辑器中的相同值将显示为 11/02/2022 5:51 PM。

要修改项目属性，例如摘要或标签，请浏览到您的门户内容页面并直接编辑要素图层项目。

有关项目详细信息的更多信息，请参阅 ArcGIS Online

使用输出方法参数指定如何将数据管道结果写入要素图层或表。 选项如下：

• 创建 - 将创建托管要素图层或表。 输出将存储在门户内容中。 输出将包含来自输入数据集的要素（或行）和字段（或列）。 当选择创建输出方法时，以下参数可用：
  • 输出名称参数用于指定将创建或覆盖的图层的名称。
  • 如果图层已存在，则覆盖 参数允许您重新运行数据管道，而不更改输出名称，以及更改现有图层的方案或几何类型。 默认启用此参数。 如果组织中尚不存在该图层，则在第一次运行数据管道时，将创建一个新图层，并将在后续运行时覆盖该图层。 覆盖图层为永久性操作，无法撤消。
• 替换 - 将完全替换现有要素图层或表中的数据。
• 添加和更新 - 在要素图层或表中追加新记录或更新现有记录。 要更新现有记录，您必须指定一个包含唯一值的字段，以使用唯一标识符参数来标识现有记录。 必须将指定字段设置为要素图层或表项目页面上的唯一字段。 有关详细信息，请参阅向字段添加唯一约束。

使用字符串字段长度参数指定要在输出要素图层中创建的字符串字段长度。 指定长度适用于所有输出字符串字段。 默认为 4,000 个单字节字符。 如果输入数据集中的字符串超过指定字符串长度，则值将截断并写入输出要素图层。

局限性

以下是要素图层输出的已知限制：

• 只能写入每个输出的单一图层或表。 要创建多个输出，您必须在逻辑示意图中配置多个输出要素图层元素。 每个输出都将作为其自己的项目存储在您的门户内容中。
• 如果您配置了多个输出要素图层并且其中一个无法写入，则数据管道将继续写入剩余的输出要素层。 将回滚写入失败的任何输出要素图层。
• 将结果写入要素图层时，并非输入源支持的所有字段类型都会得到保留。 有关如何转换字段类型的详细信息，请参阅下表。
• 无法将替换或添加和更新用于您不拥有的要素图层或表，除非您是管理员，或者图层或表与您所属的共享更新群组共享。
• 使用更新或添加和更新时，字段将基于匹配的字段名称进行更新。 字段匹配区分大小写。 要将字段名称与所需输出图层相匹配，使用映射字段工具。 要修改所选字段名称，使用更新字段工具。
• 使用替换选项时，以下限制适用：
  • 不支持替换作为关系源的要素图层或表的数据。
  • 如果启用了要素图层或表的同步功能，则不支持替换。
  • 要替换的图层的几何类型必须与输入数据集相同。 例如，您不能使用面替换表，或使用折线替换点。
  • 要替换的图层的时间类型必须与输入数据集相同。 例如，您不能将时刻时间属性替换为间隔时间属性。
  • 如果要替换的图层的空间参考与输入几何不同，则输入几何将投影到要替换的图层的空间参考。
  • 如果某个字段存在于数据管道结果中但不存在于要替换的图层中，则不会将其添加到图层中。
  • 如果要替换的字段存在于图层中但不在数据管道结果中，它将保留在图层中并追加空值或要素图层定义的默认值。
• 当使用创建和如果图层已存在，则覆盖输出选项的组合时，以下限制适用：
  • 要覆盖的图层必须归您所有。
  • 要覆盖的图层必须由 Data Pipelines 创建。
  • 对于计划或自动运行，建议不要使用覆盖选项。 与替换以及添加并更新不同，覆盖选项会更改方案、几何和记录，由此可能会导致诸如弹出窗口或过滤器等下游工作流中断。
  • 当写入失败时，覆盖操作不会回滚，这可能会导致该图层丢失，直到数据管道再次运行。 当发生了失败时，替换和添加并更新选项将会回滚，并且保留原始数据。
  • 无法使用覆盖选项更新现有要素图层的空间参考。 几何字段必须与现有要素图层位于相同的空间参考中。 要更新输入几何的空间参考，请使用投影几何工具。
• 字符串字段长度参数适用于所有输出字符串字段。 要创建包含不同长度的字符串字段的要素图层，请创建一个新图层并使用该图层的替换输出方法。 这将保留已定义字段的长度并使用数据管道中的记录更新要素图层。 有关创建要素图层的详细信息，请参阅自行定义图层。

可以将输入数据集中的字段类型和值转换为输出要素图层支持的新类型和值。 下表概述了数据类型转换：

输入数据集字段类型	输出要素图层字段类型	备注
字符串	esriFieldTypeString	输出要素图层中的字符串字段默认使用长度 4000 个字符进行创建。 使用字符串字段长度参数指定其他长度。 将截断超出指定长度的值。
短整型	esriFieldTypeInteger
整型	esriFieldTypeInteger
大整数	esriFieldTypeBigInteger
转为浮点型	esriFieldTypeSingle
双精度	esriFieldTypeDouble
日期	esriFieldTypeDate	日期字段将在没有时区的情况下写入，并以从新纪元开始的毫秒格式存储。 在使用预览查看日期值时，将使用浏览器或客户端所在位置的时区。 了解 ArcGIS Online 中的日期字段的详细信息
仅日期	esriFieldTypeDateOnly
Blob	esriFieldTypeString	BLOB 值将在输出要素图层中转换为 base64 编码字符串。 在应用程序中预览此字段时，值将被转换为字符串 ("BLOB")。
布尔	esriFieldTypeString	布尔值将转换为字符串并存储在字符串字段中的要素图层中。 真值将写为 "True"，假值将写为 "False"。
阵列	esriFieldTypeString	数组值将被转换并存储为字符串字段。
地图	esriFieldTypeString	地图值将被转换并存储为字符串字段。
结构体	esriFieldTypeString	结构体值将被转换并存储为字符串字段。
几何	esriFieldTypeGeometry	几何字段可以表示点、线或面几何，具体取决于几何参数值。

许可要求

需要以下许可和配置：

• Creator 或 Professional 用户类型
• 发布者、服务商或管理员角色，或等效的自定义角色

有关 Data Pipelines 要求的详细信息，请参阅要求。

相关主题

有关附加信息，请参阅以下主题：

• 有关如何按照自动计划更新现有要素图层的详细信息，请参阅计划数据管道任务。
• 有关在要素图层上设置的属性的信息，请参阅管理托管要素图层。
• 有关要素图层的详细信息，请参阅 ArcGIS Online 帮助中的要素图层。