更新字段
“更新字段”工具可更新字段名称或字段类型。
示例
“更新字段”工具可用于以下场景:
数据集的字段名称不提供信息。 更新字段以使字段名称更有意义。
邮政编码字段经检测为整型,但您的工作流要求邮政编码值为字符串。 将字段类型从整型更新为字符串。
参数
下表概述了在“更新字段”工具中使用的参数:
| 参数 | 描述 |
|---|---|
| 输入数据集 | 包含将更新的字段的数据集。 |
| 更新 | 包含一个或多个字段及将对每个字段进行的更新的列表。 |
| 要更新的字段 | 将被更新的字段。 |
| 新字段名称 | 更新字段的新名称。 |
| 新字段类型 | 更新字段的新类型。 |
| 小数分隔符 | 如果您将字符串值转换为数字并且字符串值不使用句点 (.) 作为小数点分隔符,请指定小数点分隔符值。 设置此参数属于可选操作。 |
用法说明
使用输入数据集参数来识别包含要更新的字段的数据集。
使用要更新的字段参数提供要更新的字段。 单击添加按钮可更新多个字段。
您可以更新字段名称、类型或两者的组合。 每个字段至少需要更新一次。 选项如下:
新字段名称 - 更新指定字段的名称。
新字段类型 - 更新指定字段的类型。
以下是字段类型选项:
布尔 - 输出布尔类型字段。 布尔字段支持
true和false值。双精度 - 输出双精度类型字段。 双精度型字段支持小数。
整型 - 输出整型字段。 整型字段支持整数。
字符串 - 输出字符串型字段。 字符串字段支持字符串(文本)。
如果指定字段中的值无法转换为指定的新类型,则结果将为 null,并在输出中显示为空。
如果字符串使用的小数点分隔符不是句点 (.),则使用小数点分隔符参数将字符串字段转换为双精度值。 设置此参数属于可选操作。 以下是小数点分隔符参数的使用示例:
字符串字段包含使用逗号作为小数点分隔符的双精度值,例如
"3,55"。 要将此字段转换为双精度型,需指定新的双精度型字段类型和逗号 (,) 作为小数点分隔符。 结果将为双精度字段,其值为3.55等。字符串字段包含带有额外零填充的整型值,例如
"5,0000"。 要将此字段转换为整型,需将新字段类型指定为整型,并以逗号 (,) 作为小数点分隔符。 结果将为整型字段,其值为5等。
对于所有数值字段,预览将根据您在用户设置中设置的区域设置来格式化数字。
转换行为
“更新字段”工具会根据输入类型和目标类型以不同的方式处理转换行为。 支持的转换将成功,或者如果原始值无法转换为目标类型,返回空值。 如果不支持转换,则数据管道将失败并显示错误。 下表详述了是否支持转换以及适用的转换值格式。
| 字符串 | 整型 | 双精度 | 布尔 | |
|---|---|---|---|---|
| 字符串 | N/A | 是(舍入) | 是 | 是 |
| 小整型 | 是 | 是 | 是 | 是 |
| 整型 | 是 | N/A | 是 | 是 |
| 大整型 | 是 | 是 | 是 | 是 |
| 转为浮点型 | 是 | 是(舍入) | 是 | 是 |
| 双精度 | 是 | 是(舍入) | N/A | 是 |
| 仅日期 | 是 (ISO 8601) | 否 | 否 | 否 |
| 日期 | 是 (ISO 8601) | 是(秒) | 是(秒) | 否 |
| 布尔 | 是("true"、 ""false") | 是 | 是 | N/A |
| Blob | 是 | 否 | 否 | 否 |
| 数组 | 是 (JSON) | 否 | 否 | 否 |
| 地图 | 是 (JSON) | 否 | 否 | 否 |
| 结构体 | 是 (EsriJSON) | 否 | 否 | 否 |
| 点 | 是 (EsriJSON) | 否 | 否 | 否 |
| 多点 | 是 (EsriJSON) | 否 | 否 | 否 |
| 折线 | 是 (EsriJSON) | 否 | 否 | 否 |
| 多边形 | 是 (EsriJSON) | 否 | 否 | 否 |
输出
工具输出包含具有新更新字段的输入数据集。
许可要求
需要以下许可和配置:
Creator 或 Professional 用户类型
发布者、服务商或管理员角色,或等效的自定义角色
有关 Data Pipelines 要求的详细信息,请参阅要求。
此外,仅当您在 ArcGIS Enterprise 中配置了 ArcGIS Data Pipelines Server 时,Data Pipelines 才可用。