Modifier un champ (Gestion des données)—ArcGIS Pro

Synthèse

Renomme les champs et les alias de champ, ou modifie les propriétés de champ.

Utilisation

Cet outil vous permet de renommer les champs ou les alias de champ d’une classe d’entités ou d’une table de géodatabase.
Lorsque vous utilisez des tables ou classes d’entités en mémoire, le fait de renommer le champ ObjectID, Shape ou d’autres champs obligatoires tels que ceux présents dans les couches d’analyse de réseau, risque d’endommager les données ou d’entraîner un comportement inattendu.

Paramètres

Étiquette	Explication	Type de données
Table en entrée	Classe d’entités ou table de géodatabase en entrée qui contient le champ à modifier.	Table View; Raster Layer; Mosaic Layer
Nom de champ	Nom du champ à modifier. S’il s’agit d’un champ obligatoire, seul l’alias de champ peut être modifié.	Field
Nom du nouveau champ (Facultatif)	Nouveau nom du champ.	String
Nouvel alias de champ (Facultatif)	Nouvel alias du champ.	String
Nouveau type de champ (Facultatif)	Indique le nouveau type du champ. Ce paramètre est applicable uniquement si la table en entrée est vide (ne contient aucun enregistrement). Texte—Le champ est de type texte. Les champs de type texte prennent en charge une chaîne de caractères. Flottant (Virgule flottante 32 bits)—Le champ est de type réel simple. Les champs de type réel simple prennent en charge les nombres fractionnaires compris entre -3,4E38 et 1,2E38. Double (Virgule flottante 64 bits)—Le champ est de type réel double. Les champs de type réel double prennent en charge les nombres fractionnaires compris entre -2,2E308 et 1,8E308. Court (Entier 16 bits)—Le champ est de type court. Les champs de type court prennent en charge les nombres entiers compris entre -32 768 et 32 767. Long (Entier 32 bits)—Le champ est de type long. Les champs de type long prennent en charge les nombres entiers compris entre 2 147 483 648 et 2 147 483 647. Date—Le champ est de type date. Les champs de date prennent en charge les valeurs de date et d'heure. Blob (données binaires)—Le champ sera de type BLOB. Les champs de type BLOB prennent en charge les données stockées en tant que longue séquence de nombres binaires. Vous avez besoin d'une visionneuse ou d’un chargeur personnalisé, ou d’une application tierce pour charger des attributs dans un champ BLOB ou afficher le contenu d’un champ BLOB. Imagerie raster—Le champ sera de type raster. Les champs raster peuvent stocker les données raster dans ou avec la géodatabase. Tous les formats de jeu de données raster pris en charge par ArcGIS peuvent être stockés, mais il est recommandé de n’utiliser que des images de petite taille. GUID (identifiant unique global)—Le champ sera de type GUID. Les champs GUID contiennent des chaînes de registre constituées de 36 caractères placés entre des accolades.	String
Nouvelle longueur de champ (Facultatif)	Nouvelle longueur du champ. Définit le nombre maximal de caractères autorisés pour chaque enregistrement du champ. Ce paramètre ne s’applique qu’aux champs de type Texte ou Blob (données binaires). Si la table est vide, il est possible d’augmenter ou de diminuer la longueur de champ. Si la table n’est pas vide, il est possible uniquement d’augmenter la longueur à partir de la valeur actuelle.	Long
Le nouveau champ accepte les valeurs nulles (Facultatif)	Indique si le champ peut contenir des valeurs Null (nulles). Les valeurs Null sont prises en charge uniquement pour les champs d'une géodatabase. Ce paramètre est applicable uniquement si la table est vide (ne contient aucun enregistrement). Option sélectionnée : le champ peut contenir des valeurs Null. Il s’agit de l’option par défaut. Option désélectionnée : le champ ne peut pas contenir de valeurs Null.	Boolean
Supprimer l’alias (Facultatif)	Indique si l’alias du champ en entrée doit être effacé. La valeur du paramètre Nouvel alias de champ doit être vide pour effacer l’alias du champ. Activé : l'alias de champ va être effacé (défini sur Null). Le paramètre d'alias de champ doit être vide. Désactivé : l'alias de champ ne va pas être effacé. Il s’agit de l’option par défaut.	Boolean

Sortie obtenue

Étiquette	Explication	Type de données
Table en entrée mise à jour	Table en entrée mise à jour.	Table View; Raster Layer; Mosaic Layer

arcpy.management.AlterField(in_table, field, {new_field_name}, {new_field_alias}, {field_type}, {field_length}, {field_is_nullable}, {clear_field_alias})

Nom	Explication	Type de données
in_table	Classe d’entités ou table de géodatabase en entrée qui contient le champ à modifier.	Table View; Raster Layer; Mosaic Layer
field	Nom du champ à modifier. S’il s’agit d’un champ obligatoire, 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)	Indique le nouveau type du champ. Ce paramètre est applicable uniquement si la table en entrée est vide (ne contient aucun enregistrement). TEXT—Le champ est de type texte. Les champs de type texte prennent en charge une chaîne de caractères. FLOAT—Le champ est de type réel simple. Les champs de type réel simple prennent en charge les nombres fractionnaires compris entre -3,4E38 et 1,2E38. DOUBLE—Le champ est de type réel double. Les champs de type réel double prennent en charge les nombres fractionnaires compris entre -2,2E308 et 1,8E308. SHORT—Le champ est de type court. Les champs de type court prennent en charge les nombres entiers compris entre -32 768 et 32 767. LONG—Le champ est de type long. Les champs de type long prennent en charge les nombres entiers compris entre 2 147 483 648 et 2 147 483 647. DATE—Le champ est de type date. Les champs de date prennent en charge les valeurs de date et d'heure. BLOB—Le champ sera de type BLOB. Les champs de type BLOB prennent en charge les données stockées en tant que longue séquence de nombres binaires. Vous avez besoin d'une visionneuse ou d’un chargeur personnalisé, ou d’une application tierce pour charger des attributs dans un champ BLOB ou afficher le contenu d’un champ BLOB. RASTER—Le champ sera de type raster. Les champs raster peuvent stocker les données raster dans ou avec la géodatabase. Tous les formats de jeu de données raster pris en charge par ArcGIS peuvent être stockés, mais il est recommandé de n’utiliser que des images de petite taille. GUID—Le champ sera de type GUID. Les champs GUID contiennent des chaînes de registre constituées de 36 caractères placés entre des accolades.	String
field_length (Facultatif)	Nouvelle longueur du champ. Définit le nombre maximal de caractères autorisés pour chaque enregistrement du champ. Ce paramètre est uniquement applicable aux champs de type TEXT ou BLOB. Si la table est vide, il est possible d’augmenter ou de diminuer la longueur de champ. Si la table n’est pas vide, il est possible uniquement d’augmenter la longueur à partir de la valeur actuelle.	Long
field_is_nullable (Facultatif)	Indique si le champ peut contenir des valeurs Null (nulles). Les valeurs Null sont prises en charge uniquement pour les champs d'une géodatabase. Ce paramètre est applicable uniquement si la table en entrée est vide (ne contient aucun enregistrement). NON_NULLABLE—Le champ peut contenir des valeurs Null. NULLABLE—Le champ ne peut pas contenir de valeurs Null. Il s’agit de l’option par défaut.	Boolean
clear_field_alias (Facultatif)	Indique si l’alias du champ en entrée doit être effacé. Le paramètre new_field_alias doit être vide pour effacer l’alias du champ. CLEAR_ALIAS—L'alias de champ va être effacé (défini sur Null). DO_NOT_CLEAR—L'alias de champ ne va pas être effacé. Il s’agit de l’option par défaut.	Boolean

Sortie obtenue

Nom	Explication	Type de données
out_table	Table en entrée mise à jour.	Table View; Raster Layer; Mosaic Layer

Exemple de code

Exemple 1 d'utilisation de l'outil AlterField (fenêtre Python)

La fenêtre de script Python suivante illustre l’utilisation de la fonction 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 la fonction 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 la fonction AlterField sur une classe d’entités vide dans un script autonome.

#Import arcpy module
import arcpy

#Set local variables
in_table = "C:/Data/Garbo.gdb/trails" #Note: empty feature class
field = "condition_rating" #short int, non nullable field
new_field_name = "notes"
new_field_alias = "Comments on Trail Condition"
field_type = "TEXT"
field_length = "60"
field_is_nullable = "NULLABLE"
clear_field_alias = "FALSE"

#Alter the properties of a non nullable, short data type field to become a text field
arcpy.management.AlterField(in_table,
                            field,
                            new_field_name,
                            new_field_alias,
                            field_type,
                            field_length,
                            field_is_nullable,
                            clear_field_alias)

Synthèse

Utilisation

Paramètres

Sortie obtenue

Sortie obtenue

Exemple de code

Environnements

Informations de licence

Rubriques connexes

Dans cette rubrique