概要
複数の入力データセットを 1 つの既存のターゲット データセットに追加 (アペンド) します。入力データセットとして、フィーチャクラス、テーブル、シェープファイル、ラスター、アノテーション フィーチャクラス、またはディメンション フィーチャクラスを使用できます。
複数の入力データセットを 1 つの新しい出力データセットに結合するには [マージ (Merge)] ツールを使用します。
図
使用法
このツールは、既存のデータセットに新しいフィーチャ、またはその他のデータを複数のデータセットから追加するときに使用します。このツールは、ポイント フィーチャクラス、ライン フィーチャクラス、ポリゴン フィーチャクラス、テーブル、ラスター、アノテーション フィーチャクラス、ディメンション フィーチャクラスを、同じタイプの既存のデータセットに追加できます。たとえば、複数のテーブルを既存のテーブルに追加したり、複数のラスターを既存のラスター データセットに追加したりすることはできますが、ライン フィーチャクラスをポイント フィーチャクラスに追加することはできません。
[アペンド (Append)] ツールの [フィールド マップ] パラメーターを使用すると、入力データセットの各フィールドの属性情報をターゲット データセットに転送する方法を制御できます。[フィールド マップ] パラメーターを使用できるのは、[スキーマ タイプ] パラメーターで [フィールド マップを使用してスキーマの違いをリコンサイル] が選択されている場合に限ります。
出力データセット内のすべてのフィールドおよびそのフィールドの内容は、[フィールド マップ] を使用して制御できます。
- フィールドの順序を変更するには、フィールド名を選択して、目的の位置にドラッグします。
- 出力フィールドのデフォルトのデータ タイプは、最初に検出した (その名前の) 入力フィールドのデータ タイプと同じになります。データ タイプをいつでも手動で他の任意の有効なデータ タイプに変更できます。
- 使用できるマージ ルールは、最初、最後、結合、合計値、平均値、中央値、最頻値、最小値、最大値、標準偏差、個数です。
- [結合] マージ ルールを使用している場合、スペース、カンマ、ピリオド、ダッシュなど、区切り文字を指定できます。スペースを使用する場合は、入力ボックスの先頭にポインターを置き、Space キーを 1 回押してください。
- 形式オプションを使用すると、テキスト フィールドの開始位置および終了位置を指定できます。
- 1 個しかないデータの標準偏差を計算しないでください。ゼロによる除算が発生するからです。したがって、入力ソースがただ 1 つである場合には、[標準偏差] オプションを使用すべきではありません。
このツールでは、フィーチャがターゲット データセットに追加されるときに、フィーチャのライン分割は行われません。アペンド後にフィーチャが重なった場合でも、入力フィーチャクラスとターゲット フィーチャクラスのすべてのフィーチャがそのまま表示されます。フィーチャ ジオメトリの結合や分割を実行するには、[ユニオン (Union)] ツールを使用します。
[スキーマ タイプ] パラメーターで [入力スキーマはターゲット スキーマと一致] が選択されている場合 (Python では schema_type = "TEST")、フィーチャを追加するには、入力データセットのスキーマ (フィールド定義) がターゲット データセットのスキーマと一致している必要があります。[スキーマ タイプ] で [フィールド マップを使用してスキーマの違いをリコンサイル] 選択した場合 (Python では schema_type = "NO_TEST")、入力データセットのスキーマ (フィールド定義) がターゲット データセットのスキーマと一致している必要はありません。ただし、ターゲット データセットのフィールドと一致しない入力データセットのフィールドは、[フィールド マップ] パラメーターでマッピングが明示的に設定されていない限り、ターゲット データセットにマッピングされません。
入力データセットのデータは、スキーマ (フィールド定義) があらかじめ定義されている既存のターゲット データセットに書き込まれるため、ターゲット データセットでのフィールドの追加や削除は [フィールド マップ] パラメーターで実行できません。
入力フィーチャクラスとターゲット フィーチャクラスの空間参照が一致しない場合、[アペンド (Append)] ツールでは、ターゲット フィーチャクラスで使用されている座標系に入力フィーチャクラスのフィーチャが投影されます。
このツールでは、エッジ マッチが実行されないので、フィーチャのジオメトリに対して調整は行われません。
マップのレイヤーを [入力データセット] パラメーターの値として使用することができます。レイヤーで選択が行われている場合は、選択されているレコード (フィーチャまたはテーブル行) だけが [アペンド (Append)] ツールの処理対象になります。
このツールでは、名前の同じ入力レイヤーを複数使用することはできません。この制限を回避するには、ツール ダイアログ ボックスの参照ボタンを使用して、個々の [入力データセット] 値の絶対パスを入手してください。
[サブタイプ] パラメーターを使用するには、ターゲット データセットにサブタイプ フィールドが定義され、サブタイプ コードが割り当てられている必要があります。[サブタイプ] パラメーターには、ターゲット データセットに追加されるすべての新しいデータにこのサブタイプを割り当てることを示すサブタイプの説明を記述します。
構文
arcpy.management.Append(inputs, target, {schema_type}, {field_mapping}, {subtype}, {expression})| パラメーター | 説明 | データ タイプ |
inputs [inputs,...] | ターゲット データセットに追加するデータを含む入力データセット。入力データセットには、ポイント フィーチャクラス、ライン フィーチャクラス、ポリゴン フィーチャクラス、テーブル、ラスター、アノテーション フィーチャクラス、ディメンション フィーチャクラスを指定することができます。 テーブルとフィーチャクラスは結合できます。フィーチャクラスをテーブルに追加すると、属性は割り当てられますが、フィーチャは削除されてしまいます。テーブルをフィーチャクラスに追加すると、入力テーブルの行に NULL ジオメトリが格納されます。 | Table View; Raster Layer |
target | 入力データセットのデータを追加する既存のデータセット。 | Table View; Raster Layer |
schema_type (オプション) | データを追加するために、入力データセットのフィールドをターゲット データセットのフィールドと一致させる必要があるかどうかを指定します。
| String |
field_mapping (オプション) | 入力データセットの属性フィールドのターゲット データセットへの転送方法またはマッピング方法を制御します。 このパラメーターを使用できるのは、[schema_type] パラメーターが [NO_TEST] に設定されている場合に限ります。 入力データセットは、フィールドがあらかじめ定義されている既存のターゲット データセットに追加されるため、フィールド マップ内のフィールドのタイプを追加、削除、変更することはできません。出力フィールドごとにマージ ルールを設定できます。 マージ ルールによって、複数の入力フィールドの値を単一の出力値にマージまたは結合する方法を指定できます。出力フィールドの値を指定する方法を決定するために使用できるマージ ルールは複数あります。
Python では、このパラメーターを定義するには、FieldMappings クラスを使用します。 | Field Mappings |
subtype (オプション) | ターゲット データセットに追加されるすべての新しいデータに割り当てるサブタイプの説明。 | String |
expression (オプション) | 入力データセットのレコードのサブセットを選択するために使用する SQL 式。複数の入力データセットを指定した場合、これらのデータセットはこの式を使用して評価されます。入力データセットのレコードが式と一致しない場合、そのデータセットのレコードはターゲットに追加されません。 SQL 構文の詳細については、「ArcGIS で使用されるクエリ式への SQL リファレンス」をご参照ください。 | SQL Expression |
派生した出力
| 名前 | 説明 | データ タイプ |
| output | 更新されたターゲット データセット。 | テーブル ビュー; ラスター レイヤー |
コードのサンプル
次の Python ウィンドウ スクリプトは、イミディエイト モードで Append 関数を使用する方法を示しています。
import arcpy
arcpy.env.workspace = "C:/data/"
arcpy.Append_management(["north.shp", "south.shp", "east.shp", "west.shp"],
"wholecity.shp", "TEST")次のスクリプトは、Append 関数の使用方法を示しています。
# Name: Append.py
# Description: Use the Append tool to combine several shapefiles
# Import system modules
import arcpy
import os
# Set environment settings
arcpy.env.workspace = "C:/data"
# Set local variables
outLocation = "C:/Output"
outName = "MA_towns.shp"
schemaType = "NO_TEST"
fieldMappings = ""
subtype = ""
# Process: Create a new empty feature class to append shapefiles to
emptyFC = arcpy.CreateFeatureclass_management(outLocation, outName, "POLYGON",
"amherst.shp")
# All polygon FCs in the workspace are MA town shapefiles, you want to append
# these to the empty FC. The list will resemble ["amherst.shp", "hadley.shp",
# "pelham.shp", "coldspring.shp"]
fcList = arcpy.ListFeatureClasses("", "POLYGON")
# Create FieldMappings object to manage merge output fields
fieldMappings = arcpy.FieldMappings()
# Add the target table to the field mappings class to set the schema
fieldMappings.addTable(emptyFC)
# Add input fields for the town name to TOWNNAME field that matches the
# target dataset since each input dataset has a different field name for
# this info
fldMap = arcpy.FieldMap()
fldMap.addInputField("amherst.shp","TOWNNAME")
fldMap.addInputField("hadley.shp","NAME")
fldMap.addInputField("pelham.shp","TOWN_NAME")
fldMap.addInputField("coldspring.shp","TOWN")
# Set name of new output field "TOWNNAME"
townName = fldMap.outputField
townName.name, townName.aliasName, townName.type = "TOWNNAME", "TOWNNAME", "TEXT"
fldMap.outputField = townName
# Add output field to field mappings object
fieldMappings.addFieldMap(fldMap)
# Do the same thing for the POPULATION field
fldMap = arcpy.FieldMap()
fldMap.addInputField("amherst.shp","POPULATION")
fldMap.addInputField("hadley.shp","POP")
fldMap.addInputField("pelham.shp","POP_2010")
fldMap.addInputField("coldspring.shp","POP")
# Set name of new output field "POPULATION"
pop = fldMap.outputField
pop.name, pop.aliasName, pop.type = "POPULATION", "POPULATION", "LONG"
fldMap.outputField = pop
# Add output field to field mappings object
fieldMappings.addFieldMap(fldMap)
# Process: Append the feature classes to the empty feature class
arcpy.Append_management(fcList, os.path.join(outLocation, emptyFC), schemaType,
fieldMappings, subtype)環境
- Global ID を維持
[アペンド (Append)] ツールの場合、この環境はエンタープライズ ジオデータベースのデータにのみ適用されるため、一意のインデックス付きの Global ID フィールドを含むデータしか処理されません。Global ID フィールドに一意のインデックスが付いていない場合、このツールは正常に実行されない可能性があります。Global ID フィールドに一意のインデックスを追加するには、[属性インデックスの追加 (Add Attribute Index)] ツールを使用します。
ライセンス情報
- Basic: はい
- Standard: はい
- Advanced: はい