Renommer (Gestion des données)

Synthèse

Change le nom d’un jeu de données. Cet outil s’applique à différents types de données, notamment les jeux de classes d’entités, les rasters, les tables et les shapefiles.

Utilisation

  • Le nom en sortie doit être unique. Si tel n’est pas le cas, un message d’erreur s’affiche, même si le paramètre Autoriser les outils de géotraitement à remplacer les jeux de données existants est activé.

  • L’outil renomme également l’alias des données.

  • L’outil ne renomme pas les couches, étant donné qu’une couche constitue une référence à un jeu de données.

  • L’outil ne renomme pas les champs du jeu de données. Par exemple, supposons 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.

  • L’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
Élément de données en sortie

Nom des données en sortie.

Data Element
Type de données

Type des données à renommer.

Ce paramètre est uniquement nécessaire en cas de conflit de noms entre deux types de données différents. Par exemple, une géodatabase peut contenir une classe de relations portant un nom identique à une classe d’entités. Si tel est le cas, indiquez le mot-clé pertinent.

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

Type des données à renommer.

Ce paramètre est uniquement nécessaire en cas de conflit de noms entre deux types de données différents. Par exemple, une géodatabase peut contenir une classe de relations portant un nom identique à une classe d’entités. Si tel est le cas, indiquez le mot-clé pertinent.

String

Exemple de code

Exemple 1 d’utilisation de la fonction Rename (fenêtre Python)

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.Rename("customers.dbf", "customers_2010.dbf")
Exemple 2 d’utilisation de la fonction Rename (script Python autonome)

Le script Python suivant illustre l’utilisation de la fonction Rename dans un script autonome.

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

Rubriques connexes