Couche d’entités

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

Exemples

Voici des exemples de cas d’utilisation de la source de données :

• Un utilisateur sélectionne une couche d’entités hébergée ArcGIS Onlinecontenant 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 utilisateur peut ajouter des conditions météorologiques en temps réel à la carte en intégrant une couche d’entités météorologique depuis ArcGIS Online.

Remarques sur l’utilisation

Tenez compte des points suivants lorsque vous utilisez la source de données :

• Lorsque vous recherchez un élément de couche d’entités, vous pouvez effectuer un filtrage par dossiers, favoris, groupes ou organisation. 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 des éléments du Web dans ArcGIS Online et stocker les informations d’identification, puis accéder à l’élément ArcGIS Online inscrit pour charger la couche d’entités sécurisée.
• Les couches d’entités doivent contenir un champ d’identifiant unique. L’identifiant unique ne doit pas être nul, il doit contenir des valeurs uniques et son type de données doit être l’un des suivants :
  • Entier (valeurs positives 32 et 64 bits uniquement)
  • Chaîne
  • GUID
  • Date
  • Date uniquement
  • Heure uniquement
• Les couches doivent comporter un identifiant unique prenant en charge les opérations de résumés statistiques Min et Max. Lorsque vous utilisez une couche d’entités ArcGIS Server, gardez à l’esprit que les systèmes back-end de certains services ne prennent pas en charge les champs d’ID d’objets virtuels, tels que ESRI_OID.
• 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 datetime 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 de 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 temps réel car le flux de couche d’entités charge toutes les entités renvoyées par la clause WHERE configurée à chaque lancement de l’analyse temps réel.
• Après avoir configuré les paramètres de connexion à la source, reportez-vous à la rubrique sur la configuration des 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 de données sont présentés ci-après :

Paramètre	Description	Type de données
Clause WHERE	Clause SQL (Structured Query Language) utilisée pour filtrer les entités chargées à partir de la couche d’entités spécifiée. Par défaut, toutes les entités sont chargées à l’aide de 1=1, mais la clause peut être modifiée pour inclure des valeurs attributaires et des conditions logiques spécifiques. La plupart des couches d’entités prennent en charge la syntaxe de la clause WHERE SQL-92 sur les champs de la couche. 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 spatiotemporal Big Data store 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 à laquelle l’exécution actuelle de l’analyse a commencé. 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. En savoir plus sur l’analyse proche temps réel	QueryString
Champs en sortie	Champs de la couche d’entités qui sont chargés dans Velocity. La valeur par défaut est un astérisque (*), qui indique que tous les champs sont chargés. Lorsque vous spécifiez des champs, séparez leurs noms par des virgules (par exemple : 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.	Chaîne
Journalisation supplémentaire (facultatif)	Indique si la journalisation des requêtes au format brut émises par Velocity est disponible. La valeur par défaut est False. Remarque : Activez ce paramètre à des fins de dépannage uniquement et désactivez-le à l’issue du dépannage. Contactez le Support technique Esri pour obtenir de l’aide dans le cadre du dépannage.	Booléen
Champ d’horodatage	Champ de date pour l'extraction des dernières entités (analyses programmées seulement). En savoir plus sur les paramètres du champ d’horodatage	Chaîne

Considérations et limitations

Considérez ce qui suit lorsque vous utilisez la source de données :

• 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 (ArcGIS Online).