Ajouter des données (GeoAnalytics)

Synthèse

Cet outil ajoute des données à une couche d’entités hébergée existante.

Héritage :

L’extension ArcGIS GeoAnalytics Server devient obsolète dans ArcGIS Enterprise. La dernière version de GeoAnalytics Server a été incluse avec ArcGIS Enterprise 11.3. Cet outil de géotraitement est accessible via ArcGIS Enterprise 11.3 et versions antérieures.

Illustration

Processus Ajouter des données

Utilisation

• Cet outil de géotraitement est disponible avec ArcGIS Enterprise 10.6.1 ou version ultérieure.

• La valeur du paramètre Input Layer (Couche en entrée) doit être une couche tabulaire, surfacique, linéaire ou de points hébergée existante. Pour ajouter des données à un autre type de couche, vous devez d'abord créer une couche hébergée du jeu de ces données. Pour ce faire, utilisez l’outil Copier dans un data store ou partagez une couche sur votre portail. Pour en savoir plus sur le partage des couches, reportez-vous à la rubrique Introduction au partage des couches Web.

• La valeur du paramètre Append Layer (Couche d’ajout) peut être une couche d’entités ou un jeu de données tabulaires, surfaciques, linéaires ou ponctuelles de partage de fichiers Big Data.

• La valeur Append Layer (Couche d’ajout) et la valeur Input Layer (Couche en entrée) doivent avoir le même type de géométrie. Par exemple, vous pouvez ajouter des entités tabulaires à d’autres entités tabulaires ou des entités ponctuelles à d'autres entités ponctuelles. Il est impossible d'ajouter des entités dont les types de géométrie sont différents.

• La valeur Append Layer (Couche d’ajout) et la valeur Input Layer (Couche en entrée) doivent avoir le même type temporel. Ces types sont notamment l’instant, l’intervalle ou aucun.

• Les champs, la géométrie et la date/l’heure de la valeur Input Layer (Couche en entrée) ne sont pas modifiés.

• Vous pouvez ajouter des entités avec l’une des deux méthodes suivantes :

  • Append matching fields only (Ajouter uniquement les champs d'appariement) : seuls les champs dont les noms et les types sont appariés sont ajoutés. Il s’agit de l’option par défaut.
  • Append matching fields and resolve differences (Ajouter les champs d’appariement et résoudre les différences) : utilisez les paramètres Append Fields (Ajouter des champs) ou Append Expressions (Ajouter des expressions) pour apparier les champs dont les noms sont différents ou pour calculer les valeurs des champs spécifiés.

    En savoir plus sur les expressions Ajouter des données

• Tout champ Append Layer (Couche d’ajout) non apparié dans le paramètre Append Fields (Ajouter des champs) ou Append Expressions (Ajouter des expressions) est exclu des résultats ajoutés.

  Par exemple, des chercheurs étudiant les migrations humaines souhaitent ajouter des jeux de données aux structures de la couche en entrée et de la couche d'ajout illustrées ci-dessous. Les deux couches ont en commun le champ Country de type texte et toutes deux ont deux champs supplémentaires dotés du même type de données, mais des noms uniques. La couche en entrée possède les champs Pop_ et Pop_Density, et la couche d’ajout possède les champs Population et area_km2. Les chercheurs souhaitent apparier le champ Country avec le champ Country, ajouter le champ Population au champ Pop_ et calculer la densité de population pour le champ Pop_Density à l’aide d’une formule mathématique.

  

  Exemples de structure de couche en entrée et de couche d’ajout à utiliser dans l’outil Ajouter des données

  Par défaut, l’outil Ajouter des données apparie les champsCountry, étant donné que leur nom et leur type sont identiques. Par défaut, les champs Pop_ et Pop_Density n’ont aucun appariement dans la couche d’ajout et des valeurs nulles leur sont ajoutées.

  

  Appariement de champs par défaut appliqué lorsque l’option Append matching fields only (Ajouter uniquement les champs d’appariement) est sélectionnée pour le paramètre Append Method (Méthode d’ajout).

  Sélectionnez l’option Append matching fields and resolve differences (Ajouter les champs d’appariement et résoudre les différences) pour le paramètre Append Method (Méthode d’ajout) afin de définir des spécifications personnalisées d’appariement de champs. Utilisez le paramètre Append Fields (Ajouter des champs) pour ajouter le champ Input Field (Champ en entrée) Pop_ avec des valeurs provenant du champ Append Field (Champ d’ajout) Population. Utilisez le paramètre Append Expressions (Ajouter des expressions) pour calculer les valeurs Pop_Density des entités d’ajout à l’aide des champs de la couche d’ajout Population et area_km2 en générant l’expression Arcade suivante : $feature["Population"]/$feature["area_km2"].

  

  Appariement de champs défini, tel que spécifié par les paramètres Append Fields (Ajouter des champs) et Append Expressions (Ajouter des expressions).

• Cet outil de géotraitement est mis en œuvre par ArcGIS GeoAnalytics Server. L’analyse est réalisée sur GeoAnalytics Server et les résultats sont stockés dans votre contenu dans ArcGIS Enterprise.

• Lors de l’exécution des outils GeoAnalytics Server, l’analyse est réalisée sur GeoAnalytics Server. Pour des performances optimales, GeoAnalytics Server doit pouvoir accéder aux données via les couches d’entités hébergées sur votre portail ArcGIS Enterprise ou les partages de fichiers Big Data. Les données qui ne sont pas locales pour GeoAnalytics Server sont transférées sur GeoAnalytics Server avant le début de l’analyse. Autrement dit, l’exécution d’un outil prend plus de temps et, dans certains cas, le transfert des données depuis ArcGIS Pro vers GeoAnalytics Server peut échouer. Le seuil d’échec dépend aussi bien des débits du réseau que de la taille et de la complexité des données. Il est recommandé de toujours partager les données ou de créer un partage de fichiers Big Data.

  Pour en savoir plus sur le partage des données dans votre portail.

  En savoir pus sur la création d’un partage de fichiers Big Data via ArcGIS Server Manager

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Couche en entrée	Couche d’entités hébergée à laquelle des entités sont ajoutées.	Record Set
Couche d'ajout	Couche contenant les entités à ajouter à la couche en entrée.	Record Set
Méthode d’ajout (Facultatif)	Spécifie la manière dont les champs de la couche en entrée sont ajoutés avec les valeurs de la couche d’ajout. Ajouter uniquement les champs d'appariement—Des valeurs sont ajoutées aux champs de la couche en entrée uniquement s’ils possèdent un champ d’appariement dans la couche d’ajout. Si un champ n'a pas de correspondance, une valeur nulle lui est ajoutée. Ajouter les champs d'appariement et résoudre les différences—Les champs de la couche en entrée peuvent être alimentés par les valeurs des champs de la couche d’ajout ayant le même nom, mais un type distinct ou par les valeurs calculées à partir d’expressions Arcade.	String
Ajouter des champs (Facultatif)	Champs de la couche d’ajout ayant le même type, mais pas le même nom que les champs de la couche en entrée auxquels ils sont ajoutés. Sélectionnez le champ en entrée auquel vous souhaitez faire un ajout, ainsi que le champ d’ajout contenant les valeurs à ajouter.	Value Table
Expressions d'ajout (Facultatif)	Expressions Arcade utilisées pour calculer les valeurs du champ en entrée. Les expressions sont écrites en langage Arcade et peuvent inclure des opérateurs mathématiques et plusieurs champs. Sélectionnez les champs auxquels vous souhaitez faire un ajout, puis fournissez pour chacun une expression afin de calculer les valeurs à ajouter. Si la couche est ajoutée à la carte, les champs et les assistants permettent de construire une expression.	Value Table

Sortie obtenue

Étiquette	Explication	Type de données
Résultat d’ajout	Entrée mise à jour à laquelle les entités ont été ajoutées.	Record Set

Python

arcpy.geoanalytics.AppendData(input_layer, append_layer, {append_method}, {append_fields}, {append_expressions})

Nom	Explication	Type de données
input_layer	Couche d’entités hébergée à laquelle des entités sont ajoutées.	Record Set
append_layer	Couche contenant les entités à ajouter à la couche en entrée.	Record Set
append_method (Facultatif)	Spécifie la manière dont les champs de la couche en entrée sont ajoutés avec les valeurs de la couche d’ajout. MATCHING_ONLY—Des valeurs sont ajoutées aux champs de la couche en entrée uniquement s’ils possèdent un champ d’appariement dans la couche d’ajout. Si un champ n'a pas de correspondance, une valeur nulle lui est ajoutée. FIELD_MAPPING—Les champs de la couche en entrée peuvent être alimentés par les valeurs des champs de la couche d’ajout ayant le même nom, mais un type distinct ou par les valeurs calculées à partir d’expressions Arcade.	String
append_fields [append_fields,...] (Facultatif)	Champs de la couche d’ajout ayant le même type, mais pas le même nom que les champs de la couche en entrée auxquels ils sont ajoutés. Sélectionnez le champ en entrée auquel vous souhaitez faire un ajout, ainsi que le champ d’ajout contenant les valeurs à ajouter.	Value Table
append_expressions [append_expressions,...] (Facultatif)	Expressions Arcade utilisées pour calculer les valeurs du champ en entrée. Les expressions sont écrites en langage Arcade et peuvent inclure des opérateurs mathématiques et plusieurs champs.	Value Table

Sortie obtenue

Nom	Explication	Type de données
append_result	Entrée mise à jour à laquelle les entités ont été ajoutées.	Record Set

Exemple de code

Exemple d'utilisation de la fonction AppendData (script autonome)

Le script autonome ci-dessous illustre l’utilisation de la fonction AppendData.

# Description: Append February 2018 sales records to the ANNUAL_SALES2018 
#              hosted layer.
#              
#	Caution: AppendData updates the ANNUAL_SALES2018 layer with appended 
#          features.

# Requirements: ArcGIS GeoAnalytics Server

# Import system modules
import arcpy

# Set local variables
inputLayer = "https://sampleserver6.arcgisonline.com/arcgis/rest/services/ANNUAL_SALES2018/FeatureServer/0"
appendLayer = "https://sampleserver6.arcgisonline.com/arcgis/rest/services/DataStoreCatalogs/bigDataFileShares_sales2018/BigDataCatalogServer/FEBRUARY_SALES2018"
appendMethod = "FIELD_MAPPING"
fieldMapping = "Pop_ Population;State_ StateName", 
expressionMapping = "Pop_density $feature.Population/$feature.area_km2;Unused_field null"

# Run Append Data
arcpy.geoanalytics.AppendData(inputLayer, appendLayer, appendMethod, 
                              fieldMapping, expressionMapping)

Environnements

Étendue, Espace de travail courant

Informations de licence

• Basic: Nécessite ArcGIS GeoAnalytics Server
• Standard: Nécessite ArcGIS GeoAnalytics Server
• Advanced: Nécessite ArcGIS GeoAnalytics Server