フィールドの追加（Add Field） (データ管理)

ライセンス レベル:BasicStandardAdvanced

サマリ

新しいフィールドを単独のテーブル、あるいはフィーチャクラス、フィーチャ レイヤ、ラスタ カタログ、属性テーブルのあるラスタなどのテーブルに追加します。

使用法

構文

AddField_management (in_table, field_name, field_type, {field_precision}, {field_scale}, {field_length}, {field_alias}, {field_is_nullable}, {field_is_required}, {field_domain})
パラメータ説明データ タイプ
in_table

指定したフィールドを追加する対象となる入力テーブル。フィールドは既存の入力テーブルに追加され、新しい出力テーブルは作成されません。

フィールドを追加できる対象は、ジオデータベース（ArcSDE、ファイル、パーソナル）のフィーチャクラス、カバレッジ、シェープファイル、ラスタ カタログ、スタンドアロン テーブル、属性テーブルがあるラスタ、およびレイヤです。

Mosaic Layer; Raster Catalog Layer; Raster Layer; Table View
field_name

入力テーブルに追加するフィールドの名前

String
field_type

新しいフィールドの作成に使用されるフィールドのタイプ。

  • TEXT —名前または他のテキスト品質
  • FLOAT —小数値を含む特定の範囲内の数値
  • DOUBLE —小数値を含む特定の範囲内の数値
  • SHORT —小数値を含まない特定の範囲内の数値、コード値
  • LONG —小数値を含まない特定の範囲内の数値
  • DATE —日付や時刻
  • BLOB —画像などのマルチメディア
  • RASTER —ラスタ イメージ
  • GUID —GUID 値
String
field_precision
(オプション)

フィールドに格納できる桁数を指定します。小数点以下であるかどうかにかかわらず、すべての桁が対象になります。

入力テーブルがパーソナル ジオデータベースまたはファイル ジオデータベースの場合、フィールドの精度の値は無視されます。

Long
field_scale
(オプション)

フィールドに格納できる小数点以下の桁数を設定します。このパラメータは、Float タイプと Double タイプのデータ フィールドのみで使用します。

入力テーブルがパーソナル ジオデータベースまたはファイル ジオデータベースの場合、フィールドのスケールの値は無視されます。

Long
field_length
(オプション)

追加するフィールドの長さ。この値は、フィールドの各レコードに許容される文字の最大数を設定します。このオプションは、タイプがテキストまたはブロブのフィールドに対してのみ適用されます。

Long
field_alias
(オプション)

フィールド名に割り当てる別名。この名前は、あいまいなフィールド名にわかりやすい名前を付けるために使用します。フィールド エイリアスのパラメータは、ジオデータベースとカバレッジに対してのみ適用されます。

String
field_is_nullable
(オプション)

関連付けられている属性情報がない状態の地理フィーチャ。ゼロや空のフィールドとは異なるもので、ジオデータベースのフィールドのみでサポートされます。

  • NON_NULLABLE —フィールドで Null 値を使用できません。
  • NULLABLE —フィールドで Null 値を使用できます。これがデフォルトです。
Boolean
field_is_required
(オプション)

作成するフィールドが、テーブルにとって必須のフィールドであるかどうかを指定します。ジオデータベースのフィールドのみでサポートされます。

  • NON_REQUIRED —フィールドは必須フィールドではありません。これがデフォルトです。
  • REQUIRED —フィールドは必須フィールドです。必須フィールドは永続的で、削除することはできません。
Boolean
field_domain
(オプション)

ジオデータベース内のテーブル、フィーチャクラス、またはサブタイプの特定の属性に許可される値を制約するために使用します。フィールドに適用するには、既存のドメインの名前を指定する必要があります。

String

コードのサンプル

AddField（フィールドの追加）の例（Python ウィンドウ）

次の Python ウィンドウ スクリプトで、AddField（フィールドの追加）ツールをイミディエイト モードで使用する方法を示します。

import arcpy
from arcpy import env
env.workspace = "C:/data/airport.gdb"
arcpy.AddField_management("schools", "ref_ID", "LONG", 9, "", "", "refcode", "NULLABLE", "REQUIRED")
AddField（フィールドの追加）の例 2（スタンドアロン スクリプト）

次のスタンドアロン スクリプトで、AddField（フィールドの追加）ツールを使用する方法を示します。

# Name: AddField_Example2.py
# Description: Add a pair of new fields to a table
 
# Import system modules
import arcpy
from arcpy import env
 
# Set environment settings
env.workspace = "C:/data/airport.gdb"
 
# Set local variables
inFeatures = "schools"
fieldName1 = "ref_ID"
fieldPrecision = 9
fieldAlias = "refcode"
fieldName2 = "status"
fieldLength = 10
 
# Execute AddField twice for two new fields
arcpy.AddField_management(inFeatures, fieldName1, "LONG", fieldPrecision, "", "",
                          fieldAlias, "NULLABLE")
arcpy.AddField_management(inFeatures, fieldName2, "TEXT", "", "", fieldLength)

環境

関連トピック

フィールド ツールセットの概要

ライセンス情報

ArcGIS for Desktop Basic: ○
ArcGIS for Desktop Standard: ○
ArcGIS for Desktop Advanced: ○
Copyright © 1995-2013 Esri. All rights reserved.
9/14/2013