フィールドの変更 (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 フィールドには、-(2^53) ～ 2^53 の整数を指定できます。 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 フィールドには、日付値を指定できます。時間値は指定できません。 Time Only—フィールド タイプが時間のみになります。 Time only フィールドには、時間値を指定できます。日付値は指定できません。 Timestamp Offset—フィールド タイプが Timestamp Offset になります。 Timestamp Offset フィールドは、日付、時刻、および UTC 値からのオフセットを指定できます。 BLOB (バイナリ データ)—フィールド タイプが BLOB になります。 BLOB フィールドには、長いバイナリ数値列として格納されるデータを指定できます。 BLOB フィールドにアイテムを読み込む、または BLOB フィールドの内容を参照するには、カスタム ローダー、カスタム ビューアー、またはサードパーティ アプリケーションが必要です。 GUID (Globally Unique Identifier)—フィールド タイプが GUID になります。 GUID フィールドには、中括弧 ({}) で囲まれた 36 文字のレジストリ形式の文字列が格納されます。 Raster—フィールド タイプがラスターになります。 ラスター フィールドでは、ラスター データをジオデータベースの内部またはジオデータベースと一緒に格納できます。 ArcGIS ソフトウェアでサポートされているラスター データセット形式はすべて格納できますが、小さい画像のみを使用することをお勧めします。	String
新しいフィールドの長さ (オプション)	フィールドの新しい長さ。 この値は、フィールドの各レコードに許容される文字の最大数を設定します。 このパラメーターは、タイプが [テキスト] または [Blob (バイナリ データ)] のフィールドに適用されます。 テーブルが空の場合、フィールド長を増減できます。 テーブルが空でない場合、長さは現在の値から増やすことのみが可能です。	Long
新しいフィールドに NULL 値を許可 (オプション)	このフィールドに NULL 値を含めることができるかどうかを指定します。 NULL 値は、ジオデータベースのフィールドでのみサポートされています。 このパラメーターは、テーブルが空 (レコードが含まれていない) の場合にのみ適用されます。 オン - フィールドは NULL 値を含むことができます。 これがデフォルトです。 オフ - フィールドは NULL 値を含むことができません。	Boolean
エイリアスの消去 (オプション)	入力フィールドのエイリアスを消去するかどうかを指定します。 フィールドのエイリアスを消去するには、[新しいフィールド エイリアス] パラメーターの値が空である必要があります。 オン - フィールド エイリアスは消去されます (NULL に設定)。 フィールド エイリアス パラメーターが空である必要があります。 オフ - フィールド エイリアスは消去されません。 これがデフォルトです。	Boolean

派生した出力

ラベル	説明	データ タイプ
更新された入力テーブル	更新された入力テーブル。	Table View; Raster Layer; Mosaic Layer

Python

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 フィールドには、-(2^53) ～ 2^53 の整数を指定できます。 FLOAT—フィールド タイプが Float になります。 Float フィールドには、-3.4E38 ～ 1.2E38 の有理数を指定できます。 DOUBLE—フィールド タイプが Double になります。 Double フィールドには、-2.2E308 ～ 1.8E308 の有理数を指定できます。 TEXT—フィールド タイプが Text になります。 Text フィールドには、文字列を指定できます。 DATE—フィールド タイプが Date になります。 Date フィールドには、日付値と時間値を指定できます。 DATEONLY—フィールド タイプが日付のみになります。 Date Only フィールドには、日付値を指定できます。時間値は指定できません。 TIMEONLY—フィールド タイプが時間のみになります。 Time only フィールドには、時間値を指定できます。日付値は指定できません。 TIMESTAMPOFFSET—フィールド タイプが Timestamp Offset になります。 Timestamp Offset フィールドは、日付、時刻、および UTC 値からのオフセットを指定できます。 BLOB—フィールド タイプが BLOB になります。 BLOB フィールドには、長いバイナリ数値列として格納されるデータを指定できます。 BLOB フィールドにアイテムを読み込む、または BLOB フィールドの内容を参照するには、カスタム ローダー、カスタム ビューアー、またはサードパーティ アプリケーションが必要です。 GUID—フィールド タイプが GUID になります。 GUID フィールドには、中括弧 ({}) で囲まれた 36 文字のレジストリ形式の文字列が格納されます。 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