ExtendTable

描述

基于公共属性字段将 NumPy 结构数组的内容连接到表。输入表将被更新,从而包含连接表中的字段。

讨论

in_array 中的记录与 in_table 中的记录相匹配。将在 table_match_fieldarray_match_table 值相等时进行匹配。该连接是永久性的。

NumPy 是 Python 中用于进行科学计算的基础包,其包括支持功能强大的 N 维数组对象。有关详细信息,请参阅在 ArcGIS 中使用 NumPy

语法

ExtendTable (in_table, table_match_field, in_array, array_match_field, {append_only})
参数说明数据类型
in_table

将附加 NumPy 数组中字段的目标表格。

String
table_match_field

in_table 中的字段名称,用作数组的匹配项。

String
in_array

要附加至 in_table 的 NumPy 结构数组。

匹配 in_array 字段值必须唯一。

NumPyArray
array_match_field

in_array 中用于匹配的字段名称。

String
append_only

控制字段在现有表格中的添加方式或更新方式。

如果为真,则字段仅附加到现有表格。如果 in_table 中已存在任意 NumPy 字段名称,则 ExtendTable 将失败。

如果为假,当现有字段与 NumPy 数组中的字段共享通用字段名时,将更新现有字段。所有匹配字段的字段类型均必须兼容。例如,NumPy 字符串字段无法附加至数值字段。

(默认值为 True)

Boolean

代码示例

使用 ExtendTable 将 NumPy 数组连接至现有表。

import arcpy
import numpy
# numpy array
#
array = numpy.array([(1, 'a', 1111.0), (2, 'b', 2222.22)],
                    numpy.dtype([('idfield',numpy.int32),
                                 ('textfield', '|S256'),
                                 ('doublefield','<f8')]))
# Append the array to an existing table
#
arcpy.da.ExtendTable("c:/data/base.gdb/current_table", 
                     "tableid", 
                     array, 
                     "idfield")

相关主题