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

サマリー

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

使用法

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

  • [フィールドの追加 (複数) (Add Fields)] ツールには、次のデフォルトのフィールド プロパティがあります。

    • 追加されたフィールドの [NULL を許可] プロパティは true になります。
    • 追加されたフィールドの [編集可能] プロパティは true になります。
    • 追加されたフィールドの [必須] プロパティは false になります。
    • 精度とスケールは、フィールド タイプとデータ ソースのデフォルト値によって設定されます。

  • フィールドの長さは、タイプがテキストのフィールドに対してのみ適用されます。

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

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

パラメーター

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

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

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

Table View; Raster Layer; Mosaic Layer
フィールド プロパティ

入力テーブルに追加するフィールドとフィールド プロパティ。

  • フィールド名 - 入力テーブルに追加するフィールドの名前。
  • フィールド タイプ - 新しいフィールドのタイプ。
  • フィールドのエイリアス - フィールド名に割り当てる別名。あいまいなフィールド名にわかりやすい名前を付けるために使用します。[フィールドのエイリアス] のパラメーターは、ジオデータベースに対してのみ適用されます。
  • フィールドの長さ - 追加するフィールドの長さ。この値は、フィールドの各レコードに許容される文字の最大数を設定します。このオプションは、タイプがテキストのフィールドに対してのみ適用されます。デフォルトの長さは 255 です。
  • デフォルト値 - フィールドのデフォルト値。
  • フィールド ドメイン - 入力テーブルに割り当てられるジオデータベース ドメイン。

使用できるフィールド タイプは次のとおりです。

  • Text - 任意の文字列。
  • Float - -3.4E38 ~ 1.2E38 の範囲の有理数。
  • Double - -2.2E308 ~ 1.8E308 の範囲の有理数。
  • Short - -32,768〜32,767 の範囲の整数。
  • Long - -2,147,483,648〜2,147,483,647 の範囲の整数。
  • Date - 日付と時刻。
  • BLOB - 大容量バイナリ オブジェクト。BLOB フィールドにアイテムを読み込む、または BLOB フィールドの内容を参照するには、カスタム ローダー、カスタム ビューアー、またはサードパーティ アプリケーションが必要です。
  • Raster - ラスター イメージ。ArcGIS ソフトウェアでサポートされているラスター データセット形式はすべて格納できますが、小さい画像のみを使用することをお勧めします。
  • GUID - GUID (Globally Unique Identifier)
Value Table

派生した出力

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

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

テーブル ビュー; ラスター レイヤー; モザイク レイヤー

arcpy.management.AddFields(in_table, field_description)
名前説明データ タイプ
in_table

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

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

Table View; Raster Layer; Mosaic Layer
field_description
[[Field Name, Field Type, {Field Alias}, {Field Length}, {Default Value} {Field Domain}],...]

入力テーブルに追加するフィールドとフィールド プロパティ。

  • フィールド名 - 入力テーブルに追加するフィールドの名前。
  • フィールド タイプ - 新しいフィールドのタイプ。
  • フィールドのエイリアス - フィールド名に割り当てる別名。あいまいなフィールド名にわかりやすい名前を付けるために使用します。[フィールドのエイリアス] のパラメーターは、ジオデータベースに対してのみ適用されます。
  • フィールドの長さ - 追加するフィールドの長さ。この値は、フィールドの各レコードに許容される文字の最大数を設定します。このオプションは、タイプがテキストのフィールドに対してのみ適用されます。デフォルトの長さは 255 です。
  • デフォルト値 - フィールドのデフォルト値。
  • フィールド ドメイン - 入力テーブルに割り当てられるジオデータベース ドメイン。

使用できるフィールド タイプは次のとおりです。

  • Text - 任意の文字列。
  • Float - -3.4E38 ~ 1.2E38 の範囲の有理数。
  • Double - -2.2E308 ~ 1.8E308 の範囲の有理数。
  • Short - -32,768〜32,767 の範囲の整数。
  • Long - -2,147,483,648〜2,147,483,647 の範囲の整数。
  • Date - 日付と時刻。
  • BLOB - 大容量バイナリ オブジェクト。BLOB フィールドにアイテムを読み込む、または BLOB フィールドの内容を参照するには、カスタム ローダー、カスタム ビューアー、またはサードパーティ アプリケーションが必要です。
  • Raster - ラスター イメージ。ArcGIS ソフトウェアでサポートされているラスター データセット形式はすべて格納できますが、小さい画像のみを使用することをお勧めします。
  • GUID - GUID (Globally Unique Identifier)

オプションのパラメーターを含む field_description パラメーターでは、None を空のプレース ホルダーとして使用します。

Value Table

派生した出力

名前説明データ タイプ
out_table

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

テーブル ビュー; ラスター レイヤー; モザイク レイヤー

コードのサンプル

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

関連トピック