Skip To 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)。
  • - 输出点几何字段。
  • 折线 - 输出折线几何字段。
  • - 输出面几何字段。
  • 多点 - 输出多点几何字段。
  • 布尔 - 输出布尔类型字段。 布尔字段支持 truefalse 值。

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

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

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

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

类型转换行为

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

字符串短整型整型大整数浮点型双精度仅日期日期布尔多点折线多边形

字符串

是(舍入)

是(舍入)

是(舍入)

5

5

5

5

短整型

整型

3

大整数

3

浮点型

是(舍入)

是(舍入)

是(舍入)

3

双精度

是(舍入)

是(舍入)

是(舍入)

3

仅日期

是 (ISO 8601)

1

日期

是 (ISO 8601)

是(秒)

是(秒)

2

1

布尔

是("true"、"false")

Blob

5

5

5

5

数组

是 (JSON)

地图

是 (JSON)

结构体

是 (JSON)

5

5

5

5

是 (EsriJSON)

4

多点

是 (EsriJSON)

4

折线

是 (EsriJSON)

4

多边形

是 (EsriJSON)

4

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

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

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

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

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

输出

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

许可要求

需要以下许可和配置:

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

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