Ajouter (Outils de gestion des données)

Résumé

Ajoute plusieurs jeux de données en entrée à un jeu de données cible existant et met à jour un jeu de données cible existant avec plusieurs jeux de données en entrée. Les jeux de données en entrée peuvent être des classes d’entités, des tables, des shapefiles, des rasters ou des classes d’entités annotations ou cotation. Les entrées peuvent également être des services d’entités hébergés.

Pour combiner des jeux de données en entrée dans un nouveau jeu de données en sortie, utilisez l’outil Fusionner.

Illustration

Utilisation

• Utilisez cet outil pour ajouter de nouvelles entités ou d’autres données de plusieurs jeux de données à un jeu de données existant. Cet outil ajoute des classes d’entités ponctuelles, linéairees ou surfaciques, des tables, des rasters, des classes d’entités annotations ou des classes d’entités cotation à un jeu de données existant du même type. Par exemple, plusieurs tables peuvent être ajoutées à une table existante, ou plusieurs rasters peuvent être ajoutés à un jeu de données raster existant, mais une classe d’entités linéaires ne peut pas être ajoutée à une classe d’entités ponctuelles.

• Utilisez le paramètre Field Map (Appariement des champs) pour contrôler la manière dont les informations attributaires des champs des jeux de données en entrée sont transférées vers le jeu de données cible. Le paramètre Field Map (Appariement des champs) peut uniquement être utilisé si Use the field map to reconcile field differences (Utiliser l’appariement des champs pour réconcilier les différences de champs) est spécifié pour le paramètre Field Matching Type (Type d’appariement de champs).

• Utilisez le paramètre Field Map (Appariement des champs) pour apparier ou faire correspondre les champs des jeux de données en entrée aux champs du jeu de données cible.

  • Utilisez une action pour identifier la manière dont les valeurs d’un ou de plusieurs champs du jeu de données en entrée sont appariés à un seul champ du jeu de données cible.

  • Les actions disponibles sont First (Premier), Last (Dernier), Concatenate (Concaténer), Sum (Somme), Mean (Moyenne), Median (Médiane), Mode, Minimum, Maximum, Standard Deviation (Écart type) et Count (Total).

  • Lorsque vous utilisez l’action Concatenate (Concaténer), vous pouvez spécifier un délimiteur, comme une virgule ou d’autres caractères. Cliquez au début de la zone de texte Delimiter (Délimiteur) pour ajouter les caractères de délimitation.

  • L’option Standard Deviation (Écart type) n’est pas valide pour une seule valeur en entrée.

  • L’option Export (Exporter) permet d’enregistrer un appariement des champs sous forme de fichier .fieldmap.

  • L’option Load (Charger) permet de charger un fichier .fieldmap. La couche d’entités ou le jeu de données spécifié dans le fichier doit correspondre à celui utilisé dans l’outil. Sinon, le paramètre Field Map (Appariement des champs) est réinitialisé.

  • Utilisez le bouton Slice Text (Découper le texte) sur les champs source du texte pour sélectionner les caractères d’une valeur en entrée à extraire dans le champ cible. Pour accéder au bouton Slice Text (Découper le texte), survolez un champ de texte dans la liste des champs en entrée, puis spécifiez les positions des caractères de début et de fin.

  • Il est également possible d’apparier des champs dans un script Python.

• Dans Python, lorsque vous utilisez l’objet FieldMappings pour le paramètre field_mapping, ajoutez d’abord les champs du jeu de données cible comme indiqué dans le code ci-dessous. Les champs en entrée sont appariés à la structure des champs cibles. Lorsque les champs en entrée sont ajoutés en premier, l’appariement de champs peut être réinitialisé ou se comporter de manière inattendue.

  fieldmappings = arcpy.FieldMappings()
  fieldmappings.addTable(target)
  fieldmappings.addTable(input)
  

• Cet outil ne planarise pas les entités lorsqu’elles sont ajoutées au jeu de données cible. Toutes les entités de la classe d’entités en entrée et de la classe d’entités cible restent intactes après l’ajout, même en cas de superposition des entités. Pour combiner, ou planariser, les géométries d’entité, utilisez l’outil Union.

• Si le paramètre Field Matching Type (Type d’appariement de champs) est défini sur Input fields must match target fields (Les champs en entrée doivent correspondre aux champs cible), la structure des jeux de données en entrée doit correspondre à celle du jeu de données cible auquel les entités sont ajoutées.

  Si le paramètre Field Matching Type (Type d’appariement de champs) est défini sur Use the field map to reconcile field differences (Utiliser l’appariement des champs pour réconcilier les différences de champs), il n’est pas nécessaire que les structures correspondent. Les champs des jeux de données en entrée qui ne correspondent pas aux champs du jeu de données cible ne sont pas appariés au jeu de données cible sauf si l’appariement est défini dans le paramètre Field Map (Appariement des champs). Les champs du jeu de données cible qui ne sont pas appariés aux champs des jeux de données en entrée contiennent des valeurs nulles.

  Si le paramètre Field Matching Type (Type d’appariement de champs) est défini sur Skip and warn if schema does not match (Ignorer et avertir si la structure ne correspond pas), la structure des jeux de données en entrée doit correspondre à celle du jeu de données cible pour que les entités soient ajoutées. Si un jeu de données en entrée contient des champs qui ne correspondent pas aux champs du jeu de données cible, ce jeu de données en entrée est omis.

• Le nombre de lignes ajoutées s’affiche dans les messages de l’outil et est renvoyé par la sortie Appended Row Count (Nombre de lignes ajoutées).

• Puisque les données des jeux de données en entrée sont écrites dans un jeu de données cible existant doté d’une structure prédéfinie, vous ne pouvez pas utiliser le paramètre Field Map (Appariement des champs) pour ajouter des champs au jeu de données cible ou pour en retirer.

• Vous pouvez utiliser cet outil pour insérer de nouveaux enregistrements et mettre à jour des enregistrements existants dans un jeu de données cible lors d’une même opération (qui équivaut à une opération de base de données UPSERT). Utilisez le paramètre Matching Fields for Update (Champs d’appariement pour la mise à jour) afin de spécifier les champs du jeu de données en entrée qu’il convient d’apparier aux champs du jeu de données cible. Dans le cas des enregistrements qui comportent des valeurs de champ correspondantes, les champs de l’enregistrement cible sont mis à jour avec les valeurs des champs dotés du même nom dans l’enregistrement en entrée. Le nombre de lignes mises à jour avec les champs appariés s’affiche dans les messages de l’outil et est renvoyé par la sortie Updated Row Count (Nombre de lignes mises à jour). La géométrie est mise à jour si le paramètre Update Geometry (Mettre à jour la géométrie) est coché.

• Les jeux de données cible et en entrée peuvent inclure des références spatiales différentes. Si tel est le cas, l’outil projette les entités en entrée dans le système de coordonnées de la cible. Dans un souci d’optimisation des résultats, spécifiez une transformation géographique appropriée à l’aide de l’environnement Transformations géographiques. Si le jeu de données cible est une couche de carte, il se peut que l’outil applique une transformation par défaut. Dans Python, il n’y a pas de transformation par défaut.

• Cet outil ne procède pas à l’appariement des arêtes ; aucun ajustement n’est effectué sur la géométrie des entités.

• Il est possible d’utiliser des couches de carte en tant que valeurs du paramètre Input Datasets (Jeux de données en entrée). Si une couche a une sélection, seuls les enregistrements sélectionnés (entités ou lignes de table) sont utilisés.

• Il n’est pas possible d’utiliser plusieurs couches en entrée portant le même nom dans cet outil. Utilisez à la place le bouton de navigation de la fenêtre Geoprocessing (Géotraitement) pour accéder aux chemins complets de chacune des valeurs du champ Input Datasets (Jeux de données en entrée).

• Si un jeu de données en entrée et le jeu de données cible portent le même nom, les performances de l’outil sont réduites.

• Pour utiliser le paramètre Subtype (Sous-type), un champ de sous-type doit être défini et des codes de sous-type doivent être affectés pour le jeu de données cible. Dans le paramètre Subtype (Sous-type), indiquez une description de sous-type pour affecter ce sous-type à toutes les nouvelles données ajoutées au jeu de données cible.

• Utilisez le paramètre Enforce Domains (Appliquer des domaines) pour appliquer des domaines attributaires aux champs du jeu de données cible. Lorsque ce paramètre est coché, l’outil respecte les valeurs de domaine définies dans le jeu de données cible. Les données issues des champs en entrée et qui ne sont pas conformes à ces valeurs de domaine seront insérées comme des valeurs nulles.

• Les éléments suivants concernent la mise à jour des champs du jeu de données cible :

  • Utilisez cet outil pour insérer de nouveaux enregistrements et mettre à jour des enregistrements existants dans un jeu de données cible lors d’une même opération (qui équivaut à une opération de base de données UPSERT). Utilisez le paramètre Matching Fields for Update (Champs d’appariement pour la mise à jour) afin de spécifier les champs du jeu de données en entrée qu’il convient d’apparier aux champs du jeu de données cible.

  • Par défaut, pour les enregistrements contenant des valeurs de champ correspondantes, les champs de l’enregistrement cible seront mis à jour avec des valeurs issues de l’entrée s’ils portent le même nom de champ. Le nombre de lignes mises à jour avec des champs appariés s’affiche dans les messages de l’outil et est renvoyé par le paramètre dérivé Updated Row Count (Nombre de lignes mises à jour).

  • Le paramètre Candidate Fields (Champs candidats) peut être utilisé pour mettre à jour ou insérer de manière sélective des champs dans le jeu de données cible. Par exemple, pour un jeu de données cible contenant des champs nommés f1, f2, f3 et f4, vous pouvez spécifier que seuls les champs f3 et f4 seront mis à jour pour les lignes cible. Pour les opérations d’insertion, seuls les champs f3 et f4 seront insérés.

  • La géométrie est mise à jour si le paramètre Update Geometry (Mettre à jour la géométrie) est coché.

  • Pour mettre à jour uniquement la géométrie et non les champs attributaires dans le jeu de données cible, assurez-vous que le paramètre Update Geometry (Mettre à jour la géométrie) est coché et que le champ Shape (Forme) est le seul champ spécifié dans le paramètre Candidate Fields (Champs candidats). Si la cible est un service d’entités, reportez-vous plus bas à la section Utilisation.

  • Le paramètre Skip Options (Options d’omission) comporte les options suivantes pour contrôler le comportement des lignes mises à jour et insérées :

    • Do not skip updates or inserts (Ne pas ignorer les mises à jour ou les insertions) : toutes les lignes contenant des champs appariés seront mises à jour dans la cible, et toutes les lignes non appariées de l’entrée seront insérées.
    • Skip inserts for unmatched rows (update only) (Ignorer les insertions pour les enregistrements non appariés [mise à jour seulement]) : toutes les lignes contenant des champs appariés seront mises à jour dans la cible. Les lignes non appariées du jeu de données en entrée ne seront pas insérées.
    • Skip updates for matched rows (insert only) (Ignorer les mises à jour pour les enregistrements appariés [insertion seulement]) : aucune ligne contenant des champs appariés ne sera mise à jour dans la cible. Seules les lignes non appariées de l’entrée seront insérées.

• Les éléments suivants concernent les services d’entités :

  • Pour des performances optimales, utilisez cet outil directement sur la base de données, le serveur ou le data store principal des couches d’entités Web. Dans le cas de services d’entités qui référencent une géodatabase, utilisez une connexion à une base de données pour procéder à des opérations de chargement de données volumineuses directement dans la base de données sous-jacente. Pour les services hébergés sur ArcGIS Enterprise, utilisez l’opération append à partir de la page des éléments de la couche d’entités ou depuis ArcGIS REST API.

  • Pour des performances optimales avec les services hébergés sur ArcGIS Online et ArcGIS Enterprise, les administrateurs et les propriétaires de services peuvent utiliser cet outil avec ArcGIS REST API si la propriété supportAppend a pour valeur true. Les fonctionnalités d’ajout des services d’entités doivent être activées pour que les utilisateurs qui ne sont pas des administrateurs puissent utiliser cet outil avec ArcGIS REST API. Dans le cas de couches d’entités hébergées ArcGIS Enterprise, la fonctionnalité Uploads doit être activée.

  • Le paramètre Optimize performance for feature services (Optimiser les performances de services d’entités) est uniquement pris en charge si le jeu de données cible prend en charge les fonctionnalités d’ajout de services d’entités. Lorsque ce paramètre est activé, l’outil effectue les opérations suivantes :

    • L’outil utilise ArcGIS REST API pour optimiser les performances.

    • Le paramètre Input Datasets (Jeux de données en entrée) est limité à un seul jeu de données.

    • Les paramètres Expression et Enforce Domains (Appliquer des domaines) ne sont pas pris en charge.

    • Le paramètre Matching Fields for Update (Champs d’appariement pour la mise à jour) est limité à une paire de champs d’appariement.

    • Toutes les opérations de mise à jour et d’insertion sont prises en compte dans la valeur Appended Row Count (Nombre de lignes ajoutées) en sortie.

  • Lorsque cet outil est exécuté dans une session de mise à jour existante ou que le bouton bascule Enable Undo (Activer l’annulation) est activé, le paramètre Optimize performance for feature services (Optimiser les performances de services d’entités) est ignoré.

  • Si le paramètre Optimize performance for feature services (Optimiser les performances de services d’entités) est coché et que les valeurs de paramètre Matching Fields for Update (Champs d’appariement pour la mise à jour) ont un champ Global ID correspondant, les valeurs Global ID (ID global) sont conservées. Si les champs Global ID ne sont pas inlus, toutes les lignes en entrée sont insérées et de nouvelles valeurs Global ID (ID global) sont attribuées.

  • Pour mettre à jour uniquement la géométrie du jeu de données cible, cochez le paramètre Update Geometry (Mettre à jour la géométrie) et assurez-vous que le paramètre Candidate Fields (Champs candidats) contient uniquement le nom du champ d’appariement. Par exemple, si la valeur du paramètre Matching Fields for Update (Champs d’appariement pour la mise à jour) utilise le champ globalid, alors le paramètre Candidate Fields (Champs candidats) ne devrait contenir que le champ globalid.

Paramètres

• Dialog
• Python

Etiqueter	Explication	Type de données
Jeux de données en entrée	Jeux de données en entrée dont les données seront ajoutées dans le jeu de données cible. Les jeux de données en entrée peuvent être des classes d’entités ponctuelles, linéaires ou surfaciques, des tables, des rasters, des classes d’entités annotations ou des classes d’entités cotation. Les tables et les classes d’entités peuvent être combinées. Si une classe d’entités est ajoutée à une table, les attributs sont transférés ; les entités sont toutefois supprimées. Si une table est ajoutée à une classe d’entités, les lignes de la table en entrée présentent une géométrie nulle.	Table View; Raster Layer
Jeu de données cible	Jeu de données existant auquel les données des jeux de données en entrée sont ajoutées.	Table View; Raster Layer
Type d’appariement de champs (Facultatif)	Indique si les champs des jeux de données en entrée doivent correspondre aux champs du jeu de données cible pour que les données soient ajoutées. Les champs en entrée doivent correspondre aux champs cible—Les champs des jeux de données en entrée doivent correspondre aux champs du jeu de données cible. Une erreur est renvoyée si les champs ne correspondent pas. Il s’agit de l’option par défaut. Utiliser l’appariement des champs pour réconcilier les différences de champs—Il n’est pas nécessaire que les champs des jeux de données en entrée correspondent aux champs du jeu de données cible. Les champs des jeux de données en entrée qui ne correspondent pas aux champs du jeu de données cible ne sont pas appariés au jeu de données cible, sauf si l’appariement est explicitement défini dans le paramètre Field Map (Appariement des champs). Skip and warn if schema does not match (Ignorer et avertir si la structure ne correspond pas)—Les champs des jeux de données en entrée doivent correspondre aux champs du jeu de données cible. Si l’un des jeux de données en entrée contient des champs qui ne correspondent pas au jeu de données cible, ce jeu de données en entrée est omis avec un message d’avertissement.	String
Appariement des champs (Facultatif)	Le paramètre d’appariement des champs contrôle le transfert ou l’appariement des champs des jeux de données en entrée vers le jeu de données cible. Il ne peut être utilisé que si le paramètre Field Matching Type (Type d’appariement de champs) est défini sur Use the field map to reconcile field differences (Utiliser l’appariement des champs pour réconcilier les différences de champs). Les jeux de données en entrée étant ajoutés à un jeu de données cible existant qui possède des champs prédéfinis, vous ne pouvez pas ajouter, supprimer, réorganiser ou modifier les propriétés des champs dans l’appariement des champs. L’appariement des champs peut servir à combiner les valeurs d’un ou de plusieurs champs en entrée en un seul champ en sortie.	Field Mappings
Sous-type (Facultatif)	Description de sous-type affectée à toutes les nouvelles données ajoutées au jeu de données cible.	String
Expression (Facultatif)	Expression SQL employée pour sélectionner un sous-ensemble d’enregistrements des jeux de données en entrée. Si plusieurs jeux de données en entrée sont spécifiés, ils seront tous évalués à l’aide de cette expression. Si aucun enregistrement ne correspond à l’expression pour un jeu de données en entrée, aucun enregistrement de ce jeu de données n’est ajouté au jeu de données cible. Pour plus d’informations sur la syntaxe SQL, reportez-vous à la rubrique Référence SQL pour les expressions de requête utilisées dans ArcGIS.	SQL Expression
Matching Fields for Update (Champs d’appariement pour la mise à jour) (Facultatif)	Champs des jeux de données en entrée utilisés pour la correspondance avec le jeu de données cible. Si les valeurs de ces champs correspondent, les enregistrements des jeux de données en entrée mettent à jour les enregistrements correspondants du jeu de données cible. Colonnes de la table de valeurs : Target Fields—The fields from the target dataset that will be matched. Input Fields—The fields from the input dataset that will be matched.	Value Table
Update Geometry (Mettre à jour la géométrie) (Facultatif)	Indique si la géométrie du jeu de données cible est mise à jour avec la géométrie des jeux de données en entrée si les valeurs de champ du paramètre match_fields correspondent. Activé—La géométrie du jeu de données cible est mise à jour si les valeurs de champ du paramètre match_fields correspondent. Décoché—La géométrie n’est pas mise à jour. Il s’agit de l’option par défaut.	Boolean
Appliquer des domaines (Facultatif)	Indique si les domaines de champ de la cible sont appliqués. Activé—Les domaines de champ de la cible sont appliqués. Si une valeur de champ en entrée se situe en dehors de la définition de domaine d’un champ cible, l’enregistrement est inséré, mais la valeur du champ en entrée est nulle. Si des champs d’appariement pour la mise à jour sont indiqués, le champ cible n’est pas mis à jour. Les messages de l’outil incluent un message d’avertissement qui indique les lignes pour lesquelles les valeurs de champ en sortie ne peuvent pas être écrites. Décoché—Les domaines de champ de la cible ne sont pas appliqués. Il s’agit de l’option par défaut.	Boolean
Optimize performance for feature services (Optimiser les performances de services d’entité) (Facultatif)	Indique si les performances sont optimisées lorsque le jeu de données cible est un service d’entités ArcGIS Online ou ArcGIS Enterprise. Ce paramètre est actif uniquement si le jeu de données cible prend en charge l’optimisation. Activé—Les performances de l’outil seront optimisées si le jeu de données cible est un service d’entités avec la fonctionnalité Append (Ajouter) activée. Il s’agit de l’option par défaut en cas de prise en charge par le service d’entités cible. L’optimisation utilise le traitement côté serveur dans lequel les données en entrée sont envoyées au service d’entités Append API (Ajouter API) et chargées dans le jeu de données de manière asynchrone. Si le paramètre est coché, les paramètres Expression et Enforce Domains (Appliquer des domaines) ne sont pas pris en charge, et l’utilisation du paramètre Matching Fields for Update (Champs d’appariement pour la mise à jour) est limitée à un jeu de données en entrée et à une paire de champs. Décoché—Les performances de l’outil ne seront pas optimisées si la cible est un service d’entités.	Boolean
Candidate Fields (Champs candidats) (Facultatif)	Champs qui seront mis à jour ou insérés dans le jeu de données cible. Utilisez ce paramètre si vous souhaitez qu’un sous-ensemble de champs soit mis à jour ou inséré dans le jeu de données cible. Lors de l’insertion de nouveaux enregistrements, les champs qui ne figurent pas dans cette liste ont des valeurs nulles.	Field
Skip Options (Options d’omission) (Facultatif)	Indique si les mises à jour ou les insertions sont ignorées lorsque le paramètre Matching Fields for Update (Champs d’appariement pour la mise à jour) est spécifié. Do not skip updates or inserts (Ne pas ignorer les mises à jour ou les insertions)—Les enregistrements cibles contenant des champs appariés sont mis à jour et les enregistrements en entrée sans appariements sont insérés dans le jeu de données cible. Il s’agit de l’option par défaut. Skip inserts for unmatched rows (update only) (Ignorer les insertions pour les enregistrements non appariés [mise à jour seulement])—Les enregistrements en entrée qui ne contiennent pas de champs appariés ne sont pas insérés dans le jeu de données cible. Cette option ne met à jour que les enregistrements du jeu de données cible qui contiennent des champs appariés. Skip updates for matched rows (insert only) (Ignorer les mises à jour pour les enregistrements appariés [insertion seulement])—Les enregistrements cibles contenant des champs appariés des jeux de données en entrée ne sont pas mis à jour. Cette option insère uniquement les nouveaux enregistrements du jeu de données en entrée qui ne contiennent pas de champs appariés.	String

Sortie dérivée

Etiqueter	Explication	Type de données
Jeu de données cible mis à jour	Jeu de données cible mis à jour.	Table View; Raster Layer
Appended Row Count (Nombre de lignes ajoutées)	Nombre de lignes ajoutées au jeu de données cible. Si le paramètre Optimize performance for feature services (Optimiser les performances de services d’entités) est coché et que la valeur du paramètre Matching Fields for Update (Champs d’appariement pour la mise à jour) est spécifiée, toutes les opérations de mise à jour et d’insertion seront prises en compte.	Long
Updated Row Count (Nombre de lignes mises à jour)	Nombre de lignes mises à jour dans le jeu de données cible. Le nombre de lignes mises à jour n’est pas indiqué pour les jeux de données de services d’entités cibles lorsque le paramètre Optimize performance for feature services (Optimiser les performances de services d’entité) est coché.	Long

Environnements

Étendue, Espace de travail courant, Conserver les ID globaux, Conserver les pièces jointes, Transformations géographiques

Cas particuliers

Conserver les ID globaux

For the Append tool, this environment will only preserve Global ID values from the input dataset if the target Global ID field has a unique index. If the target Global ID field does not have a unique index, the tool may fail. To add a unique index to a Global ID field, use the Add Attribute Index tool.

If the target dataset contains a Global ID field and the input data does not, running the Append tool with this environment set to True will automatically generate new Global ID values for inserted rows.

This environment is ignored for target feature services. To preserve Global IDs for feature services that support optimization, check the Optimize performance for feature services parameter and specify GlobalID as the match fields in the Matching Fields for Update parameter.

Informations de licence

• Basic: Oui
• Standard: Oui
• Advanced: Oui

Rubriques connexes

• Vue d’ensemble du jeu d’outils Général
• Rechercher un outil de géotraitement
• Apparier des champs attributaires
• Fusionner
• Union
• Appariement des champs en entrée aux champs en sortie