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

サマリー

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

使用法

注意:

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

シェープファイルテーブルと 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 フィールドは文字列をサポートします。 Date - フィールドタイプは日付になります。 Date フィールドは、日付値と時間値をサポートします。 [日付のみ] - フィールドタイプは日付のみです。 Date Only フィールドには、日付値を指定できます。時間値は指定できません。 [時間のみ] - フィールドタイプは時間のみです。時間のみフィールドには、時間値を指定できます。日付値は指定できません。 [Timestamp オフセット] - フィールドタイプは Timestamp オフセットです。 Timestamp オフセットフィールドは、日付、時刻、および UTC 値からのオフセットを指定できます。 Blob (バイナリデータ) - フィールドタイプは BLOB になります。 BLOB フィールドは、大容量バイナリオブジェクトとして格納されたデータをサポートします。 BLOB フィールドにアイテムを読み込む、または BLOB フィールドの内容を参照するには、カスタムローダー、カスタムビューアー、またはサードパーティアプリケーションが必要です。 GUID (globally unique identifier) - フィールドタイプは GUID になります。 GUID フィールドには、中括弧 ({}) で囲まれた 36 文字のレジストリ形式の文字列が格納されます。ラスター画像 - フィールドタイプはラスターになります。ラスターフィールドでは、ラスターデータをジオデータベース内またはジオデータベースとともに格納できます。 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}],...] (オプション)	入力テーブルに追加するフィールドとフィールドプロパティ。フィールド名 - 入力テーブルに追加するフィールドの名前。フィールドタイプ - 新しいフィールドのタイプ。フィールドのエイリアス - フィールドの別名。曖昧なフィールド名を説明するために使用されます。この値はジオデータベースにのみ適用されます。フィールドの長さ - 追加するフィールドの長さ。この値は、フィールドの各レコードに許容される文字の最大数を設定します。このオプションは、タイプがテキストのフィールドにのみ適用されます。デフォルトの長さは 255 です。デフォルト値 - フィールドのデフォルト値。フィールドドメイン - 入力テーブルに割り当てられるジオデータベースドメイン。使用できるフィールドタイプは次のとおりです。 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 フィールドは文字列をサポートします。 DATE - フィールドタイプは日付になります。 Date フィールドは、日付値と時間値をサポートします。 DATEONLY - フィールドタイプは日付のみです。 Date Only フィールドには、日付値を指定できます。時間値は指定できません。 TIMEONLY - フィールドタイプは時間のみです。時間のみフィールドには、時間値を指定できます。日付値は指定できません。 TIMESTAMPOFFSET - フィールドタイプは Timestamp オフセットです。 Timestamp オフセットフィールドは、日付、時刻、および UTC 値からのオフセットを指定できます。 BLOB - フィールドタイプは BLOB になります。 BLOB フィールドは、大容量バイナリオブジェクトとして格納されたデータをサポートします。 BLOB フィールドにアイテムを読み込む、または BLOB フィールドの内容を参照するには、カスタムローダー、カスタムビューアー、またはサードパーティアプリケーションが必要です。 GUID - フィールドタイプは GUID になります。 GUID フィールドには、中括弧 ({}) で囲まれた 36 文字のレジストリ形式の文字列が格納されます。 RASTER - フィールドタイプはラスターになります。ラスターフィールドでは、ラスターデータをジオデータベース内またはジオデータベースとともに格納できます。 ArcGIS ソフトウェアでサポートされているラスターデータセット形式はすべて格納できますが、小さい画像のみを使用することをおすすめします。オプションのパラメーターを含む field_description パラメーターでは、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', '']])

環境

現在のワークスペース

このトピックへのフィードバック

サマリー

使用法

注意:

パラメーター

派生した出力

派生した出力

コードのサンプル

環境

このトピックの内容