ExtendTable

サマリー

共通の属性フィールドに基づいて、NumPy 構造化配列の内容をテーブルに結合します。 入力テーブルが更新され、結合テーブル内のフィールドが格納されます。

説明

in_array フィールドのレコードが in_table のレコードに照合されます。 table_match_field フィールドと array_match_table フィールドの値が等しい場合に一致したと見なされます。 結合は永続的です。

NumPy is a fundamental package for scientific computing in Python, including support for a powerful N-dimensional array object. For more information, see Working with NumPy in ArcGIS.

構文

ExtendTable (in_table, table_match_field, in_array, array_match_field, {append_only})

パラメーター	説明	データ タイプ
in_table	The target table to which fields from a NumPy array will be appended.	String
table_match_field	A field name from in_table to use as a match to the array.	String
in_array	A NumPy structured array to be appended to in_table. Matching in_array field values must be unique.	NumPyArray
array_match_field	A field name from in_array to use to match.	String
append_only	Controls how fields are added or updated in the existing table. If True, fields will be appended to the existing table only. If any of the NumPy field names exist already in the in_table, ExtendTable will fail. If False, existing fields will be updated if they share a common field name with fields in the NumPy array. Any matching fields must have a compatible field type. For example, a NumPy string field cannot be appended into a numeric field. (デフォルト値は次のとおりです True)	Boolean

コードのサンプル

ExtendTable の例

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")