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

サマリー

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

使用法

注意:

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

このツールでは、ジオデータベーステーブルまたはフィーチャクラスのフィールド名またはフィールドエイリアス名を変更できます。
このツールを使用して、ジオデータベースに登録されているテーブルまたはビュー内のフィールドのフィールドエイリアスを変更できます。
入力フィールドが必須フィールドである場合、変更できるのはフィールドエイリアスのみです。

ラベル	説明	データタイプ
入力テーブル	変更するフィールドが含まれている入力ジオデータベーステーブルまたはフィーチャクラス。	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⁵³) ～ 2⁵³ の整数を指定できます。 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 文字のレジストリー形式の文字列が格納されます。ラスター—フィールドタイプがラスターになります。ラスターフィールドでは、ラスターデータをジオデータベースの内部またはジオデータベースと一緒に格納できます。 ArcGIS ソフトウェアでサポートされているラスターデータセット形式はすべて格納できますが、小さい画像のみを使用することをお勧めします。	String
新しいフィールドの長さ (オプション)	フィールドの新しい長さ。この値は、フィールドの各レコードに許容される文字の最大数を設定します。このパラメーターは、タイプがテキストまたは Blob (バイナリーデータ) のフィールドに適用されます。テーブルが空の場合、フィールド長を増減できます。テーブルが空でない場合、長さは現在の値から増やすことのみが可能です。	Long
新しいフィールドに NULL 値を許可 (オプション)	このフィールドに NULL 値を含めることができるかどうかを指定します。 NULL 値は、ジオデータベースのフィールドでのみサポートされています。このパラメーターは、入力テーブルが空 (レコードが含まれていない) の場合にのみ適用されます。オン—フィールドは NULL 値を含むことができます。これがデフォルトです。オフ—フィールドは NULL 値を含むことができません。	Boolean
エイリアスの消去 (オプション)	入力フィールドのエイリアスを消去するかどうかを指定します。フィールドのエイリアスを消去するには、`new_field_alias` パラメーターが空である必要があります。オン—フィールドエイリアスは消去されます (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 フィールドには、-(2⁵³) ～ 2⁵³ の整数を指定できます。 `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 (オプション)	入力フィールドのエイリアスを消去するかどうかを指定します。フィールドのエイリアスを消去するには、新しいフィールドエイリアスパラメーターの値が空である必要があります。 `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: はい
Standard: はい
Advanced: はい

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

サマリー

使用法

注意:

パラメーター

派生した出力

環境

ライセンス情報

関連トピック