Renommer (Gestion des données)

Synthèse

Modifie le nom d'un jeu de données. Cet outil contient divers types de données, dont les suivants : jeu de données d'entité, raster, table et fichier de forme.

Utilisation

  • Le nom de la sortie doit être unique. Si ce n'est pas le cas, un message d'erreur apparaît, même si l'environnement de remplacement en sortie de l'outil de géotraitement est défini sur Vrai.

  • Cet outil ne renomme pas les couches, étant donné qu'une couche fait référence à un jeu de données.

  • L'outil Renommer ne renomme pas les champs du jeu de données. Par exemple, supposez que vous ayez un champ nommé ROADS_ID dans une classe d'entités nommée Roads. Si la classe d'entités Roads est renommée Streets, le champ ROADS_ID n'est pas renommé STREETS_ID.

  • Cet outil ne fonctionne pas avec les données stockées dans une base de données DB2 en raison des contraintes liées à la base de données.

Paramètres

ÉtiquetteExplicationType de données
Élément de données en entrée

Données en entrée à renommer.

Data Element
Elément de données en sortie

Nom des données en sortie.

Data Element
Type de données
(Facultatif)

Type des données à renommer. Vous devez fournir une valeur seulement lorsqu'une géodatabase contient un jeu de données d'entité et une classe d'entités qui ont le même nom. Dans ce cas, vous devez sélectionner le type de données (jeu de données d'entité ou classe d'entités) de l'élément que vous souhaitez renommer.

String

arcpy.management.Rename(in_data, out_data, {data_type})
NomExplicationType de données
in_data

Données en entrée à renommer.

Data Element
out_data

Nom des données en sortie.

Data Element
data_type
(Facultatif)

Type des données à renommer. Vous devez fournir une valeur seulement lorsqu'une géodatabase contient un jeu de données d'entité et une classe d'entités qui ont le même nom. Dans ce cas, vous devez sélectionner le type de données (jeu de données d'entité ou classe d'entités) de l'élément que vous souhaitez renommer.

String

Exemple de code

Exemple 1 d'utilisation de la fonction Renommer (fenêtre Python)

Le script de fenêtre Python ci-dessous illustre l'utilisation de la fonction Renommer en mode immédiat.

import arcpy
from arcpy import env

env.workspace = "C:/data"
arcpy.Rename_management("customers.dbf", "customers_2010.dbf")
Exemple 2 d'utilisation de l'outil Renommer (script Python autonome)

Le script Python ci-dessous illustre l'utilisation de la fonction Renommer dans un script autonome.

# Name: Rename_Example2.py
# Description: Rename fileGDB feature class

# Import system modules
import arcpy
from arcpy import env

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

Informations de licence

  • Basic: Oui
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes