Modifier le champ (Gestion des données)

Synthèse

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

Utilisation

    Attention :

    Cet outil modifie les données en entrée. Pour plus d’informations et connaître les stratégies permettant d’empêcher les modifications de données indésirables, reportez-vous à la rubrique Outils qui modifient ou mettent à jour les données en entrée.

  • Cet outil permet de renommer les champs ou alias de champ d’une classe d’entités ou d’une table de géodatabase.

  • Cet outil permet de modifier l’alias de champ d’un champ d’une table ou vue inscrite dans la géodatabase.

  • Si le champ en entrée est un champ requis, seul l’alias de champ peut être modifié.

Paramètres

ÉtiquetteExplicationType de données
Input Table (Table en entrée)

Classe d’entités ou table de géosatabase en entrée contenant le champ à modifier.

Table View; Raster Layer; Mosaic Layer
Nom de champ

Nom du champ à modifier. Si le champ est un champ requis, seul l’alias de champ est modifié.

Field
New Field Name (Nouveau nom de champ)
(Facultatif)

Nouveau nom du champ.

String
Nouvel alias de champ
(Facultatif)

Nouvel alias de champ du champ.

String
Nouveau type de champ
(Facultatif)

Spécifie le nouveau type de champ du champ. Ce paramètre n’est applicable que si la table en entrée est vide (ne contient aucun enregistrement).

  • 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.
  • Entier très grand (entier de 64 bits)Le type de champ est Entier très grand. Les champs de type entier très grand prennent en charge les nombres entiers compris entre -(253) et 253.
  • 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.
  • TexteLe champ est de type texte. Les champs de type texte prennent en charge une chaîne de caractères.
  • DateLe champ est de type date. Les champs de date prennent en charge les valeurs de date et d'heure.
  • Date uniquementLe type de champ est Date uniquement. Les champs Date uniquement prennent en charge des valeurs de date sans valeurs d’heure.
  • Temps seulementLe type de champ est Temps seulement. Les champs de type heure uniquement prennent en charge des valeurs d’heure sans valeurs de date.
  • Décalage de l’horodatageLe type de champ est Décalage de l’horodatage. Les champs de type décalage de l’horodatage prennent en charge des valeurs de date, d’heure et un décalage par rapport à une valeur UTC (temps universel coordonné).
  • 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.
  • 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.
  • RasterLe 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.
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 n’est applicable qu’aux champs de type Text (Texte) ou Blob (binary data) (Blob (données binaires)). Si la table est vide, la longueur du champ peut être augmentée ou réduite. Si la table n’est pas vide, la longueur ne peut être qu’augmentée à partir de la valeur actuelle.

Long
Nouveau champ IsNullable
(Facultatif)

Indique si le champ peut contenir des valeurs Null. Les valeurs Null sont prises en charge uniquement pour les champs d'une géodatabase. Ce paramètre n’est applicable que 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
Clear Alias (Effacer l’alias)
(Facultatif)

Spécifie si l’alias du champ en entrée est effacé. La valeur du paramètre New Field Alias (Nouvel alias de champ) doit être vide pour pouvoir 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

ÉtiquetteExplicationType 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})
NomExplicationType de données
in_table

Classe d’entités ou table de géosatabase en entrée contenant le champ à modifier.

Table View; Raster Layer; Mosaic Layer
field

Nom du champ à modifier. Si le champ est un champ requis, seul l’alias de champ est modifié.

Field
new_field_name
(Facultatif)

Nouveau nom du champ.

String
new_field_alias
(Facultatif)

Nouvel alias de champ du champ.

String
field_type
(Facultatif)

Spécifie le nouveau type de champ du champ. Ce paramètre n’est applicable que si la table en entrée est vide (ne contient aucun enregistrement).

  • SHORTLe champ est de type court. Les champs de type court prennent en charge les nombres entiers compris entre -32 768 et 32 767.
  • LONGLe 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.
  • BIGINTEGERLe type de champ est Entier très grand. Les champs de type entier très grand prennent en charge les nombres entiers compris entre -(253) et 253.
  • FLOATLe 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.
  • DOUBLELe 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.
  • TEXTLe champ est de type texte. Les champs de type texte prennent en charge une chaîne de caractères.
  • DATELe champ est de type date. Les champs de date prennent en charge les valeurs de date et d'heure.
  • DATEONLYLe type de champ est Date uniquement. Les champs Date uniquement prennent en charge des valeurs de date sans valeurs d’heure.
  • TIMEONLYLe type de champ est Temps seulement. Les champs de type heure uniquement prennent en charge des valeurs d’heure sans valeurs de date.
  • TIMESTAMPOFFSETLe type de champ est Décalage de l’horodatage. Les champs de type décalage de l’horodatage prennent en charge des valeurs de date, d’heure et un décalage par rapport à une valeur UTC (temps universel coordonné).
  • BLOBLe 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.
  • GUIDLe 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.
  • RASTERLe 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.
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 applicable uniquement aux champs de type TEXT ou BLOB. Si la table est vide, la longueur du champ peut être augmentée ou réduite. Si la table n’est pas vide, la longueur ne peut être qu’augmentée à partir de la valeur actuelle.

Long
field_is_nullable
(Facultatif)

Indique si le champ peut contenir des valeurs Null. Les valeurs Null sont prises en charge uniquement pour les champs d'une géodatabase. Ce paramètre n’est applicable que si la table en entrée est vide (ne contient aucun enregistrement).

  • NULLABLELe champ peut contenir des valeurs Null. Il s’agit de l’option par défaut.
  • NON_NULLABLELe champ ne peut pas contenir de valeurs Null.
Boolean
clear_field_alias
(Facultatif)

Spécifie si l’alias du champ en entrée est effacé. Le paramètre new_field_alias doit être vide pour pouvoir effacer l’alias du champ.

  • CLEAR_ALIASL'alias de champ va être effacé (défini sur Null).
  • DO_NOT_CLEARL'alias de champ ne va pas être effacé. Il s’agit de l’option par défaut.
Boolean

Sortie obtenue

NomExplicationType 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 la fonction AlterField (fenêtre Python)

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

import arcpy
arcpy.management.AlterField(
    r'C:\Data\Garbo.gdb\Khyber', 'Elev', 'ELEVATION', 'Elevation in Metres')
Exemple 2 d’utilisation de la fonction AlterField (script autonome)

Le script de fenêtre Python suivant illustre l’utilisation de la fonction AlterField dans un script autonome.

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:  # Lloop through each field
        if field.name.lower() == 'elev':  # Look for the name elev
            arcpy.management.AlterField(fc, field.name, 'ELEVATION', 'Elevation in Metres')
Exemple 3 d'utilisation de l'outil AlterField (script autonome)

Le script de fenêtre Python ci-après illustre l’utilisation de la fonction AlterField sur une classe d’entités vide dans un script autonome.

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)

Rubriques connexes