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

摘要

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

使用情况

    警告:

    此工具会修改输入数据。 有关详细信息以及避免数据被意外更改的策略,请参阅修改或更新输入数据的工具

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

  • 字段属性参数指定的字段将具有以下默认属性:

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

  • 可以使用字段属性模板表参数将字段添加到输入中。 如果提供了两个参数的值,则将根据两个参数添加字段。

  • 字段属性参数的字段长度选项仅适用于文本类型的字段。

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

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

参数

标注说明数据类型
输入表

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

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

Table View; Raster Layer; Mosaic Layer
字段属性
(可选)

将添加到输入表的字段及其属性。

  • 字段名称 - 将添加到输入表的字段的名称。
  • 字段类型 - 新字段的类型。
  • 字段别名 - 字段的备用名称。 此名称用于描述含义隐晦的字段名称。 此值仅适用于地理数据库。
  • 字段长度 - 要添加的字段的长度。 它为字段的每条记录设置最大允许字符数。 此选项仅适用于文本类型的字段。 默认长度为 255。
  • 默认值 - 字段的默认值。
  • 字段域 - 将分配到字段的地理数据库域。

可用字段类型如下:

  • 短整型(16 位整数)- 字段类型为短整型。 短整形字段支持介于 -32,768 和 32,767 之间的整数。
  • 长整型(32 位整数)- 此字段类型将为长整型。 长整型字段支持介于 2,147,483,648 和 2,147,483,647 之间的整数。
  • 大整数(64 位整数)- 字段类型将为大整数。 大整数字段支持 -(253) 和 253 之间的整数。
  • 浮点(32 位浮点型)- 字段类型为浮点型。 浮点型字段支持介于 -3.4E38 和 1.2E38 之间的小数。
  • 双精度(64 位浮点型)- 字段类型为双精度。 双精度字段支持介于 -2.2E308 和 1.8E308 之间的小数。
  • 文本- 字段类型为文本。 文本字段支持字符串。
  • 日期 - 字段类型为日期。 日期字段支持日期和时间值。
  • 日期(高精度)- 日期字段类型将为高精度。 高精度日期字段支持毫秒时间的日期和时间值。
  • 仅日期 - 此字段类型将为仅日期。 仅日期字段支持不带时间值的日期值。
  • 仅时间 - 此字段类型将为仅时间。 仅时间字段支持不带日期值的时间值。
  • 时间戳偏移 - 此字段类型将为时间戳偏移。 时间戳偏移字段支持日期、时间和相对于 UTC 值的偏移。
  • Blob(二进制数据)- 字段类型为 BLOB。 BLOB 字段支持将数据存储为长度较长的一系列二进制数。 您需要一个自定义的加载器、查看器或第三方应用程序将这些项加载到 BLOB 字段中或者查看 BLOB 字段的内容。
  • GUID(全局唯一标识符)- 字段类型为 GUID。 GUID 字段可存储注册表样式的字符串,该字符串包含用大括号括起来的 36 个字符。
  • 栅格影像 - 字段类型为栅格。 栅格字段格可在地理数据库中存储栅格数据或者将该数据与地理数据库一同存储。 可以存储 ArcGIS 软件支持的所有栅格数据集格式,但建议您仅使用小影像。
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}],...]
(可选)

将添加到输入表的字段及其属性。

  • 字段名称 - 将添加到输入表的字段的名称。
  • 字段类型 - 新字段的类型。
  • 字段别名 - 字段的备用名称。 此名称用于描述含义隐晦的字段名称。 此值仅适用于地理数据库。
  • 字段长度 - 要添加的字段的长度。 它为字段的每条记录设置最大允许字符数。 此选项仅适用于文本类型的字段。 默认长度为 255。
  • 默认值 - 字段的默认值。
  • 字段域 - 将分配到字段的地理数据库域。

可用字段类型如下:

  • SHORT - 字段类型为短整型。 短整形字段支持介于 -32,768 和 32,767 之间的整数。
  • LONG - 字段类型为长整型。 长整型字段支持介于 2,147,483,648 和 2,147,483,647 之间的整数。
  • BIGINTEGER - 此字段类型将为大整数。 大整数字段支持 -(253) 和 253 之间的整数。
  • FLOAT - 字段类型为浮点型。 浮点型字段支持介于 -3.4E38 和 1.2E38 之间的小数。
  • DOUBLE - 字段类型为双精度。 双精度字段支持介于 -2.2E308 和 1.8E308 之间的小数。
  • TEXT - 字段类型为文本。 文本字段支持字符串。
  • DATE - 字段类型为日期。 日期字段支持日期和时间值。
  • DATEHIGHPRECISION - 日期字段类型将为高精度。 高精度日期字段支持毫秒时间的日期和时间值。
  • DATEONLY - 此字段类型将仅为日期。 仅日期字段支持不带时间值的日期值。
  • TIMEONLY - 此字段类型将仅为时间。 仅时间字段支持不带日期值的时间值。
  • TIMESTAMPOFFSET - 此字段类型将为时间戳偏移。 时间戳偏移字段支持日期、时间和相对于 UTC 值的偏移。
  • BLOB - 字段类型为 BLOB。 BLOB 字段支持将数据存储为长度较长的一系列二进制数。 您需要一个自定义的加载器、查看器或第三方应用程序将这些项加载到 BLOB 字段中或者查看 BLOB 字段的内容。
  • GUID - 字段类型为 GUID。 GUID 字段可存储注册表样式的字符串,该字符串包含用大括号括起来的 36 个字符。
  • RASTER - 字段类型为栅格。 栅格字段格可在地理数据库中存储栅格数据或者将该数据与地理数据库一同存储。 可以存储 ArcGIS 软件支持的所有栅格数据集格式,但建议您仅使用小影像。

在具有可选参数的 field_description 参数中,可使用 None 作为空占位符。

Value Table
template
[template,...]
(可选)

将用作模板以定义要添加的属性字段的要素类或表。

除了 field_description 参数指定的任何字段之外,使用此参数指定的输入中的字段将添加到 in_table 值中。

Table View

派生输出

名称说明数据类型
out_table

已更新的输入表。

Table View; Raster Layer; Mosaic Layer

代码示例

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', '']])

相关主题