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

サマリー

新しいフィールドを単独のテーブル、フィーチャクラスまたはフィーチャ レイヤーのテーブル、属性テーブルを持つラスターに追加します。

使用法

    注意:

    このツールを実行すると、入力データが変更されます。 詳細と不要なデータの変更を回避するための方法については、「入力データを変更または更新するツール」をご参照ください。

  • シェープファイル テーブルと dBASE テーブルでは、フィールド タイプに文字が指定されると、各レコードに空白が挿入されます。 フィールド タイプに数値項目が指定されると、各レコードにゼロが挿入されます。

  • [フィールドの長さ] パラメーターは、タイプがテキストのフィールドにのみ使用できます。 フィールドの長さが指定されない場合、長さ 255 が使用されます。

  • ジオデータベースでは、フィールド タイプに文字か数字が指定され、[フィールドは NULL 値をサポート] パラメーターがオンの場合、各レコードに <NULL> が挿入されます。

  • NULL 値を使用できないフィールドは、空でないジオデータベースのフィーチャクラスまたはテーブルに追加できません。

  • シェープファイルではフィールドのエイリアスがサポートされないため、シェープファイルにフィールドのエイリアスを追加することはできません。

  • [フィールド ドメイン] パラメーター値には、ジオデータベース内のフィーチャクラスに存在するドメインを指定できます。 既存のドメインの名前を指定する必要があります。 無効なドメイン名や値を指定してもツールが失敗する原因にはなりませんが、無効な名前や値は無視され、フィールドにドメインは設定されません。

  • フィールドの精度とスケールは、そのフィールドに格納できるデータの最大精度とサイズを表します。 精度はフィールドに格納できる桁数を表し、スケールは小数フィールドの小数点以下の桁数を表します。 たとえば、値が 54.234 であれば、スケールは 3 で精度は 5 です。

    注意:

    フィールドの精度とスケールは、ファイル ジオデータベースのフィーチャクラスまたはテーブルでサポートされていません。 精度またはスケールの値を指定した場合は無視されます。

    他のデータベース タイプの場合、特定の精度とスケールに適切なフィールド タイプを選択するために、次のガイドラインに従ってください。

    • 小数フィールドの作成で精度とスケールを指定すると、精度が 6 よりも大きい場合は Double タイプ、6 以下の場合は Float タイプになります。
    • スケールが 0 のフィールドの場合、Long または Short 整数フィールド タイプになります。 Long 整数フィールドの作成では、精度を 10 以下に指定します。10 よりも大きい値を指定すると、Double タイプの小数フィールドとして作成されます。

    数値フィールド タイプの詳細

  • 必須フィールドは永続的で、削除することはできません。 後で削除できるようにするには、フィールドを不要 (デフォルト) に設定してください。

  • タイプがラスターのフィールドには、ラスター画像を属性として含めることができます。 ラスター画像は、ジオデータベースの内部またはジオデータベースとともに保存されます。 これは、フィーチャを説明する方法として画像が最適である場合に便利です。 ラスター タイプのフィールドには精度、スケール、長さを設定できません。

パラメーター

ラベル説明データ タイプ
入力テーブル

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

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

Mosaic Layer; Raster Layer; Table View
フィールド名

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

String
フィールド タイプ

新しいフィールドのフィールド タイプを指定します。

  • Short (16 ビット整数)フィールド タイプが Short になります。 Short フィールドには、-32,768 ~ 32,767 の整数を指定できます。
  • Long (32 ビット整数)フィールド タイプが Long になります。 Long フィールドには、-2,147,483,648 ~ 2,147,483,647 の整数を指定できます。
  • Big Integer (64 ビット整数)フィールド タイプが Big Integer になります。 Big Integer フィールドには、-(253) ~ 253 の整数を指定できます。
  • Float (32 ビット浮動小数点)フィールド タイプが Float になります。 Float フィールドには、-3.4E38 ~ 1.2E38 の有理数を指定できます。
  • Double (64 ビット浮動小数点)フィールド タイプが Double になります。 Double フィールドには、-2.2E308 ~ 1.8E308 の有理数を指定できます。
  • Textフィールド タイプが Text になります。 Text フィールドには、文字列を指定できます。
  • Dateフィールド タイプが Date になります。 Date フィールドには、日付値と時間値を指定できます。
  • Date Onlyフィールド タイプが日付のみになります。 Date Only フィールドには、日付値を指定できます。時間値は指定できません。
  • Time Onlyフィールド タイプが時間のみになります。 Time Only フィールドには、時間値を指定できます。日付値は指定できません。
  • Timestamp Offsetフィールド タイプが Timestamp Offset になります。 Timestamp Offset フィールドは、日付、時刻、および UTC 値からのオフセットを指定できます。
  • Blob (バイナリ データ)フィールド タイプが BLOB になります。 BLOB フィールドには、長いバイナリ数値列として格納されるデータを指定できます。 BLOB フィールドにアイテムを読み込む、または BLOB フィールドの内容を参照するには、カスタム ローダー、カスタム ビューアー、またはサードパーティ アプリケーションが必要です。
  • GUID (Globally Unique Identifier)フィールド タイプが GUID になります。 GUID フィールドには、中括弧 ({}) で囲まれた 36 文字のレジストリ形式の文字列が格納されます。
  • ラスターフィールド タイプがラスターになります。 ラスター フィールドでは、ラスター データをジオデータベースの内部またはジオデータベースと一緒に格納できます。 ArcGIS ソフトウェアでサポートされているラスター データセット形式はすべて格納できますが、小さい画像のみを使用することをお勧めします。
String
フィールドの全桁数
(オプション)

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

このパラメーターは、Float、Double、Short、または Long タイプのフィールドにのみ使用できます。

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

Long
フィールドの小数点以下桁数
(オプション)

フィールドに格納できる小数点以下の桁数。

このパラメーターは、Float または Double タイプのフィールドにのみ使用できます。

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

Long
フィールドの長さ
(オプション)

フィールドの長さ。 この値は、フィールドの各レコードに許容される文字の最大数を設定します。 フィールドの長さが指定されない場合、長さ 255 が使用されます。

このパラメーターは、テキスト タイプのフィールドにのみ使用できます。

Long
フィールド エイリアス
(オプション)

フィールドの代替名。 この名前は、わかりにくいフィールド名を説明するために使用します。 このパラメーターはジオデータベースにのみ適用されます。

String
フィールドは NULL 値をサポート
(オプション)

このフィールドに NULL 値を含めることができるかどうかを指定します。 NULL 値は、ゼロや空のフィールドとは異なり、ジオデータベースのフィールドのみでサポートされます。

  • オン - フィールドは NULL 値を含むことができます。 これがデフォルトです。
  • オフ - フィールドは NULL 値を含むことができません。
Boolean
フィールドは必須
(オプション)

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

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

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

String

派生した出力

ラベル説明データ タイプ
更新された入力テーブル

更新された入力テーブル。

Table

arcpy.management.AddField(in_table, field_name, field_type, {field_precision}, {field_scale}, {field_length}, {field_alias}, {field_is_nullable}, {field_is_required}, {field_domain})
名前説明データ タイプ
in_table

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

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

Mosaic Layer; Raster Layer; Table View
field_name

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

String
field_type

新しいフィールドのフィールド タイプを指定します。

  • SHORTフィールド タイプが Short になります。 Short フィールドには、-32,768 ~ 32,767 の整数を指定できます。
  • LONGフィールド タイプが Long になります。 Long フィールドには、-2,147,483,648 ~ 2,147,483,647 の整数を指定できます。
  • BIGINTEGERフィールド タイプが Big Integer になります。 Big Integer フィールドには、-(253) ~ 253 の整数を指定できます。
  • FLOATフィールド タイプが Float になります。 Float フィールドには、-3.4E38 ~ 1.2E38 の有理数を指定できます。
  • DOUBLEフィールド タイプが Double になります。 Double フィールドには、-2.2E308 ~ 1.8E308 の有理数を指定できます。
  • TEXTフィールド タイプが Text になります。 Text フィールドには、文字列を指定できます。
  • DATEフィールド タイプが Date になります。 Date フィールドには、日付値と時間値を指定できます。
  • DATEONLYフィールド タイプが日付のみになります。 Date Only フィールドには、日付値を指定できます。時間値は指定できません。
  • TIMEONLYフィールド タイプが時間のみになります。 Time Only フィールドには、時間値を指定できます。日付値は指定できません。
  • TIMESTAMPOFFSETフィールド タイプが Timestamp Offset になります。 Timestamp Offset フィールドは、日付、時刻、および UTC 値からのオフセットを指定できます。
  • BLOBフィールド タイプが BLOB になります。 BLOB フィールドには、長いバイナリ数値列として格納されるデータを指定できます。 BLOB フィールドにアイテムを読み込む、または BLOB フィールドの内容を参照するには、カスタム ローダー、カスタム ビューアー、またはサードパーティ アプリケーションが必要です。
  • GUIDフィールド タイプが GUID になります。 GUID フィールドには、中括弧 ({}) で囲まれた 36 文字のレジストリ形式の文字列が格納されます。
  • RASTERフィールド タイプがラスターになります。 ラスター フィールドでは、ラスター データをジオデータベースの内部またはジオデータベースと一緒に格納できます。 ArcGIS ソフトウェアでサポートされているラスター データセット形式はすべて格納できますが、小さい画像のみを使用することをお勧めします。

Field オブジェクトの type プロパティの値は [フィールドの追加 (Add Field)] ツールの field_type パラメーターで使用されるキーワードに完全には一致しませんが、Field オブジェクトのすべての type の値をこのパラメーターへの入力として使用できます。 Integer から LONGString から TEXT へ、SmallInteger から SHORT のように、さまざまなフィールド タイプがマッピングされます。

String
field_precision
(オプション)

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

このパラメーターは、Float、Double、Short、または Long タイプのフィールドにのみ使用できます。

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

Long
field_scale
(オプション)

フィールドに格納できる小数点以下の桁数。

このパラメーターは、Float または Double タイプのフィールドにのみ使用できます。

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

Long
field_length
(オプション)

フィールドの長さ。 この値は、フィールドの各レコードに許容される文字の最大数を設定します。 フィールドの長さが指定されない場合、長さ 255 が使用されます。

このパラメーターは、テキスト タイプのフィールドにのみ使用できます。

Long
field_alias
(オプション)

フィールドの代替名。 この名前は、わかりにくいフィールド名を説明するために使用します。 このパラメーターはジオデータベースにのみ適用されます。

String
field_is_nullable
(オプション)

このフィールドに NULL 値を含めることができるかどうかを指定します。 NULL 値は、ゼロや空のフィールドとは異なり、ジオデータベースのフィールドのみでサポートされます。

  • NULLABLEフィールドは NULL 値を含むことができます。 これがデフォルトです。
  • NON_NULLABLEフィールドは NULL 値を含むことができません。
Boolean
field_is_required
(オプション)

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

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

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

String

派生した出力

名前説明データ タイプ
out_table

更新された入力テーブル。

Table

コードのサンプル

AddField の例 1 (Python ウィンドウ)

次の Python ウィンドウ スクリプトは、イミディエイト モードで AddField 関数を使用する方法を示しています。

import arcpy
arcpy.env.workspace = "C:/data/airport.gdb"
arcpy.management.AddField("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
 
# Set environment settings
arcpy.env.workspace = "C:/data/airport.gdb"
 
# Set local variables
inFeatures = "schools"
fieldName1 = "ref_ID"
fieldPrecision = 9
fieldAlias = "refcode"
fieldName2 = "status"
fieldLength = 10

# Run AddField twice for two new fields
arcpy.management.AddField(inFeatures, fieldName1, "LONG", fieldPrecision,
                          field_alias=fieldAlias, field_is_nullable="NULLABLE")

arcpy.management.AddField(inFeatures, fieldName2, "TEXT", 
                          field_length=fieldLength)