要素图层

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

参数

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

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

用法说明

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

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

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

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

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

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

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

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

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

• 创建 - 将创建托管要素图层或表。 输出将存储在门户内容中。 输出将包含来自输入数据集的要素（或行）和字段（或列）。
• 替换 - 将完全替换现有要素图层或表中的数据。
• 添加和更新 - 在要素图层或表中追加新记录或更新现有记录。 要更新现有记录，您必须指定一个包含唯一值的字段，以使用唯一标识符参数来标识现有记录。 必须将指定字段设置为要素图层或表项目页面上的唯一字段。 有关详细信息，请参阅向字段添加唯一约束。

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

局限性

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

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

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

输入数据集字段类型	输出要素图层字段类型	备注
字符串	esriFieldTypeString	输出要素图层中的字符串字段默认使用长度 4,000 进行创建。 使用字符串字段长度参数指定其他长度。 将截断超出指定长度的值。
短整型	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 帮助中的要素图层。