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 ce n’est pas le cas, un message d’erreur s’affiche, même si l’environnement de remplacement en sortie de l’outil de géotraitement est défini sur Vrai.

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

  • L’outil ne renomme pas les couches, étant donné qu’une couche fait 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
(Facultatif)

Type des données à renommer. Vous devez fournir une valeur uniquement lorsqu’une géodatabase contient un jeu de classes d’entités et une classe d’entités portant le même nom. Dans ce cas, vous devez sélectionner le type de données (jeu de classes d’entités 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 uniquement lorsqu’une géodatabase contient un jeu de classes d’entités et une classe d’entités portant le même nom. Dans ce cas, vous devez sélectionner le type de données (jeu de classes d’entités ou classe d’entités) de l’élément que vous souhaitez renommer.

String

Exemple de code

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

La fenêtre de script Python suivante 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.

# Name: Rename_Example2.py
# Description: Rename fileGDB 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)

Informations de licence

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

Rubriques connexes