Label | Explanation | Data Type |
Input Data Element | The input data to be renamed. | Data Element |
Output Data Element | The name of the output data. | Data Element |
Data Type
| The type of data to be renamed. This parameter will be used in the event of a name conflict. A geodatabase may contain different datasets with the same name, for example, a feature class, feature dataset, mosaic dataset, and parcel fabric with the same name may exist in the same geodatabase. Specifying a value will direct the tool to use that data type in the event of two or more datasets with the same name.
| String |
Summary
Changes the name of a dataset. This includes a variety of data types, including feature dataset, raster, table, and shapefile.
Usage
The output name must be unique. If it is not, an error message is reported, even if the geoprocessing Allow geoprocessing tools to overwrite existing datasets setting is enabled.
The tool also renames the alias of the data.
The tool does not rename layers, since a layer is a reference to a dataset.
The tool does not rename fields in the dataset. For example, if you have a field named ROADS_ID in a feature class named Roads, renaming the Roads feature class to Streets does not rename the ROADS_ID field to STREETS_ID.
The tool does not work with data stored in a DB2 database due to database constraints.
Parameters
arcpy.management.Rename(in_data, out_data, data_type)
Name | Explanation | Data Type |
in_data | The input data to be renamed. | Data Element |
out_data | The name of the output data. | Data Element |
data_type | The type of data to be renamed. This parameter will be used in the event of a name conflict. A geodatabase may contain different datasets with the same name, for example, a feature class, feature dataset, mosaic dataset, and parcel fabric with the same name may exist in the same geodatabase. Specifying a value will direct the tool to use that data type in the event of two or more datasets with the same name.
| String |
Code sample
The following Python window script demonstrates how to use the Rename function in immediate mode.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.Rename("customers.dbf", "customers_2010.dbf")
The following Python script demonstrates how to use the Rename function in a stand-alone script.
# Description: Rename a file geodatabase 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"
# Run Rename
arcpy.management.Rename(in_data, out_data, data_type)
Environments
Licensing information
- Basic: Yes
- Standard: Yes
- Advanced: Yes