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

サマリー

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

使用法

注意:

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

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

• メモリ内のフィーチャクラスまたはテーブルを使用している場合、ObjectID、Shape またはネットワーク解析レイヤーで必要なその他のフィールドの名前を変更すると、データが壊れたり、予期せぬ動作を起こす可能性があります。

パラメーター

ダイアログ

ラベル	説明	データ タイプ
入力テーブル	変更するフィールドを含む入力ジオデータベース テーブルまたはフィーチャクラス。	Table View; Raster Layer; Mosaic Layer
フィールド名	変更するフィールドの名前。 このフィールドが必須フィールドである場合、変更できるのはフィールド エイリアスのみです。	Field
新しいフィールド名 (オプション)	フィールドの新しい名前。	String
新しいフィールド エイリアス (オプション)	フィールドの新しいフィールド エイリアス。	String
新しいフィールド タイプ (オプション)	フィールドの新しいフィールド タイプを指定します。 入力テーブルが空 (レコードが含まれていない) の場合にのみ適用できます。 Text—フィールド タイプはテキストです。 テキスト フィールドは文字列をサポートします。 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 の範囲の整数をサポートします。 Date—フィールド タイプは日付です。 日付フィールドは、日付値と時間値をサポートします。 Blob (バイナリ データ)—フィールド タイプは BLOB です。 BLOB フィールドは、大容量バイナリ オブジェクトとして格納されたデータをサポートします。 BLOB フィールドにアイテムを読み込む、または BLOB フィールドの内容を参照するには、カスタム ローダー、カスタム ビューアー、またはサードパーティ アプリケーションが必要です。 Raster imagery—フィールド タイプはラスターです。 ラスター フィールドでは、ラスター データをジオデータベース内またはジオデータベースとともに格納できます。 ArcGIS ソフトウェアでサポートされているラスター データセット形式はすべて格納できますが、小さい画像のみを使用することをおすすめします。 GUID (Globally Unique Identifier)—フィールド タイプは GUID です。 GUID フィールドには、中括弧 ({}) で囲まれた 36 文字のレジストリ形式の文字列が格納されます。	String
新しいフィールドの長さ (オプション)	フィールドの新しい長さ。 この値は、フィールドの各レコードに許容される文字の最大数を設定します。 このパラメーターは、タイプが Text または 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 (オプション)	フィールドの新しいフィールド タイプを指定します。 入力テーブルが空 (レコードが含まれていない) の場合にのみ適用できます。 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 文字のレジストリ形式の文字列が格納されます。	String
field_length (オプション)	フィールドの新しい長さ。 この値は、フィールドの各レコードに許容される文字の最大数を設定します。 このパラメーターは、タイプが TEXT または BLOB のフィールドに対してのみ適用されます。 テーブルが空白の場合、フィールド長を増減できます。 テーブルが空ではない場合は、長さは現在の値からのみ増加できます。	Long
field_is_nullable (オプション)	このフィールドに NULL 値を含めることができるかどうかを指定します。 NULL 値は、ジオデータベースのフィールドでのみサポートされています。 入力テーブルが空 (レコードが含まれていない) の場合にのみ適用できます。 NON_NULLABLE—フィールドは NULL 値を含むことができます。 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