概要
新しいフィールドをテーブル、フィーチャクラス、またはラスターに追加します。
使用法
シェープファイル テーブルと dBASE テーブルでは、フィールド タイプに文字が指定されると、各レコードに空白が挿入されます。フィールド タイプに数値項目が指定されると、各レコードにゼロが挿入されます。
[フィールドの追加 (複数) (Add Fields)] ツールには、次のデフォルトのフィールド プロパティがあります。
- 追加されたフィールドの [NULL を許可] プロパティは true になります。
- 追加されたフィールドの [編集可能] プロパティは true になります。
- 追加されたフィールドの [必須] プロパティは false になります。
- 精度とスケールは、フィールド タイプとデータ ソースのデフォルト値によって設定されます。
フィールドの長さは、タイプがテキストのフィールドに対してのみ適用されます。
シェープファイルではフィールドのエイリアスがサポートされないため、シェープファイルにフィールドのエイリアスを追加することはできません。
タイプがラスターのフィールドには、ラスター画像を属性として格納できます。ラスター画像は、ジオデータベースの内部またはジオデータベースとともに保存されます。フィーチャの説明にピクチャが最適である場合に便利です。ラスター タイプのフィールドには精度、スケール、長さを設定できません。
構文
AddFields(in_table, field_description)
パラメーター | 説明 | データ タイプ |
in_table | フィールドを追加する入力テーブル。フィールドは既存の入力テーブルに追加され、新しい出力テーブルは作成されません。 フィールドを追加できる対象は、ジオデータベースのフィーチャクラス、シェープファイル、カバレッジ、スタンドアロン テーブル、ラスター カタログ、属性テーブルがあるラスター、およびレイヤーです。 | Table View; Raster Layer; Mosaic Layer |
field_description [[Field Name, Field Type, {Field Alias}, {Field Length}, {Default Value} {Field Domain}],...] | 入力テーブルに追加するフィールドとフィールド プロパティ。
使用できるフィールド タイプは次のとおりです。
オプションのパラメーターを含む field_description パラメーターでは、None を空のプレース ホルダーとして使用します。 | Value Table |
派生した出力
名前 | 説明 | データ タイプ |
out_table | 更新された入力テーブル。 | テーブル ビュー; ラスター レイヤー; モザイク レイヤー |
コードのサンプル
次の 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', '']])
ライセンス情報
- Basic: はい
- Standard: はい
- Advanced: はい