フィールドの追加 (複数) (Add Fields (multiple)) (データ管理)—ArcGIS Pro

サマリー

新しいフィールドをテーブル、フィーチャクラス、またはラスターに追加します。

使用法

注意:

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

シェープファイルテーブルと dBASE テーブルでは、フィールドタイプに文字が指定されると、各レコードに空白が挿入されます。フィールドタイプに数値項目が指定されると、各レコードにゼロが挿入されます。
[フィールドプロパティ] パラメーターで指定したフィールドには、次のデフォルトプロパティがあります。
- [NULL 値を許可] プロパティは true になります。
- [編集可能] プロパティは true になります。
- [必須] プロパティは false になります。
- [精度] および [スケール] プロパティは、フィールドタイプとデータソースのデフォルト値によって設定されます。
[フィールドプロパティ] および [テンプレートテーブル] パラメーターを使用して、フィールドを入力に追加できます。両方のパラメーターに値を指定した場合は、両方のパラメーターからフィールドが追加されます。
[フィールドプロパティ] パラメーターの [フィールドの長さ] オプションは、タイプがテキストのフィールドにのみ適用できます。
シェープファイルではフィールドのエイリアスがサポートされないため、シェープファイルにフィールドのエイリアスを追加することはできません。
タイプがラスターのフィールドには、ラスター画像を属性として格納できます。ラスター画像は、ジオデータベースの内部またはジオデータベースとともに保存されます。フィーチャの説明に画像が最適である場合に便利です。ラスタータイプのフィールドには精度、スケール、長さを設定できません。

パラメーター

ラベル	説明	データタイプ
入力テーブル	フィールドを追加する入力テーブル。フィールドは既存の入力テーブルに追加され、新しい出力テーブルは作成されません。フィールドを追加できる対象は、ジオデータベースのフィーチャクラス、シェープファイル、カバレッジ、スタンドアロンテーブル、ラスターカタログ、属性テーブルがあるラスター、およびレイヤーです。	Table View; Raster Layer; Mosaic Layer
フィールドプロパティ (オプション)	入力テーブルに追加するフィールドとフィールドプロパティ。フィールド名 - 入力テーブルに追加するフィールドの名前。フィールドタイプ - 新しいフィールドのタイプ。 [フィールドのエイリアス] - フィールドの別名。曖昧なフィールド名を説明するために使用されます。この値はジオデータベースにのみ適用されます。フィールドの長さ - 追加するフィールドの長さ。この値は、フィールドの各レコードに許容される文字の最大数を設定します。このオプションは、タイプがテキストのフィールドにのみ適用されます。デフォルトの長さは 255 です。デフォルト値 - フィールドのデフォルト値。フィールドドメイン - 入力テーブルに割り当てられるジオデータベースドメイン。使用できるフィールドタイプは次のとおりです。 [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 (高精度)] - フィールドタイプが High Precisionになります。高精度の日付フィールドでは、ミリ秒の日付と時刻の値がサポートされます。 [Date only] - フィールドタイプが Date Only になります。 Date Only フィールドには、日付値を指定できます。時間値は指定できません。 [Time 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 imagery] - フィールドタイプがラスターになります。ラスターフィールドでは、ラスターデータをジオデータベースの内部またはジオデータベースと一緒に格納できます。 ArcGIS ソフトウェアでサポートされているラスターデータセット形式はすべて格納できますが、小さい画像のみを使用することをお勧めします。	Value Table
テンプレートテーブル (オプション)	追加する属性フィールドを定義するためのテンプレートとして使用されるフィーチャクラスまたはテーブル。 [フィールドプロパティ] パラメーターで指定したフィールドに加えて、このパラメーターによって指定した入力のフィールドが [入力テーブル] の値に追加されます。	Table View

派生した出力

ラベル	説明	データタイプ
更新された入力テーブル	更新された入力テーブル。	Table View; Raster Layer; Mosaic Layer

arcpy.management.AddFields(in_table, {field_description}, {template})

名前	説明	データタイプ
in_table	フィールドを追加する入力テーブル。フィールドは既存の入力テーブルに追加され、新しい出力テーブルは作成されません。フィールドを追加できる対象は、ジオデータベースのフィーチャクラス、シェープファイル、カバレッジ、スタンドアロンテーブル、ラスターカタログ、属性テーブルがあるラスター、およびレイヤーです。	Table View; Raster Layer; Mosaic Layer
field_description [[Field Name, Field Type, {Field Alias}, {Field Length}, {Default Value}, {Field Domain}],...] (オプション)	入力テーブルに追加するフィールドとフィールドプロパティ。 Field Name - 入力テーブルに追加するフィールドの名前。 Field Type - 新しいフィールドのタイプ。 Field Alias - フィールドの代替名。曖昧なフィールド名を説明するために使用されます。この値はジオデータベースにのみ適用されます。 Field Length - 追加するフィールドの長さ。この値は、フィールドの各レコードに許容される文字の最大数を設定します。このオプションは、タイプがテキストのフィールドにのみ適用されます。デフォルトの長さは 255 です。 Default Value - フィールドのデフォルト値。 Field Domain - フィールドに割り当てられるジオデータベースドメイン。使用できるフィールドタイプは次のとおりです。 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 になります。 Time only フィールドには、時間値を指定できます。日付値は指定できません。 TIMESTAMPOFFSET - フィールドタイプが Timestamp Offset になります。 Timestamp Offset フィールドは、日付、時刻、および UTC 値からのオフセットを指定できます。 BLOB - フィールドタイプが BLOB になります。 BLOB フィールドには、長いバイナリ数値列として格納されるデータを指定できます。 BLOB フィールドにアイテムを読み込む、または BLOB フィールドの内容を参照するには、カスタムローダー、カスタムビューアー、またはサードパーティアプリケーションが必要です。 GUID - フィールドタイプが GUID になります。 GUID フィールドには、中括弧 ({}) で囲まれた 36 文字のレジストリ形式の文字列が格納されます。 RASTER - フィールドタイプが Raster になります。ラスターフィールドでは、ラスターデータをジオデータベースの内部またはジオデータベースと一緒に格納できます。 ArcGIS ソフトウェアでサポートされているラスターデータセット形式はすべて格納できますが、小さい画像のみを使用することをお勧めします。オプションの値を指定してこのパラメーターを使用する場合、None を空のプレースホルダーとして使用します。	Value Table
template [template,...] (オプション)	追加する属性フィールドを定義するためのテンプレートとして使用されるフィーチャクラスまたはテーブル。 field_description パラメーターで指定したフィールドに加えて、このパラメーターによって指定した入力のフィールドが in_table の値に追加されます。	Table View

派生した出力

名前	説明	データタイプ
out_table	更新された入力テーブル。	Table View; Raster Layer; Mosaic Layer

コードのサンプル

AddFields の例 (Python ウィンドウ)

次の 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: Yes
Standard: Yes
Advanced: Yes

サマリー

使用法

注意:

パラメーター

派生した出力

派生した出力

コードのサンプル

環境

ライセンス情報

関連トピック

このトピックの内容