将新字段添加到表格、要素类或栅格。
此工具会修改输入数据。 有关详细信息以及避免数据被意外更改的策略，请参阅修改或更新输入数据的工具。
对于 shapefile 和 dBase 表，如果字段类型定义为字符型，则会为每条记录插入空白行。 如果字段类型定义为数值项，则会为每条记录插入零。
由字段属性参数指定的字段将具有以下默认属性：
可以使用字段属性或模板表参数将字段添加到输入中。 如果提供了两个参数的值，则将根据两个参数添加字段。
字段属性参数的字段长度选项仅适用于文本类型的字段。
shapefile 不支持字段别名，所以无法将字段别名添加到 shapefile。
栅格类型的字段允许将栅格影像包含为属性。 它存储在地理数据库中或与地理数据库一同存储。 当图像是描述要素的最佳途径时，这很有用。 无法为栅格类型的字段设置精度、比例和长度。
| 标注 | 说明 | 数据类型 |
输入表 | 将添加字段的输入表。 字段将被添加到现有输入表，并且不会创建新的输出表。 可将字段添加到地理数据库中的要素类、shapefile、coverage、独立表、栅格目录、带属性表的栅格和图层。 | Table View; Raster Layer; Mosaic Layer |
字段属性 (可选) | 将添加到输入表的字段及其属性。
可用字段类型如下：
| Value Table |
模板表 (可选) | 将用作模板以定义要添加的属性字段的要素类或表。 除了字段属性参数指定的任何字段之外，使用此参数指定的输入中的字段将被添加到输入表值中。 | Table View |
| 标注 | 说明 | 数据类型 |
| 更新的输入表 | 已更新的输入表。 | Table View; Raster Layer; Mosaic Layer |
arcpy.management.AddFields(in_table, {field_description}, {template})| 名称 | 说明 | 数据类型 |
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 |
template [template,...] (可选) | 将用作模板以定义要添加的属性字段的要素类或表。 除了 field_description 参数指定的任何字段之外，使用此参数指定的输入中的字段将添加到 in_table 值中。 | Table View |
| 名称 | 说明 | 数据类型 |
| out_table | 已更新的输入表。 | Table View; Raster Layer; Mosaic Layer |
以下 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', '']])