“更新字段”工具可更新字段名称或字段类型。
示例
“更新字段”工具可用于以下场景:
- 数据集的字段名称不提供信息。 更新字段以使字段名称更有意义。
- 邮政编码字段经检测为整型,但您的工作流要求邮政编码值为字符串。 将字段类型从整型更新为字符串。
- 您拥有一个以 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。 如果转换不受支持,数据管道将运行失败并报错。 下表详述了是否支持转换以及适用的转换值格式。
| 字符串 | 短整型 | 整型 | 大整数 | 浮点型 | 双精度 | 仅日期 | 日期 | 布尔 | 点 | 多点 | 折线 | 多边形 | |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
字符串 | 是 | 是(舍入) | 是(舍入) | 是(舍入) | 是 | 是 | 是 | 是 | 是 | 是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,并在输出中显示为空。
许可要求
需要以下许可和配置:
- Creator 或 Professional 用户类型
- 发布者、服务商或管理员角色,或等效的自定义角色
有关 Data Pipelines 要求的详细信息,请参阅要求。