重命名 (数据管理)

摘要

更改数据集的名称。 其中包括各种数据类型，包括要素数据集、栅格、表和 shapefile。

使用情况

• 输出名称必须唯一。 否则，即使启用了地理处理允许地理处理工具覆盖现有数据集设置，也会报告错误消息。

• 此工具还会重命名数据的别名。

• 此工具不会重命名图层，因为图层是对数据集的引用。

• 此工具不会重命名数据集中的字段。 例如，如果您名为 Roads 的要素类有一个名为 ROADS_ID 的字段，则将 Roads 要素类重命名为 Streets 不会将 ROADS_ID 字段重命名为 STREETS_ID。

• 由于数据库限制，此工具不适用于存储在 DB2 数据库中的数据。

参数

对话框

标注	说明	数据类型
输入数据元素	要重命名的输入数据。	Data Element
输出数据元素	输出数据的名称。	Data Element
数据类型	要重命名的数据的类型。 仅当两种不同数据类型之间发生名称冲突时才需要此参数。 例如，地理数据库可以包含与要素类同名的关系类。 如果是这种情况，请指定相关关键字。 FeatureClass - 如果名称重复，将使用要素类。 FeatureDataset - 如果名称重复，将使用要素数据集。 MosaicDataset - 如果名称重复，将使用镶嵌数据集。 ParcelFabric - 如果名称重复，将使用宗地结构。 RelationshipClass - 如果名称重复，将使用关系类。 Topology - 如果名称重复，将使用拓扑。	String

Python

arcpy.management.Rename(in_data, out_data, data_type)

名称	说明	数据类型
in_data	要重命名的输入数据。	Data Element
out_data	输出数据的名称。	Data Element
data_type	要重命名的数据的类型。 仅当两种不同数据类型之间发生名称冲突时才需要此参数。 例如，地理数据库可以包含与要素类同名的关系类。 如果是这种情况，请指定相关关键字。 FeatureClass - 如果名称重复，将使用要素类。 FeatureDataset - 如果名称重复，将使用要素数据集。 MosaicDataset - 如果名称重复，将使用镶嵌数据集。 ParcelFabric - 如果名称重复，将使用宗地结构。 RelationshipClass - 如果名称重复，将使用关系类。 Topology - 如果名称重复，将使用拓扑。	String

代码示例

Rename 示例 1（Python 窗口）

以下 Python 窗口脚本演示了如何在即时模式下使用 Rename 函数。

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.Rename("customers.dbf", "customers_2010.dbf")

Rename 示例 2（独立脚本）

以下 Python 脚本演示了如何在独立脚本中使用 Rename 函数。

# 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)

环境

当前工作空间, 临时工作空间