フィールドの変更 (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 です。 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

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 です。 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)

環境

現在のワークスペース