Couche d’entités

Le type de source Couche d’entités d’ArcGIS Velocity charge les entités d’une couche d’entités ArcGIS Online ou ArcGIS Server.

Exemples

Les exemples suivants utilisent la source Couche d’entités :

  • Un utilisateur sélectionne une couche d’entités hébergée ArcGIS Online contenant les entités à charger.
  • Un analyste SIG fournit l’URL d’une couche d’entités ArcGIS Server (par exemple )https://sampleserver6.arcgisonline.com/arcgis/rest/services/Wildfire/FeatureServer/2 contenant les entités à charger.
  • Un chef d’équipe sur le terrain charge des données d’une couche de suivi d’emplacement pour analyser les traces collectées par ArcGIS Tracker.

Remarques sur l’utilisation

Tenez compte des points suivants lorsque vous utilisez la source Couche d’entités :

  • Lorsque vous recherchez un élément de couche d’entités, vous pouvez effectuer un filtrage par dossiers, favoris, groupes, organisation, ou dans tout ArcGIS Online. Vous pouvez filtrer davantage par date de modification, date de création et balises.
  • Les couches d’entités ArcGIS Server peuvent également être chargées à l’aide d’une URL. Utilisez une URL REST du répertoire de services ArcGIS Server (par exemple, https://sampleserver6.arcgisonline.com/arcgis/rest/services/Wildfire/FeatureServer/2). Cette URL doit se terminer par /FeatureServer/# ou par /MapServer/#, où # est le numéro de la couche.
  • Pour charger une couche d’entités sécurisée à partir d’une URL, vous devez d’abord ajouter ces éléments à partir du Web dans ArcGIS Online et stocker les identifiants de connexion, puis accéder à l’élément ArcGIS Online enregistré pour charger la couche d’entités sécurisée.
  • La couche d’entités doit être accessible via Internet.
  • Si un champ est fourni pour le paramètre Timestamp field (Champ d’horodatage), la source Couche d’entités interroge la couche d’entités pour charger uniquement les entités pertinentes pour l’exécution de l’analyse en cours (analyses programmées seulement).
    • Si la valeur du paramètre Timestamp field (Champ d’horodatage) est fournie, la première fois que l’analyse est lancée, Velocity interroge la couche d’entités et charge toutes les entités dont la valeur Date/heure du champ d’horodatage est inférieure à l’heure de la première exécution prévue, qui répondent également aux critères de la clause WHERE. À chaque exécution suivante, seules les entités dont la valeur du champ d’horodatage est comprise entre l’heure de la dernière exécution prévue et l’heure de l’exécution actuelle prévue, qui répondent également aux critères de la clause WHERE, sont chargées.
    • Si aucune valeur Timestamp field (Champ d’horodatage) n’est fournie, à chaque lancement de l’analyse, le flux Couche d’entités charge toutes les entités de la couche d’entités en tant qu’événements à traiter.
  • Il n’est pas possible de spécifier un champ d’horodatage lors de la configuration d’une source de couche d’entités dans une analyse en temps réel, car le flux de couche d’entités chargerait toutes les entités renvoyées par la clause WHERE configurée à chaque lancement de l’analyse en temps réel.
  • Après avoir configuré les paramètres de connexion de la source, reportez-vous à la rubrique Configurer les données en entrée pour savoir comment définir la structure et les paramètres clés.

Paramètres

Les paramètres de la source Couche d’entités sont présentés ci-après :

ParamètreDescriptionType de données

Clause WHERE

Clause WHERE permettant de filtrer les entités chargées à partir de la couche d’entités spécifiée. L’option par défaut est de charger toutes les entités à l’aide de 1=1. La clause WHERE par défaut peut être modifiée pour inclure des valeurs attributaires et des conditions logiques spécifiques.

La syntaxe de la clause WHERE SQL 92 pour les champs de la couche est prise en charge dans la plupart des couches d’entités.

Les couches d’entités générées par Velocity ou les couches d’entités ArcGIS Enterprise s’exécutant dans une source de stockage de Big Data spatio-temporelles présentent des restrictions : seul un sous-ensemble de SQL 92 est pris en charge. Les syntaxes SQL 92 prises en charge par ces couches d’entités sont les suivantes :

  • ( '<=' | '>=' | '<' | '>' | '=' | '!=' | '<>' | LIKE )
  • (AND | OR)
  • (IS | IS_NOT)
  • (IN | NOT_IN) ( '(' ( expr ( ',' expr )* )? ')' )
  • COLUMN_NAME BETWEEN LITERAL_VALUE AND LITERAL_VALUE

Si vous utilisez des variables globales d’analyse pour limiter le chargement des entités, quatre variables globales s’appliquent aux analyses Big Data récurrentes et sont énumérées ci-dessous. Ces variables peuvent être utilisées conjointement avec la clause WHERE de la couche d’entités source pour charger uniquement certaines entités à chaque exécution de l’analyse Big Data.

  • $analytic.AnalyticLastScheduledStartTime : heure de début planifiée pour la dernière exécution de l’analyse.
  • $analytic.AnalyticScheduledStartTime : heure de début planifiée pour l’exécution actuelle de l’analyse.
  • $analytic.AnalyticLastEndTime : heure de fin de la dernière exécution de l’analyse.
  • $analytic.AnalyticStartTime : heure de début de l’exécution actuelle de l’analyse. La différence entre cette variable et la variable $analytic.AnalyticScheduledStartTime correspond au retard de démarrage.

Généralement, ces variables sont utilisées avec une analyse temps réel qui écrit les événements en continu dans une couche d’entités en sortie, à mesure qu’ils se produisent.

Pour plus d’informations sur ce type de configuration, consultez la rubrique Analyse proche temps réel.

QueryString

Champs en sortie

Les champs de la couche d’entités qui seront chargés dans Velocity.

La valeur par défaut est un astérisque (*), qui indique que tous les champs seront chargés.

Lorsque vous spécifiez des champs, séparez leurs noms par des virgules (par exemple, OBJECTID,device_id,timestamp,horizontal_accuracy,latitude,longitude).

Chaîne

Référence spatiale en sortie

Identifiant connu (WKID) d’une référence spatiale. La valeur par défaut est 4326.

Velocity charge les données de la couche d’entités dans la référence spatiale définie pour ce paramètre.

Chaîne

Champ d’horodatage

Champ de date pour l'extraction des dernières entités (analyses programmées seulement).

Si une valeur Timestamp field (Champ d’horodatage) est fournie, la première fois que l’analyse est lancée, Velocity interroge la couche d’entités et charge toutes les entités dont la valeur Date/heure du champ d’horodatage est inférieure à l’heure de la première exécution prévue, qui répondent également aux critères de la clause WHERE. À chaque exécution suivante, seules les entités dont la valeur du champ d’horodatage est comprise entre l’heure de la dernière exécution prévue et l’heure de l’exécution prévue actuelle, qui répondent également aux critères de la clause WHERE, sont chargées.

Si aucune valeur Timestamp field (Champ d’horodatage) n’est fournie, à chaque lancement de l’analyse, le flux de couche d’entités charge toutes les entités de la couche d’entités en tant qu’événements à traiter.

Chaîne

Considérations et limitations

Voici les considérations et limitations lors de l’utilisation de la source Couche d’entités :

  • La couche d’entités doit être accessible via Internet.
  • Velocity ne référence pas les couches qui demandent des crédits pour la réception de requêtes.