描述
将新字段添加到表格、要素类或栅格。
使用方法
对于 shapefile 和 dBase 表,如果字段类型定义为字符型,则会为每条记录插入空白行。如果字段类型定义为数值型,则将为每条记录插入零。
添加字段工具具有以下默认字段属性:
- 已添加字段允许空值属性将为 true。
- 已添加字段可编辑属性将为 true。
- 已添加字段必填项属性将为 false。
- 精度和比例由字段类型和数据源默认值设置。
字段长度仅适用于文本类型的字段。
shapefile 不支持字段别名,所以无法将字段别名添加到 shapefile。
栅格类型的字段允许将栅格影像包含为属性。它存储在地理数据库中或与地理数据库一同存储。当图像是描述要素的最佳途径时,这很有用。无法为栅格类型的字段设置精度、小数位数和长度。
语法
arcpy.management.AddFields(in_table, field_description)
参数 | 说明 | 数据类型 |
in_table | 将添加字段的输入表。字段将被添加到现有输入表,并且不会创建新的输出表。 可将字段添加到地理数据库中的要素类、shapefile、coverage、独立表、栅格目录、带属性表的栅格和图层。 | Table View; Raster Layer; Mosaic Layer |
field_description [[Field Name, Field Type, {Field Alias}, {Field Length}, {Default Value} {Field Domain}],...] | 将添加到输入表的字段及其属性。
可用字段类型如下:
在具有可选参数的 field_description 参数中,可使用 None 作为空占位符。 | Value Table |
派生输出
名称 | 说明 | 数据类型 |
out_table | 已更新的输入表。 | 表视图;栅格图层;镶嵌图层 |
代码示例
以下 Python 窗口脚本演示了如何在即时模式下使用 AddFields 工具。
import arcpy
arcpy.env.workspace = "C:/data/district.gdb"
arcpy.management.AddFields(
'school',
[['school_name', 'TEXT', 'Name', 255, 'Hello world', ''],
['street_number', 'LONG', 'Street Number', None, 35, 'StreetNumDomain'],
['year_start', 'DATE', 'Year Start', None, '2017-08-09 16:05:07', '']])
环境
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是