添加字段(多个) (数据管理)

摘要

将新字段添加到表格、要素类或栅格。

使用情况

• 对于 shapefile 和 dBase 表，如果字段类型定义为字符型，则会为每条记录插入空白行。 如果字段类型定义为数值项，则会为每条记录插入零。

• 添加字段工具具有以下默认字段属性：

  • 已添加字段允许空值属性将为 true。
  • 已添加字段可编辑属性将为 true。
  • 已添加字段必填项属性将为 false。
  • 精度和比例由字段类型和数据源默认值设置。

• 字段长度仅适用于文本类型的字段。

• shapefile 不支持字段别名，所以无法将字段别名添加到 shapefile。

• 栅格类型的字段允许将栅格影像包含为属性。 它存储在地理数据库中或与地理数据库一同存储。 当图像是描述要素的最佳途径时，这很有用。 无法为栅格类型的字段设置精度、比例和长度。

参数

对话框

标注	说明	数据类型
输入表	将添加字段的输入表。字段将被添加到现有输入表，并且不会创建新的输出表。 可将字段添加到地理数据库中的要素类、shapefile、coverage、独立表、栅格目录、带属性表的栅格和图层。	Table View; Raster Layer; Mosaic Layer
字段属性	将添加到输入表的字段及其属性。 字段名称 - 将添加到输入表的字段的名称。 字段类型 - 新字段的类型。 字段别名 - 指定给字段名称的备用名称。此名称用于为含义隐晦的字段名称指定更具描述性的名称。字段别名参数仅适用于地理数据库。 字段长度 - 要添加的字段的长度。它为字段的每条记录设置最大允许字符数。此选项仅适用于文本类型的字段；默认长度为 255。 默认值 - 字段的默认值。 字段域 - 将分配到字段的地理数据库域。 可用字段类型如下： TEXT - 任何字符串。 FLOAT - 介于 -3.4E38 和 1.2E38 之间的小数。 DOUBLE - 介于 -2.2E308 和 1.8E308 之间的小数。 SHORT - 介于 -32,768 和 32,767 之间的整数。 LONG - 介于 -2,147,483,648 和 2,147,483,647 之间的整数。 DATE - 日期和/或时间。 BLOB - 长二进制数序列。您需要一个自定义的加载器、查看器或第三方应用程序将这些项加载到 BLOB 字段中或者查看 BLOB 字段的内容。 RASTER - 栅格影像。可以存储 ArcGIS 软件支持的所有栅格数据集格式，但建议您仅使用小影像。 GUID - 全局唯一标识符。	Value Table

派生输出

标注	说明	数据类型
更新的输入表	已更新的输入表。	表视图；栅格图层；镶嵌图层

Python

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}],...]	将添加到输入表的字段及其属性。 字段名称 - 将添加到输入表的字段的名称。 字段类型 - 新字段的类型。 字段别名 - 指定给字段名称的备用名称。此名称用于为含义隐晦的字段名称指定更具描述性的名称。字段别名参数仅适用于地理数据库。 字段长度 - 要添加的字段的长度。它为字段的每条记录设置最大允许字符数。此选项仅适用于文本类型的字段；默认长度为 255。 默认值 - 字段的默认值。 字段域 - 将分配到字段的地理数据库域。 可用字段类型如下： TEXT - 任何字符串。 FLOAT - 介于 -3.4E38 和 1.2E38 之间的小数。 DOUBLE - 介于 -2.2E308 和 1.8E308 之间的小数。 SHORT - 介于 -32,768 和 32,767 之间的整数。 LONG - 介于 -2,147,483,648 和 2,147,483,647 之间的整数。 DATE - 日期和/或时间。 BLOB - 长二进制数序列。您需要一个自定义的加载器、查看器或第三方应用程序将这些项加载到 BLOB 字段中或者查看 BLOB 字段的内容。 RASTER - 栅格影像。可以存储 ArcGIS 软件支持的所有栅格数据集格式，但建议您仅使用小影像。 GUID - 全局唯一标识符。 在具有可选参数的 field_description 参数中，可使用 None 作为空占位符。	Value Table

派生输出

名称	说明	数据类型
out_table	已更新的输入表。	表视图；栅格图层；镶嵌图层

代码示例

AddFields 示例（Python 窗口）

以下 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: 是