アペンド(Append) (データ管理)

ライセンス レベル:BasicStandardAdvanced

サマリ

複数の入力データセットを 1 つの既存のターゲット データセットに追加(アペンド)します。入力データセットには、ポイント フィーチャクラス、ライン フィーチャクラス、ポリゴン フィーチャクラス、テーブル、ラスタ、ラスタ カタログ、アノテーション フィーチャクラス、ディメンション フィーチャクラスを指定することができます。

複数の入力データセットを 1 つの新しい出力データセットに結合するには [マージ(Merge)] ツールを使用します。

Append illustration

使用法

構文

Append_management (inputs, target, {schema_type}, {field_mapping}, {subtype})
パラメータ説明データ タイプ
inputs
[inputs,...]

ターゲット データセットに追加するデータが含まれている入力データセット。入力データセットには、ポイント フィーチャクラス、ライン フィーチャクラス、ポリゴン フィーチャクラス、テーブル、ラスタ、ラスタ カタログ、アノテーション フィーチャクラス、ディメンション フィーチャクラスを指定することができます。入力データセットのそれぞれがターゲット データセットのデータ タイプに一致する必要があります。

Table View; Raster Layer
target

入力データセットのデータを追加する対象となる既存のデータセット。入力データセットのそれぞれがターゲット データセットのデータ タイプに一致する必要があります。

Table View; Raster Layer
schema_type
(オプション)

データを追加するために、入力データセットのスキーマ(フィールド定義)をターゲット データセットのスキーマに一致させる必要があるかどうかを指定します。

  • TEST入力データセットのスキーマ(フィールド定義)はターゲット データセットのスキーマに一致する必要があります。スキーマが一致しない場合はエラーが返されます。
  • NO_TEST入力データセットのスキーマ(フィールド定義)がターゲット データセットのスキーマに一致する必要はありません。ターゲット データセットのフィールドに一致しない入力データセットのフィールドはすべて、[フィールド マップ] コントロールでマッピングが明示的に設定されていない限り、ターゲット データセットにマッピングされません。
String
field_mapping
(オプション)

入力データセットのフィールドに含まれている属性情報をターゲット データセットに転送する方法を制御します。このパラメータは、[スキーマ タイプ] が [NO_TEST] に指定されている場合のみ使用できます。

入力データセットのデータは、スキーマ(フィールド定義)があらかじめ定義されている既存のターゲット データセットに追加されるため、ターゲット データセットに対するフィールドの追加または削除は行えません。

マージ ルールによって、複数の入力フィールドの値を単一の出力値にマージする方法を指定できます。使用できるマージ ルールを以下に挙げます。

  • First - 最初の入力フィールドの値を使用して、出力フィールドを設定します。
  • Last - 最後の入力フィールドの値を使用して、出力フィールドを設定します。
  • Join - すべての入力フィールドの値を結合し、この値を使用して出力フィールドを設定します。
  • Sum - すべての入力フィールドの値の合計を計算します。
  • Mean - すべての入力フィールドの値の平均を計算します。
  • Median - 中央値を計算します。
  • Mode - 最頻値を使用します。
  • Min - すべての入力フィールドの値のうちの最小値を使用します。
  • Max - すべての入力フィールドの値のうちの最大値を使用します。
  • Standard deviation - すべての入力フィールドの値に、標準偏差の分類法を使用します。
  • Count - 計算に含まれるレコード数を検出します。

Field Mapping
subtype
(オプション)

このサブタイプをターゲット データセットに追加されるすべての新しいデータに割り当てることを示すサブタイプの説明

String

コードのサンプル

Append(アペンド)の例 1(Python ウィンドウ)

次の Python ウィンドウ スクリプトで、Append(アペンド)ツールをイミディエイト モードで使用する方法を示します。

import arcpy
arcpy.env.workspace = "C:/data/"
arcpy.Append_management(["north.shp", "south.shp", "east.shp", "west.shp"], "wholecity.shp", "TEST","","")
Append(アペンド)の例 2(スタンドアロン Python スクリプト)

次のスクリプトで、Append(アペンド)ツールを使用する方法を示します。

# Name: Append.py
# Description: Use the Append tool to combine several shapefiles


# import system modules 
import arcpy, os
from arcpy import env

# Set environment settings
env.workspace = "C:/data"

# Set local variables
outLocation = "C:/Output"
emptyFC = "MA_towns.shp"
schemaType = "NO_TEST"
fieldMappings = ""
subtype = ""

try:
    # Process:  Create a new empty feature class to append shapefiles into
    arcpy.CreateFeatureclass_management(outLocation, emptyFC, "POLYGON", "amherst.shp")

    # All polygon FCs in the workspace are MA town shapefiles, we want to append these to the empty FC
    fcList = arcpy.ListFeatureClasses("","POLYGON")
    # list will resemble ["amherst.shp", "hadley.shp", "pelham.shp", "coldspring.shp"] 

    # Process: Append the feature classes into the empty feature class
    arcpy.Append_management(fcList, outLocation + os.sep + emptyFC, schemaType, fieldMappings, subtype)

except:
    # If an error occurred while running a tool print the messages
    print arcpy.GetMessages()

環境

関連トピック

ライセンス情報

ArcGIS for Desktop Basic: ○
ArcGIS for Desktop Standard: ○
ArcGIS for Desktop Advanced: ○
9/14/2013