重命名 (数据管理)

摘要

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

使用情况

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

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

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

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

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

参数

标注说明数据类型
输入数据元素

要重命名的输入数据。

Data Element
输出数据元素

输出数据的名称。

Data Element
数据类型

要重命名的数据的类型。

此参数将在名称冲突的情况下使用。 地理数据库可能包含同名的不同数据集,例如同名的要素类、要素数据集、镶嵌数据集和宗地结构可能存在于同一个地理数据库中。 如果有两个或多个同名数据集,指定一个值将指示工具使用该数据类型。

String

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