Modifier le champ (Outils de gestion des données)

Résumé

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 en savoir plus et découvrir des stratégies permettant d’éviter des modifications de données non souhaitées, reportez-vous à la section Outils qui modifient ou mettent à jour les données en entrée.

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.
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é.

Etiqueter	Explication	Type 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 du champ.	String
Nouveau type de champ (Facultatif)	Indique le nouveau type 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 sera de type court. Les champs courts prennent en charge les nombres entiers compris entre -32 768 et 32 767. Long (Entier 32 bits)—Le champ sera de type long. Les champs longs 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 champ sera de type entier très grand. Les champs d’entiers très grands prennent en charge les nombres entiers compris entre -(2⁵³) et 2⁵³. Réel simple (Virgule flottante 32 bits)—Le champ sera de type réel simple. Les champs de type réel simple prennent en charge les nombres fractionnels compris entre -3,4E38 et 1,2E38. Réel double (Virgule flottante 64 bits)—Le champ sera de type réel double. Les champs de type réel double prennent en charge les nombres fractionnels compris entre -2,2E308 et 1,8E308. Texte—Le champ sera de type texte. Les champs de texte prennent en charge une chaîne de caractères. Date—Le champ sera de type date. Les champs de date prennent en charge les valeurs d’heure et de date. Date uniquement—Le champ sera de type date uniquement. Les champs Date uniquement prennent en charge des valeurs de date sans valeurs d’heure. Heure uniquement—Le champ sera de type heure uniquement. Les champs Heure uniquement prennent en charge des valeurs d’heure sans valeurs de date. Décalage de l’horodatage—Le champ sera de type décalage de l’horodatage. Les champs Décalage de l’horodatage prennent en charge des valeurs de date, d’heure et un décalage par rapport à une valeur de temps universel coordonné (UTC). BLOB (données binaires)—Le champ sera de type BLOB. Les champs BLOB prennent en charge les données stockées sous forme d’une 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. Raster—Le champ sera de type raster. Les champs raster peuvent stocker des 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 en entrée est vide (ne contient aucun enregistrement). Activé—Le champ peut contenir des valeurs Null. Il s’agit de l’option par défaut. Décoché—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é. Le paramètre `new_field_alias` doit être vide pour que l’alias du champ puisse être effacé. Activé—L'alias de champ va être effacé (défini sur Null). Décoché—L'alias de champ ne va pas être effacé. Il s’agit de l’option par défaut.	Boolean

Sortie dérivée

Etiqueter	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é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 du champ.	String
field_type (Facultatif)	Indique le nouveau type du champ. Ce paramètre n’est applicable que si la table en entrée est vide (ne contient aucun enregistrement). `SHORT`—Le champ sera de type court. Les champs courts prennent en charge les nombres entiers compris entre -32 768 et 32 767. `LONG`—Le champ sera de type long. Les champs longs prennent en charge les nombres entiers compris entre -2 147 483 648 et 2 147 483 647. `BIGINTEGER`—Le champ sera de type entier très grand. Les champs d’entiers très grands prennent en charge les nombres entiers compris entre -(2⁵³) et 2⁵³. `FLOAT`—Le champ sera de type réel simple. Les champs de type réel simple prennent en charge les nombres fractionnels compris entre -3,4E38 et 1,2E38. `DOUBLE`—Le champ sera de type réel double. Les champs de type réel double prennent en charge les nombres fractionnels compris entre -2,2E308 et 1,8E308. `TEXT`—Le champ sera de type texte. Les champs de texte prennent en charge une chaîne de caractères. `DATE`—Le champ sera de type date. Les champs de date prennent en charge les valeurs d’heure et de date. `DATEONLY`—Le champ sera de type date uniquement. Les champs Date uniquement prennent en charge des valeurs de date sans valeurs d’heure. `TIMEONLY`—Le champ sera de type heure uniquement. Les champs Heure uniquement prennent en charge des valeurs d’heure sans valeurs de date. `TIMESTAMPOFFSET`—Le champ sera de type décalage de l’horodatage. Les champs Décalage de l’horodatage prennent en charge des valeurs de date, d’heure et un décalage par rapport à une valeur de temps universel coordonné (UTC). `BLOB`—Le champ sera de type BLOB. Les champs BLOB prennent en charge les données stockées sous forme d’une 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`—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. `RASTER`—Le champ sera de type raster. Les champs raster peuvent stocker des 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). `NULLABLE`—Le champ peut contenir des valeurs Null. Il s’agit de l’option par défaut. `NON_NULLABLE`—Le 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 (Nouvel alias de champ) doit être vide pour que l’alias du champ puisse être effacé. `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 dérivée

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 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 AlterField (script autonome)

Le script de fenêtre Python ci-dessous 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 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

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

Environnements

Espace de travail courant

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui

Modifier le champ (Outils de gestion des données)

Résumé

Utilisation

Attention :

Paramètres

Sortie dérivée

Environnements

Informations de licence

Rubriques connexes