概要
データセットの名前を変更します。 これには、フィーチャ データセット、ラスター、テーブル、シェープファイルなどのさまざまなデータ タイプが含まれます。
使用法
出力名は一意でなければなりません。 一意でない場合は、ジオプロセシングの上書き出力環境が true に設定されていても、エラー メッセージが表示されます。
レイヤーはデータセットへの参照であるため、このツールによってレイヤーの名前は変更されません。
[名前の変更 (Rename)] ツールでは、データセット内のフィールドの名前は変更しません。 たとえば、Roads という名前のフィーチャクラスに ROADS_ID というフィールドがある場合、Roads フィーチャクラスの名前を Streets に変更しても、ROADS_ID フィールドの名前は STREETS_ID に変更されません。
カバレッジの名前を変更した場合も、カバレッジ内のすべてのリージョンとルートのサブクラスの名前が変更されます。
このツールはデータベースの制約により、DB2 データベースに格納されたデータでは動作しません。
構文
arcpy.management.Rename(in_data, out_data, {data_type})| パラメーター | 説明 | データ タイプ |
in_data | 名前を変更する入力データ。 | Data Element |
out_data | 出力データの名前。 | Data Element |
data_type (オプション) | 名前を変更するデータのタイプ。 ジオデータベースに同じ名前のフィーチャ データセットとフィーチャクラスがある場合にのみ、値を指定する必要があります。 この場合は、名前を変更するアイテムのデータ タイプ (フィーチャ データセットまたはフィーチャクラス) を選択する必要があります。 | String |
コードのサンプル
Rename の例 1 (Python ウィンドウ)
次の Python ウィンドウ スクリプトは、イミディエイト モードで Rename 関数を使用する方法を示しています。
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.Rename_management("customers.dbf", "customers_2010.dbf")
Rename の例 2 (スタンドアロン スクリプト)
次の Python スクリプトは、スタンドアロン スクリプトで Rename 関数を使用する方法を示しています。
# Name: Rename_Example2.py
# Description: Rename fileGDB feature class
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/workspace/test.gdb"
# Set local variables
in_data = "test"
out_data = "testFC"
data_type = "FeatureClass"
# Execute Rename
arcpy.Rename_management(in_data, out_data, data_type)
環境
ライセンス情報
- Basic: はい
- Standard: はい
- Advanced: はい