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

概要

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

使用法

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

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

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

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

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

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

構文

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: はい
• Standard: はい
• Advanced: はい