Résumé
Renomme les champs et les alias de champ, ou modifie les propriétés de champ.
Utilisation
Cet outil permet de renommer les champs ou les alias de champ d'une classe d'entités ou d'une table de géodatabase.
Pour les classes d'entités ou tables de géodatabase vides, vous pouvez modifier les propriétés de champ, telles que le type de champ, sa longueur ou son acceptation des valeurs Null.
Lorsque vous utilisez des tables ou des classes d'entités en mémoire, en renommant le champ ObjectID, Shape ou d'autres champs obligatoires, tels que ceux présents dans les couches d'analyse de réseau, vous risquez d'endommager les données ou d'induire un comportement inattendu.
Syntaxe
AlterField_management (in_table, field, {new_field_name}, {new_field_alias}, {field_type}, {field_length}, {field_is_nullable}, {clear_field_alias})
Paramètre | Explication | Type de données |
in_table | Classe d’entités ou table en entrée contenant le champ à modifier. | Table View; Raster Layer; Raster Catalog Layer; Mosaic Layer |
field | Nom du champ à modifier. Si le champ est un champ obligatoire (isRequired=vrai), seul l'alias de champ peut être modifié. | Field |
new_field_name (Facultatif) | Nouveau nom du champ. | String |
new_field_alias (Facultatif) | Nouvel alias du champ. | String |
field_type (Facultatif) | Nouveau type de champ du champ. Applicable uniquement si la table en entrée est vide (ne contient aucun enregistrement).
| String |
field_length (Facultatif) | Nouvelle longueur du champ. Définit le nombre maximal de caractères autorisés pour chaque enregistrement du champ. Cette option ne s'applique qu'aux champs de type TEXT ou BLOB. Applicable uniquement si la table est vide. | Long |
field_is_nullable (Facultatif) | Détermine si le champ peut contenir des valeurs Null. Les valeurs Null sont prises en charge uniquement pour les champs d'une géodatabase. Applicable uniquement si la table en entrée est vide (ne contient aucun enregistrement).
| Boolean |
clear_field_alias (Facultatif) | Spécifie si l'alias du champ en entrée doit être effacé ou non. Le paramètre d'alias de champ doit être vide pour effacer l'alias du champ.
| Boolean |
Sortie dérivée
Nom | Explication | Type de données |
out_table |
Exemple de code
Exemple 1 d'utilisation de l'outil AlterField (fenêtre Python)
Le script de fenêtre Python suivant montre comment utiliser l'outil AlterField en mode immédiat.
arcpy.AlterField_management(r'C:\Data\Garbo.gdb\Khyber', 'Elev', 'ELEVATION', 'Elevation in Metres')
Exemple 2 d'utilisation de l'outil AlterField (script autonome)
Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil AlterField dans un script autonome.
#Import geoprocessing
import arcpy
#Set workspace
arcpy.env.workspace = r'C:\Data\Garbo.gdb'
#Loop through feature classes looking for a field named 'elev'
fcList = arcpy.ListFeatureClasses() #get a list of feature classes
for fc in fcList: #loop through feature classes
fieldList = arcpy.ListFields(fc) #get a list of fields for each feature class
for field in fieldList: #loop through each field
if field.name.lower() == 'elev': #look for the name elev
arcpy.AlterField_management(fc, field.name, 'ELEVATION', 'Elevation in Metres')
Exemple 3 d'utilisation de l'outil AlterField (script autonome)
Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil AlterField sur une classe d'entités vide dans un script autonome.
#Import geoprocessing
import arcpy
#Set local variables
fc = "C:/Data/Garbo.gdb/trails" #Note:empty feature class
field = "condition_rating" #short int, non nullable field
new_name = "notes"
new_alias = "Comments on Trail Condition"
new_type = "TEXT"
new_length = "60"
new_is_nullable = "NULLABLE"
clear_alias = "FALSE"
#Alter the properties of a non nullable, short data type field to become a text field
arcpy.AlterField_management(fc, field, new_name, new_alias, new_type, new_length, new_is_nullable, clear_alias)
Environnements
Informations de licence
- ArcGIS Desktop Basic: Oui
- ArcGIS Desktop Standard: Oui
- ArcGIS Desktop Advanced: Oui