添加字段 (Data Management)

许可等级:BasicStandardAdvanced

摘要

向表或要素类表、要素图层、栅格目录和/或带属性表的栅格添加新字段。

用法

语法

AddField_management (in_table, field_name, field_type, {field_precision}, {field_scale}, {field_length}, {field_alias}, {field_is_nullable}, {field_is_required}, {field_domain})
参数说明数据类型
in_table

要添加指定字段的输入表。该字段将被添加到现有输入表,并且不会创建新的输出表。

可将字段添加到 ArcSDE 的要素类、文件或个人地理数据库的要素类、coverage、shapefile、栅格目录、独立表、带属性表的栅格和/或图层。

Mosaic Layer; Raster Catalog Layer; Raster Layer; Table View
field_name

要添加到输入表的字段的名称。

String
field_type

在创建新字段时所使用的字段类型。

  • TEXT名称或其他文本特性。
  • FLOAT特定范围内含小数值的数值。
  • DOUBLE特定范围内含小数值的数值。
  • SHORT特定范围内不含小数值的数值;编码值。
  • LONG特定范围内不含小数值的数值。
  • DATE日期和/或时间。
  • BLOB影像或其他多媒体。
  • RASTER栅格影像。
  • GUIDGUID 值
String
field_precision
(可选)

描述可存储在字段中的位数。所有位都将被计算在内,而无论其处于小数点的哪一侧。

如果输入表是个人或文件地理数据库,则将忽略字段精度值。

Long
field_scale
(可选)

设置可存储在字段中的小数位数。此参数仅可用于浮点型和双精度数据字段类型。

如果输入表是个人或文件地理数据库,则将忽略字段小数位数值。

Long
field_length
(可选)

要添加的字段的长度。它为字段的每条记录设置最大允许字符数。此选项仅适用于文本或 blob 类型的字段。

Long
field_alias
(可选)

指定给字段名称的备用名称。此名称用于为含义隐晦的的字段名称指定更具描述性的名称。字段别名参数仅适用于地理数据库和 coverage。

String
field_is_nullable
(可选)

不存在关联属性信息的地理要素。它们与零或空字段不同,仅支持地理数据库中的字段。

  • NON_NULLABLE字段不允许空值。
  • NULLABLE字段允许空值。这是默认设置。
Boolean
field_is_required
(可选)

指定要创建的字段是否是表的必填字段;仅支持地理数据库中的字段。

  • NON_REQUIRED字段不是必填字段。这是默认设置。
  • REQUIRED此字段是必填字段。必填字段具有永久性,不能删除。
Boolean
field_domain
(可选)

用于约束地理数据库中的表、要素类或子类型的任何特定属性的允许值。必须指定现有属性域的名称才能将其应用于字段。

String

代码实例

添加字段 (AddField) 示例(Python 窗口)

以下 Python 窗口脚本演示了如何在即时模式下使用 AddField 工具。

import arcpy
from arcpy import env
env.workspace = "C:/data/airport.gdb"
arcpy.AddField_management("schools", "ref_ID", "LONG", 9, "", "", "refcode", "NULLABLE", "REQUIRED")
添加字段 (AddField) 示例 2(独立脚本)

以下独立脚本演示了如何使用 AddField 工具。

# Name: AddField_Example2.py
# Description: Add a pair of new fields to a table
 
# Import system modules
import arcpy
from arcpy import env
 
# Set environment settings
env.workspace = "C:/data/airport.gdb"
 
# Set local variables
inFeatures = "schools"
fieldName1 = "ref_ID"
fieldPrecision = 9
fieldAlias = "refcode"
fieldName2 = "status"
fieldLength = 10
 
# Execute AddField twice for two new fields
arcpy.AddField_management(inFeatures, fieldName1, "LONG", fieldPrecision, "", "",
                          fieldAlias, "NULLABLE")
arcpy.AddField_management(inFeatures, fieldName2, "TEXT", "", "", fieldLength)

环境

相关主题

许可信息

ArcGIS for Desktop Basic:是
ArcGIS for Desktop Standard:是
ArcGIS for Desktop Advanced:是
9/15/2013