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

サマリー

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

使用法

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

  • [フィールド プロパティ] パラメーターで指定したフィールドには、次のデフォルト プロパティがあります。

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

  • [フィールド プロパティ] または [テンプレート テーブル] パラメーターを使用して、フィールドを入力に追加できます。 両方のパラメーターを指定した場合は、両方のパラメーターからフィールドが追加されます。

  • [フィールド プロパティ] パラメーターの [フィールドの長さ] オプションは、タイプがテキストのフィールドにのみ適用できます。

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

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

パラメーター

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

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

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

Table View; Raster Layer; Mosaic Layer
フィールド プロパティ
(オプション)

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

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

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

  • テキスト - フィールド タイプはテキストになります。 テキスト フィールドは文字列をサポートします。
  • Float (32 ビット浮動小数点) - フィールド タイプは Float になります。 Float フィールドは、-3.4E38 ~ 1.2E38 の範囲の有理数をサポートします。
  • Double (64 ビット浮動小数点) - フィールド タイプは Double になります。 Double フィールドは、-2.2E308 ~ 1.8E308 の範囲の有理数をサポートします。
  • Short (16 ビット整数) - フィールド タイプは Short になります。 Short フィールドは、-32,768 〜 32,767 の範囲の整数をサポートします。
  • Long (32 ビット整数) - フィールド タイプは Long になります。 Long フィールドは、-2,147,483,648 ~ 2,147,483,647 の範囲の整数をサポートします。
  • 日付 - フィールド タイプは日付になります。 日付フィールドは、日付値と時間値をサポートします。
  • Blob (バイナリ データ) - フィールド タイプは BLOB になります。 BLOB フィールドは、大容量バイナリ オブジェクトとして格納されたデータをサポートします。 BLOB フィールドにアイテムを読み込む、または BLOB フィールドの内容を参照するには、カスタム ローダー、カスタム ビューアー、またはサードパーティ アプリケーションが必要です。
  • ラスター画像 - フィールド タイプはラスターになります。 ラスター フィールドでは、ラスター データをジオデータベース内またはジオデータベースとともに格納できます。 ArcGIS ソフトウェアでサポートされているラスター データセット形式はすべて格納できますが、小さい画像のみを使用することをおすすめします。
  • GUID (globally unique identifier) - フィールド タイプは GUID になります。 GUID フィールドには、中括弧 ({}) で囲まれた 36 文字のレジストリ形式の文字列が格納されます。
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- フィールドに割り当てられるジオデータベース ドメイン。

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

  • TEXT - フィールド タイプはテキストになります。 テキスト フィールドは文字列をサポートします。
  • FLOAT - フィールド タイプは Float になります。 Float フィールドは、-3.4E38 ~ 1.2E38 の範囲の有理数をサポートします。
  • DOUBLE - フィールド タイプは Double になります。 Double フィールドは、-2.2E308 ~ 1.8E308 の範囲の有理数をサポートします。
  • SHORT - フィールド タイプは Short になります。 Short フィールドは、-32,768 〜 32,767 の範囲の整数をサポートします。
  • LONG - フィールド タイプは Long になります。 Long フィールドは、-2,147,483,648 ~ 2,147,483,647 の範囲の整数をサポートします。
  • DATE - フィールド タイプは日付になります。 日付フィールドは、日付値と時間値をサポートします。
  • BLOB - フィールド タイプは BLOB になります。 BLOB フィールドは、大容量バイナリ オブジェクトとして格納されたデータをサポートします。 BLOB フィールドにアイテムを読み込む、または BLOB フィールドの内容を参照するには、カスタム ローダー、カスタム ビューアー、またはサードパーティ アプリケーションが必要です。
  • RASTER - フィールド タイプはラスターになります。 ラスター フィールドでは、ラスター データをジオデータベース内またはジオデータベースとともに格納できます。 ArcGIS ソフトウェアでサポートされているラスター データセット形式はすべて格納できますが、小さい画像のみを使用することをおすすめします。
  • GUID - フィールド タイプは GUID になります。 GUID フィールドには、中括弧 ({}) で囲まれた 36 文字のレジストリ形式の文字列が格納されます。

オプションのパラメーターを含む 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', '']])

ライセンス情報

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

関連トピック