フィールドの変更 (Alter Field) (データ管理)

サマリー

フィールド名およびフィールド エイリアス名を変更するか、フィールド プロパティを変更します。

使用法

    注意:

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

  • このツールでは、ジオデータベース テーブルまたはフィーチャクラスのフィールド名またはフィールド エイリアス名を変更できます。

  • このツールを使用して、ジオデータベースに登録されているテーブルまたはビュー内のフィールドのフィールド エイリアスを変更できます。

  • 入力フィールドが必須フィールドである場合、変更できるのはフィールド エイリアスのみです。

パラメーター

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

変更するフィールドが含まれている入力ジオデータベース テーブルまたはフィーチャクラス。

Table View; Raster Layer; Mosaic Layer
フィールド名

変更するフィールドの名前。 このフィールドが必須フィールドである場合、変更できるのはフィールド エイリアスのみです。

Field
新しいフィールド名
(オプション)

フィールドの新しい名前。

String
新しいフィールド エイリアス
(オプション)

フィールドの新しいフィールド エイリアス。

String
新しいフィールド タイプ
(オプション)

フィールドの新しいフィールド タイプを指定します。 このパラメーターは、入力テーブルが空 (レコードが含まれていない) の場合にのみ適用されます。

  • 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 フィールドは、-(253) ~ 253 の範囲の整数をサポートします。
  • Float (32 ビット浮動小数点)フィールド タイプは Float です。 Float フィールドは、-3.4E38 ~ 1.2E38 の範囲の有理数をサポートします。
  • Double (64 ビット浮動小数点)フィールド タイプは Double です。 Double フィールドは、-2.2E308 ~ 1.8E308 の範囲の有理数をサポートします。
  • Textフィールド タイプは Text です。 Text フィールドは文字列をサポートします。
  • Dateフィールド タイプは Date です。 Date フィールドは、日付値と時間値をサポートします。
  • Date onlyフィールド タイプは date only です。 Date 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フィールド タイプは Raster です。 ラスター フィールドでは、ラスター データをジオデータベース内またはジオデータベースとともに格納できます。 ArcGIS ソフトウェアでサポートされているラスター データセット形式はすべて格納できますが、小さい画像のみを使用することをおすすめします。
String
新しいフィールドの長さ
(オプション)

フィールドの新しい長さ。 この値は、フィールドの各レコードに許容される文字の最大数を設定します。 このパラメーターは、タイプが [テキスト] または [Blob (バイナリ データ)] のフィールドに適用されます。 テーブルが空の場合、フィールド長を増減できます。 テーブルが空でない場合、長さは現在の値から増やすことのみが可能です。

Long
新しいフィールドに NULL 値を許可
(オプション)

このフィールドに NULL 値を含めることができるかどうかを指定します。 NULL 値は、ジオデータベースのフィールドでのみサポートされています。 このパラメーターは、テーブルが空 (レコードが含まれていない) の場合にのみ適用されます。

  • オン - フィールドは NULL 値を含むことができます。 これがデフォルトです。
  • オフ - フィールドは NULL 値を含むことができません。
Boolean
エイリアスの消去
(オプション)

入力フィールドのエイリアスを消去するかどうかを指定します。 フィールドのエイリアスを消去するには、[新しいフィールド エイリアス] パラメーターの値が空である必要があります。

  • オン - フィールド エイリアスは消去されます (NULL に設定)。 フィールド エイリアス パラメーターが空である必要があります。
  • オフ - フィールド エイリアスは消去されません。 これがデフォルトです。
Boolean

派生した出力

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

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

Table View; Raster Layer; Mosaic Layer

arcpy.management.AlterField(in_table, field, {new_field_name}, {new_field_alias}, {field_type}, {field_length}, {field_is_nullable}, {clear_field_alias})
名前説明データ タイプ
in_table

変更するフィールドが含まれている入力ジオデータベース テーブルまたはフィーチャクラス。

Table View; Raster Layer; Mosaic Layer
field

変更するフィールドの名前。 このフィールドが必須フィールドである場合、変更できるのはフィールド エイリアスのみです。

Field
new_field_name
(オプション)

フィールドの新しい名前。

String
new_field_alias
(オプション)

フィールドの新しいフィールド エイリアス。

String
field_type
(オプション)

フィールドの新しいフィールド タイプを指定します。 このパラメーターは、入力テーブルが空 (レコードが含まれていない) の場合にのみ適用されます。

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

フィールドの新しい長さ。 この値は、フィールドの各レコードに許容される文字の最大数を設定します。 このパラメーターは、TEXT または BLOB タイプのフィールドにのみ適用されます。 テーブルが空の場合、フィールド長を増減できます。 テーブルが空でない場合、長さは現在の値から増やすことのみが可能です。

Long
field_is_nullable
(オプション)

このフィールドに NULL 値を含めることができるかどうかを指定します。 NULL 値は、ジオデータベースのフィールドでのみサポートされています。 このパラメーターは、入力テーブルが空 (レコードが含まれていない) の場合にのみ適用されます。

  • NULLABLEフィールドは NULL 値を含むことができます。 これがデフォルトです。
  • NON_NULLABLEフィールドは NULL 値を含むことができません。
Boolean
clear_field_alias
(オプション)

入力フィールドのエイリアスを消去するかどうかを指定します。 フィールドのエイリアスを消去するには、new_field_alias パラメーターが空である必要があります。

  • CLEAR_ALIASフィールド エイリアスは消去されます (NULL に設定)。
  • DO_NOT_CLEARフィールド エイリアスは消去されません。 これがデフォルトです。
Boolean

派生した出力

名前説明データ タイプ
out_table

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

Table View; Raster Layer; Mosaic Layer

コードのサンプル

AlterField の例 1 (Python ウィンドウ)

次の Python ウィンドウ スクリプトは、イミディエイト モードで AlterField 関数を使用する方法を示しています。

import arcpy
arcpy.management.AlterField(
    r'C:\Data\Garbo.gdb\Khyber', 'Elev', 'ELEVATION', 'Elevation in Metres')
AlterField の例 2 (スタンドアロン スクリプト)

次の Python ウィンドウ スクリプトは、スタンドアロン スクリプトで AlterField 関数を使用する方法を示しています。

import arcpy

# Set workspace
arcpy.env.workspace = r'C:\Data\Garbo.gdb'

# Loop through feature classes looking for a field named 'elev'
fcList = arcpy.ListFeatureClasses()  # Get a list of feature classes
for fc in fcList:  # Loop through feature classes
    fieldList = arcpy.ListFields(fc)  # Get a list of fields for each feature class
    for field in fieldList:  # Lloop through each field
        if field.name.lower() == 'elev':  # Look for the name elev
            arcpy.management.AlterField(fc, field.name, 'ELEVATION', 'Elevation in Metres')
AlterField の例 3 (スタンドアロン スクリプト)

次の Python ウィンドウ スクリプトは、スタンドアロン スクリプトで空のフィーチャクラスに対して AlterField 関数を使用する方法を示しています。

import arcpy

# Set local variables
in_table = "C:/Data/Garbo.gdb/trails"  # Note: empty feature class
field = "condition_rating"  # short int, non nullable field
new_field_name = "notes"
new_field_alias = "Comments on Trail Condition"
field_type = "TEXT"
field_length = 60
field_is_nullable = "NULLABLE"
clear_field_alias = "FALSE"

# Alter the properties of a non nullable, short data type field to become a text field
arcpy.management.AlterField(in_table,
                            field,
                            new_field_name,
                            new_field_alias,
                            field_type,
                            field_length,
                            field_is_nullable,
                            clear_field_alias)

ライセンス情報

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

関連トピック