Skip to main content

更新字段

“更新字段”工具可更新字段名称或字段类型。

示例

“更新字段”工具可用于以下场景：

  • 数据集的字段名称不提供信息。 更新字段以使字段名称更有意义。

  • 邮政编码字段经检测为整型，但您的工作流要求邮政编码值为字符串。 将字段类型从整型更新为字符串。

  • 您拥有一个以 WKT 格式表示几何的字符串字段。 请使用“更新字段”将该字符串转换为几何。

参数

下表概述了在“更新字段”工具中使用的参数：

参数 描述
输入数据集 包含将更新的字段的数据集。
更新 包含一个或多个字段及将对每个字段进行的更新的列表。
小数分隔符 如果您将字符串值转换为数字并且字符串值不使用句点 (.) 作为小数点分隔符，请指定小数点分隔符值。 设置此参数属于可选操作。

用法说明

使用输入数据集参数来识别包含要更新的字段的数据集。

单击配置更新按钮以启动更新字段模态框，您可以在其中指定字段更新。

“更新字段”模态框提供以下功能：

  • 您可以更新字段名称、类型或两者的组合。 每个字段至少需要更新一次。 选项如下：

    • 要更新的字段 - 指定将要更新的字段。

    • 新字段名称 - 更新指定字段的名称。

    • 新字段类型 - 更新指定字段的类型。

  • 添加字段按钮可用于添加单个需要更新的字段。 要一次性添加所有字段，请使用添加所有字段按钮。

  • 添加建议字段按钮可用于自动配置 Data Pipelines 推荐的更新。 单击此按钮时，Data Pipelines 会对数据进行采样并可能提供更新建议。 例如，如果字符串字段包含 "12/23/2025" 等值，Data Pipelines 可能会建议采用新字段类型“仅日期”，日期格式为 MM/dd/yyyy。

建议是基于数据采样生成的。 如果字段包含大量 Null 值或空值，则可能无法为该字段提供建议。

以下是字段类型选项：

  • 字符串 - 输出字符串型字段。 字符串字段支持字符串（文本）。

  • 浮点型 - 输出浮点型字段。 浮点型字段支持介于大约 -3.4E38 和 3.4E38 之间的小数。

  • 双精度 - 输出双精度类型字段。 双精度型字段支持介于大约 -2.2E308 和 1.8E308 之间的小数。

  • 小整型 - 输出小整型类型字段。 小整型字段支持介于 -32768 和 32767 之间的整数。

  • 整型 - 输出整型类型字段。 整型字段支持介于 -2147483648 和 2147483647 之间的整数。

  • 大整型 - 输出大整型类型字段。 大整型字段支持介于 -9223372036854776000 和 9223372036854776000 之间的整数。

  • 日期 - 输出日期类型字段。 日期字段同时包含日期和时间值（例如：12/23/2025 12:30:30 PM）。

  • 仅日期 - 输出仅日期类型字段。 仅日期字段仅包含日期值（例如：12/23/2025）。

  • 点 - 输出点几何字段。

  • 折线 - 输出折线几何字段。

  • 面 - 输出面几何字段。

  • 多点 - 输出多点几何字段。

  • 布尔 - 输出布尔类型字段。 布尔字段支持 true 和 false 值。

如果值无法转换为新类型，结果将为 null，并在输出中显示为空。

如果字符串使用的小数分隔符不是句点 (.)，请使用小数分隔符参数将字符串字段转换为双精度字段。 设置此参数属于可选操作。 以下是小数点分隔符参数的使用示例：

  • 字符串字段包含使用逗号作为小数点分隔符的双精度值，例如 "3,55"。 要将此字段转换为双精度字段，指定新字段类型双精度，并使用逗号 (,) 作为小数分隔符。 结果将为双精度字段，其值为 3.55 等。

  • 字符串字段包含带有额外零填充的整型值，例如 "5,0000"。 要将此字段转换为整型，需将新字段类型指定为整型，并使用逗号 () 作为小数分隔符。 结果将为整型字段，其值为 5 等。

对于所有数值字段，预览将根据您在用户设置中设置的区域设置来格式化数字。

转换行为

“更新字段”工具根据输入类型和目标类型的不同，以不同方式处理字段转换。 对于受支持的转换，若转换成功则返回结果；若原始值无法转换为目标类型，则返回 Null。 如果转换不受支持，数据管道将运行失败并报错。 下表详述了是否支持转换以及适用的转换值格式。

字符串 小整型 整型 大整型 转为浮点型 双精度 仅日期 日期 布尔 Blob 数组 地图 结构体 点 多点 折线 多边形
字符串 是 是（舍入） 是（舍入） 是（舍入） 是 是 是 是 是 是5 是5 是5 是5 否 否 否 否
小整型 是 是 是 是 是 是 否 否 是 否 否 否 否 否 否 否 否
整型 是 是 是 是 是 是 否 是3 是 否 否 否 否 否 否 否 否
大整型 是 是 是 是 是 是 否 是3 是 否 否 否 否 否 否 否 否
转为浮点型 是 是（舍入） 是（舍入） 是（舍入） 是 是 否 是3 是 否 否 否 否 否 否 否 否
双精度 是 是（舍入） 是（舍入） 是（舍入） 是 是 否 是3 是 否 否 否 否 否 否 否 否
仅日期 是 (ISO 8601) 否 否 否 否 否 是1 否 否 否 否 否 否 否 否 否 否
日期 是 (ISO 8601) 否 是（秒） 否 否 是（秒） 是2 是1 否 否 否 否 否 否 否 否 否
布尔 是（"true"、 "false"） 是 是 是 是 是 否 否 是 否 否 否 否 否 否 否 否
Blob 是 否 否 否 否 否 否 否 否 是5 是5 是5 是5 否 否 否 否
数组 是 (JSON) 否 否 否 否 否 否 否 否 否 否 否 否 否 否 否 否
地图 是 (JSON) 否 否 否 否 否 否 否 否 否 否 否 否 否 否 否 否
结构体 是 (EsriJSON) 否 否 否 否 否 否 否 否 是5 是5 是5 是5 否 否 否 否
点 是 (EsriJSON) 否 否 否 否 否 否 否 否 是4 否 否 否 是4 否 否 否
多点 是 (EsriJSON) 否 否 否 否 否 否 否 否 否 是4 否 否 否 是4 否 否
折线 是 (EsriJSON) 否 否 否 否 否 否 否 否 否 否 是4 否 否 否 是4 否
多边形 是 (EsriJSON) 否 否 否 否 否 否 否 否 否 否 否 是4 否 否 否 是4

1 日期格式和时区参数将被忽略。

2 日期格式将被忽略。 时区为必填项。 日期将根据指定的时区被截断为“仅日期”。

3 日期格式必须为自纪元时间起的秒数或毫秒数。 时区将被忽略。 以毫秒或秒存储的日期始终以 UTC 时区表示。

4 几何格式和空间参考将被忽略。 若要更改几何字段的空间参考，请改用投影几何工具。

5 几何格式必须与输入字段类型兼容。 字符串输入字段必须使用 WKT、GeoJSON 或 EsriJSON 格式。 结构体输入字段必须使用 GeoJSON 或 EsriJSON 格式。 二进制字段必须使用 WKB 格式。

输出

工具输出包含具有新更新字段的输入数据集。 如果字段值无法转换为新类型，结果值将为 null，并在输出中显示为空。

许可要求

需要以下许可和配置：

  • Creator 或 Professional 用户类型

  • 发布者、服务商或管理员角色，或等效的自定义角色

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

此外，仅当您在 ArcGIS Enterprise 中配置了 ArcGIS Data Pipelines Server 时，Data Pipelines 才可用。