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

サマリー

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

使用法

注意:

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

シェープファイルテーブルと dBASE テーブルでは、フィールドタイプに文字が指定されると、各レコードに空白が挿入されます。フィールドタイプに数値項目が指定されると、各レコードにゼロが挿入されます。
[フィールドの長さ] パラメーターは、タイプがテキストのフィールドに対してのみ使用できます。フィールドの長さが指定されない場合、長さ 255 が使用されます。
ジオデータベースでは、フィールドタイプに文字か数字が指定され、[フィールドは NULL 値をサポートします] パラメーターがオンの場合、各レコードに <NULL> が挿入されます。
NULL 値を使用できないフィールドは、空でないジオデータベースのフィーチャクラスまたはテーブルに追加できません。
シェープファイルではフィールドのエイリアスがサポートされないため、シェープファイルにフィールドのエイリアスを追加することはできません。
[フィールドドメイン] パラメーター値には、ジオデータベース内のフィーチャクラスに存在するドメインを使用できます。既存のドメインの名前を指定する必要があります。無効なドメイン名や値を指定してもツールが失敗する原因にはなりませんが、無効な名前や値は無視され、フィールドにドメインは設定されません。
フィールドの精度とスケールは、そのフィールドに格納できるデータの最大精度とサイズを表します。精度はフィールドに格納できる桁数を表し、スケールは小数フィールドの小数点以下の桁数を表します。たとえば、値が 54.234 であれば、スケールは 3 で精度は 5 です。
注意:
フィールドの精度とスケールは、ファイルジオデータベースフィーチャクラスまたはテーブルでサポートされていません。精度またはスケールの値を指定した場合は無視されます。
その他のデータベースタイプの場合、特定の精度とスケールに適切なフィールドタイプを選択するには、次のガイドラインに従ってください。
- 小数フィールドの作成で精度とスケールを指定すると、精度が 6 よりも大きい場合は Double タイプ、6 以下の場合は Float タイプになります。
- スケールが 0 のフィールドでは、long または short integer フィールドタイプを使用します。 long integer フィールドの作成では、精度を 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 フィールドは、-(2⁵³) ～ 2⁵³ の範囲の整数をサポートします。 Float (32 ビット浮動小数点)—フィールドタイプは Float です。 Float フィールドは、-3.4E38 ～ 1.2E38 の範囲の有理数をサポートします。 Double (64 ビット浮動小数点)—フィールドタイプは Double です。 Double フィールドは、-2.2E308 ～ 1.8E308 の範囲の有理数をサポートします。 Text—フィールドタイプは Text です。 Text フィールドは文字列をサポートします。 Date—フィールドタイプは Date です。 Date フィールドは、日付値と時間値をサポートします。 Date (高精度)—このフィールドタイプでは高精度の日付になります。高精度の日付フィールドではミリ秒の日時の値がサポートされます。 Date only—フィールドタイプは 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 文字のレジストリ形式の文字列が格納されます。 Raster—フィールドタイプは Raster です。ラスターフィールドでは、ラスターデータをジオデータベース内またはジオデータベースとともに格納できます。 ArcGIS ソフトウェアでサポートされているラスターデータセット形式はすべて格納できますが、小さい画像のみを使用することをおすすめします。	String
フィールドの全桁数 (オプション)	フィールドに格納できる桁数。小数点以下であるかどうかにかかわらず、すべての桁が対象になります。このパラメーターは数値フィールドタイプにのみ適用されます。入力テーブルがファイルジオデータベースの場合、フィールドの精度の値は無視されます。	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 フィールドは、-(2⁵³) ～ 2⁵³ の範囲の整数をサポートします。 FLOAT—フィールドタイプは Float です。 Float フィールドは、-3.4E38 ～ 1.2E38 の範囲の有理数をサポートします。 DOUBLE—フィールドタイプは Double です。 Double フィールドは、-2.2E308 ～ 1.8E308 の範囲の有理数をサポートします。 TEXT—フィールドタイプは Text です。 Text フィールドは文字列をサポートします。 DATE—フィールドタイプは Date です。 Date フィールドは、日付値と時間値をサポートします。 DATEHIGHPRECISION—このフィールドタイプでは高精度の日付になります。高精度の日付フィールドではミリ秒の日時の値がサポートされます。 DATEONLY—フィールドタイプは date only です。 Date Only フィールドには、日付値を指定できます。時間値は指定できません。 TIMEONLY—フィールドタイプは time only です。時間のみフィールドには、時間値を指定できます。日付値は指定できません。 TIMESTAMPOFFSET—フィールドタイプは Timestamp offset です。 Timestamp offset フィールドは、日付、時刻、および UTC 値からのオフセットを指定できます。 BLOB—フィールドタイプは BLOB です。 BLOB フィールドは、大容量バイナリオブジェクトとして格納されたデータをサポートします。 BLOB フィールドにアイテムを読み込む、または BLOB フィールドの内容を参照するには、カスタムローダー、カスタムビューアー、またはサードパーティアプリケーションが必要です。 GUID—フィールドタイプは GUID です。 GUID フィールドには、中括弧 ({}) で囲まれた 36 文字のレジストリ形式の文字列が格納されます。 RASTER—フィールドタイプは Raster です。ラスターフィールドでは、ラスターデータをジオデータベース内またはジオデータベースとともに格納できます。 ArcGIS ソフトウェアでサポートされているラスターデータセット形式はすべて格納できますが、小さい画像のみを使用することをおすすめします。 Field オブジェクトの type プロパティ値は、[フィールドの追加 (Add Field)] ツールの field_type パラメーターが使用するキーワードとは完全には一致しませんが、すべての Field オブジェクトの type 値をこのパラメーターへの入力として使用できます。フィールドタイプは次のようにマッピングされます: Integer は LONG に、String は TEXT に、SmallInteger は SHORT に。	String
field_precision (オプション)	フィールドに格納できる桁数。小数点以下であるかどうかにかかわらず、すべての桁が対象になります。このパラメーターは数値フィールドタイプにのみ適用されます。入力テーブルがファイルジオデータベースの場合、フィールドの精度の値は無視されます。	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)

環境

現在のワークスペース

ライセンス情報

Basic: Yes
Standard: Yes
Advanced: Yes

サマリー

使用法

注意:

注意:

パラメーター

派生した出力

派生した出力

コードのサンプル

環境

ライセンス情報

関連トピック

このトピックの内容