Ajouter des champs (multiple) (Gestion des données)

Synthèse

Ajoute de nouveaux champs à une table, à une classe d'entités ou à un raster.

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.

  • Pour les shapefiles et les tables dBase, si le type d'attribut définit un caractère, des blancs sont insérés pour chaque enregistrement. Si le type de champ définit un attribut numérique, des zéros sont insérés pour chaque enregistrement.

  • Les propriétés par défaut suivantes seront attribuées aux champs spécifiés par le paramètre Propriétés du champ :

    • La propriété Autoriser NULL sera définie sur False.
    • La propriété Modifiable sera définie sur True.
    • La propriété Obligatoire sera définie sur False.
    • Les propriétés Précision et Échelle sont définies par le type de champ et les valeurs par défaut de la source de données.

  • Vous pouvez ajouter des champs dans l’entrée avec le paramètre Propriétés du champ ou Tables de modèle. Si les valeurs des deux paramètres sont spécifiées, les champs sont ajoutés à partir des deux paramètres.

  • L’option Longueur du champ du paramètre Propriétés du champ s’applique uniquement aux champs de type texte.

  • Un shapefile ne prend pas en charge les alias pour les champs, donc vous ne pouvez pas ajouter d’alias de champ à un shapefile.

  • Un champ de type raster vous permet d’inclure une image raster en tant qu’attribut. Il est stocké dans ou avec la géodatabase. Cela est utile lorsqu’une image est la meilleure méthode pour décrire une entité. La précision, l'échelle et la longueur ne peuvent pas être définies pour les champs de type raster.

Paramètres

ÉtiquetteExplicationType de données
Table en entrée

La table en entrée dans laquelle seront ajoutés les champs. Les champs seront ajoutés à la table en entrée existante et aucune nouvelle table en sortie ne sera créée.

Vous pouvez ajouter des champs à des classes d'entités dans des géodatabases, des fichiers de formes, des couvertures, des tables autonomes, des catalogues d'images, des rasters avec tables attributaires et des couches.

Table View; Raster Layer; Mosaic Layer
Propriétés du champ
(Facultatif)

Les champs et leurs propriétés qui seront ajoutés à la table en entrée.

  • Nom de champ : le nom du champ qui sera ajouté à la table en entrée.
  • Field Type (Type de champ) : type du nouveau champ.
  • Alias du champ : autre nom donné au champ. Il sert à décrire les noms de champ sibyllins. Cette valeur s’applique uniquement aux géodatabases.
  • Longueur du champ : la longueur du champ en cours d'ajout. Définit le nombre maximal de caractères autorisés pour chaque enregistrement du champ. Cette option est uniquement applicable aux champs de type texte. La longueur par défaut est de 255.
  • Valeur par défaut : la valeur par défaut du champ.
  • Field Domain (Domaine du champ) : domaine de géodatabase qui sera affecté au champ.

Les types de champs disponibles sont les suivants :

  • Court (Entier 16 bits) : le champ sera 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 sera 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 champ sera de type 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 sera de type flottant. 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 sera de type double. Les champs de type réel double prennent en charge les nombres fractionnaires compris entre -2,2E308 et 1,8E308.
  • Texte : le champ sera de type texte. Les champs de type 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 de date et d'heure.
  • Date (haute précision) : le type de champ est Date en haute précision. Les champs de date en haute précision prennent en charge les valeurs de date et d’heure en millisecondes.
  • 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 de type 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 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.
  • 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.
Value Table
Tables de modèle
(Facultatif)

Tables ou classes d’entités qui seront utilisées comme un modèle pour définir les champs attributaires à ajouter.

Les champs des entrées spécifiées par ce paramètre seront ajoutés à la valeur Table en entrée en plus des champs spécifiés par le paramètre Propriétés du champ.

Table View

Sortie obtenue

ÉtiquetteExplicationType de données
Table en entrée mise à jour

Tables en entrée mises à jour.

Table View; Raster Layer; Mosaic Layer

arcpy.management.AddFields(in_table, {field_description}, {template})
NomExplicationType de données
in_table

La table en entrée dans laquelle seront ajoutés les champs. Les champs seront ajoutés à la table en entrée existante et aucune nouvelle table en sortie ne sera créée.

Vous pouvez ajouter des champs à des classes d'entités dans des géodatabases, des fichiers de formes, des couvertures, des tables autonomes, des catalogues d'images, des rasters avec tables attributaires et des couches.

Table View; Raster Layer; Mosaic Layer
field_description
[[Field Name, Field Type, {Field Alias}, {Field Length}, {Default Value}, {Field Domain}],...]
(Facultatif)

Les champs et leurs propriétés qui seront ajoutés à la table en entrée.

  • Nom de champ : le nom du champ qui sera ajouté à la table en entrée.
  • Field Type (Type de champ) : type du nouveau champ.
  • Alias du champ : autre nom donné au champ. Il sert à décrire les noms de champ sibyllins. Cette valeur s’applique uniquement aux géodatabases.
  • Longueur du champ : la longueur du champ en cours d'ajout. Définit le nombre maximal de caractères autorisés pour chaque enregistrement du champ. Cette option est uniquement applicable aux champs de type texte. La longueur par défaut est de 255.
  • Valeur par défaut : la valeur par défaut du champ.
  • Field Domain (Domaine du champ) : domaine de géodatabase qui sera affecté au champ.

Les types de champs disponibles sont les suivants :

  • SHORT : le champ sera de type court. Les champs de type court prennent en charge les nombres entiers compris entre -32 768 et 32 767.
  • LONG : le champ sera 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.
  • BIGINTEGER : le champ sera de type entier très grand. Les champs de type entier très grand prennent en charge les nombres entiers compris entre -(253) et 253.
  • FLOAT : le champ sera de type flottant. Les champs de type réel simple prennent en charge les nombres fractionnaires compris entre -3,4E38 et 1,2E38.
  • DOUBLE : le champ sera de type double. Les champs de type réel double prennent en charge les nombres fractionnaires compris entre -2,2E308 et 1,8E308.
  • TEXT : le champ sera de type texte. Les champs de type 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 de date et d'heure.
  • DATEHIGHPRECISION : le type de champ est Date en haute précision. Les champs de date en haute précision prennent en charge les valeurs de date et d’heure en millisecondes.
  • 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 de type 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 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 : 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 : 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 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.

Dans le paramètre field_description avec des paramètres facultatifs, utilisez None comme emplacement réservé vide.

Value Table
template
[template,...]
(Facultatif)

Tables ou classes d’entités qui seront utilisées comme un modèle pour définir les champs attributaires à ajouter.

Les champs des entrées spécifiées par ce paramètre seront ajoutés à la valeur in_table en plus des champs spécifiés par le paramètre field_description.

Table View

Sortie obtenue

NomExplicationType de données
out_table

Tables en entrée mises à jour.

Table View; Raster Layer; Mosaic Layer

Exemple de code

Exemple d’utilisation de l’outil AddFields (fenêtre Python)

Le script ci-dessous pour la fenêtre Python montre comment utiliser la fonction AddFields en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data/district.gdb"
arcpy.management.AddFields(
    'school', 
    [['school_name', 'TEXT', 'Name', 255, 'Hello world', ''], 
     ['street_number', 'LONG', 'Street Number', None, 35, 'StreetNumDomain'],
     ['year_start', 'DATE', 'Year Start', None, '2017-08-09 16:05:07', '']])

Rubriques connexes