La sortie Feature Layer (new) [Couche d’entités (nouvelle)] dans ArcGIS Velocity vous permet d’écrire des entités en sortie dans une nouvelle couche d’entités ArcGIS. Lors de l’écriture dans ce type de sortie, une couche d’entités spatio-temporelle et une couche d’images de carte ou une couche d’entités hébergées ArcGIS Online sont créées. Une fois la ou les couches créées, elles peuvent être utilisées dans Velocity et votre organisation ArcGIS Online, où elles peuvent être ajoutées à des cartes, à des applications et bien plus encore.
Les couches d’entités créées par Velocity présentent des différences majeures par rapport aux autres couches d’entités hébergées ArcGIS Online, parmi lesquelles :
- Les données associées sont stockées dans une couche d’entités spatio-temporelle. De ce fait, la couche d’images de carte correspondante offre un rendu dynamique et une agrégation à la volée.
- Une politique de conservation des données doit être définie pour la suppression des données plus anciennes de la couche d’entités. Les options de conservation des données peuvent être définies sur 1 hour (1 heure), 1 day (1 jour), 1 week (1 semaine), 1 month (1 mois), 6 months (6 mois) et 1 year (1 an). Pour toutes les couches d’entités dont le volume de données croît au fil du temps, vous devez spécifier une valeur dans le paramètre Data retention (time period for retaining data) (Conservation des données [période de conservation des données]). Par exemple, lorsque le paramètre Data storage method (Méthode de stockage de données) a pour valeur Add all new features (Ajouter toutes les nouvelles entités) et que vous sélectionnez Keep existing features and schema (Conserver les entités et la structure existantes) à chaque exécution de l’analyse, vous devez définir l’option de conservation des données.
- Les données plus anciennes peuvent être exportées dans une archive de couche d’entités avant d’être supprimées à l’aide du paramètre Data retention (time period for retaining data) (Conservation des données [période de conservation des données]). Les données exportées vers l’archive de couche d’entités sont conservées pendant un an à compter de la date d’exportation. Pour s’assurer que les données sont exportées dans l’archive de la couche d’entités, sélectionnez l’option Keep existing features and schema (Conserver les entités et la structure existantes) à chaque exécution de l’analyse. Spécifiez les options de conservation des données et veillez à sélectionner l’option Export data (Exporter des données) qui se trouve sous Data export (feature layer archive) (Exportation de données [archive de couche d’entités]).
- Des restrictions s’appliquent au nombre d’enregistrements qu’il est possible d’écrire dans les sorties des couches d’entités hébergées ArcGIS Online, notamment les suivantes :
- Sortie d’analyse temps réel - Pour une écriture dans une couche d’entités hébergée ArcGIS Online depuis une analyse temps réel Velocity, il est possible d’écrire jusqu’à 120 enregistrements toutes les 15 secondes, soit un ajout total ou une mise à jour totale de 480 enregistrements par minute.
- Sortie d’analyse Big Data exécutée une seule fois - Il est possible d’écrire un maximum de 50 000 enregistrements dans une sortie de couche d’entités hébergée ArcGIS Online.
- Sortie d’analyse Big Data planifiée/récurrente - Le nombre d’enregistrements qu’il est possible d’écrire dans une sortie de couche d’entités hébergée ArcGIS Online dépend de la fréquence d’exécution de l’analyse. Pour chaque minute qui passe entre deux exécutions, il est possible d’écrire 480 enregistrements. Par exemple, une analyse exécutée toutes les minutes peut écrire 480 entités en sortie par exécution. Une analyse exécutée toutes les cinq minutes peut écrire 2 400 entités en sortie par exécution. Une analyse exécutée toutes les 30 minutes peut écrire 14 400 entités en sortie par exécution.
Exemples
Les exemples suivants illustrent des cas d’utilisation de la sortie :
- Après avoir ingéré les données d’événement des capteurs IoT dans un flux et une analyse temps réel, vous voulez stocker les entités dans une nouvelle couche d’entités.
- Après avoir effectué une analyse de Big Data, vous voulez écrire les entités d’analyse résultantes dans une nouvelle couche d’entités.
- Vous avez configuré un flux dans une analyse en temps réel afin de traiter les événements à mesure qu’ils se produisent. Vous voulez stocker dans une nouvelle couche d’entités uniquement le dernier état de vos entités, tel qu’identifié par l’ID de suivi.
Remarques sur l’utilisation
Gardez les points suivants à l’esprit lorsque vous utilisez la sortie :
- Si vous activez l’option Keep existing features and schema (Conserver les entités et la structure existantes) à chaque exécution de l’analyse, les entités écrites dans la nouvelle couche d’entités en sortie doivent conserver une structure cohérente.
- La nouvelle couche d’entités et la nouvelle couche d’images de carte créées par la sortie n’apparaissent pas tant que l’analyse n’a pas démarré et n’a pas réussi à générer la sortie.
- Vous devez spécifier une stratégie de conservation des données dans le paramètre Data retention (time period for retaining data) (Conservation des données [temps de conservation des données]). Les options Data retention (time period for retaining data) (Conservation des données [période de conservation des données]) et Data export (feature layer archive) (Exportation des données [archive de couche d’entités]) ne s’appliquent pas si vous activez l’option Replace existing features and schema (Remplacer les entités et la structure existantes) à chaque exécution de l’analyse.
- Lorsque le suivi de l’éditeur est activé et que le paramètre Data storage method (Méthode de stockage de données) a pour valeur Add all new features (Ajouter toutes les nouvelles entités), le créateur et l’éditeur, ainsi que la date, restent inchangés. Si le paramètre Data storage method (Méthode de stockage de données) a pour valeur Keep only latest feature for each Track ID value (Conserver uniquement la dernière entité pour chaque valeur d’ID de suivi), seuls l’éditeur et la date sont actualisés après la première observation, dans le cas d’une observation de suivi mise à jour.
Remarque :
Le nom de la couche d’entités spatio-temporelle doit être unique dans une organisation.
Dans Velocity, le nom de la couche d’entités spatio-temporelle doit être différent des noms du flux et de la couche en mode continu. En cas de doublon, il est impossible de créer une analyse temps réel ou une analyse Big Data dans Velocity. Ceci ne concerne que les couches d’entités Velocity en sortie. Cela ne s’applique pas aux couches d’entités hébergées sur ArcGIS Online.
Paramètres
Les paramètres de la sortie sont les suivants :
| Paramètre | Description | Type de données |
|---|---|---|
| Nom de la couche d’entités | Nom de la nouvelle couche d’entités. | Chaîne |
| Stocker les données dans la couche d’entités spatio-temporelle | Après avoir configuré les paramètres de connexion à la source, définissez la structure et les paramètres clés. Si ce paramètre n’est pas coché (faux), les données sont écrites dans une couche d’entités hébergées de votre organisation et son stockage consomme des crédits. | Booléen |
| Méthode de stockage de données | Spécifie si toutes les nouvelles entités sont ajoutées à la couche d’entités ou si les entités existantes sont mises à jour. Les options sont notamment les suivantes :
| Booléen Remarque :Si vous sélectionnez Keep latest feature (Conserver la dernière entité), la valeur est true (vrai). |
| À chaque exécution de l’analyse | Spécifie comment les données existantes dans la couche d’entités doivent être gérées à chaque exécution de l’analyse. Les options sont notamment les suivantes :
| Booléen Remarque :Si vous sélectionnez l’option Replace existing features and schema (Remplacer les entités et la structure existantes), la valeur est true (vrai). |
| Styles d’agrégation | Spécifie les styles de groupe pour l’agrégation dynamique des données. Les styles de groupe sont renseignés par défaut, mais peuvent être modifiés. Les styles de groupe peuvent être définis pour des références spatiales ou des projections supplémentaires. Ce paramètre n'est applicable que si des données sont stockées dans une couche d'entités spatio-temporelle. | Geohash |
| Suivi de l’éditeur | Le suivi de l’éditeur définit le nom d’utilisateur et la date à laquelle les enregistrements d’entités sont créés ou mis à jour dans la couche d’entités en sortie. Cochez la case Editor tracking (Suivi de l’éditeur) dans la couche d’entités en sortie. La sélection de ce paramètre a pour effet d’ajouter les champs created_date, created_user, last_edited_date et last_edited_user à la structure de la couche d’entités. Ce paramètre n'est applicable que si des données sont stockées dans une couche d'entités spatio-temporelle. | Booléen |
| Nom d’utilisateur du créateur et de l’éditeur | Indique le nom d’utilisateur du créateur ou de l’éditeur pour les données traitées. Le nom d’utilisateur peut découler d’un champ des données entrantes ou être défini comme nom d’utilisateur du propriétaire d’analyse. Le paramètre Creator and editor username (Nom d’utilisateur du créateur et de l’éditeur) ne s’applique pas si le paramètre Editor tracking (Suivi de l’éditeur) est désactivé. En savoir plus sur les notes d’utilisation Ce paramètre n'est applicable que si des données sont stockées dans une couche d'entités spatio-temporelle. | Chaîne |
| Feature Service Portal Item ID (ID d’élément du portail de service d’entités) | ID d’élément du portail de l’élément de couche d’entités correspondant créé dans ArcGIS Online. Ce paramètre ne s’affiche pas lorsque vous configurez la sortie, et ne peut être ni renseigné ni modifié. Il est renseigné automatiquement par ArcGIS Velocity. | Chaîne |
| Map Service Portal Item ID (ID d’élément du portail de service de carte) | ID d’élément du portail de l’élément de couche de carte correspondant créé dans ArcGIS Online. Ce paramètre n'est applicable que si des données sont stockées dans une couche d'entités spatio-temporelle. | Chaîne |
| Conservation de données (période de conservation des données) | Spécifie la politique de conservation des données ou la période au bout de laquelle les données plus anciennes sont supprimées de la couche d’entités. Les options sont les suivantes : 1 hour (1 heure), 1 day (1 jour), 1 week (1 semaine), 1 month (1 mois), 6 months (6 mois) et 1 year (1 an). En savoir plus sur les notes d’utilisation Ce paramètre n'est applicable que si des données sont stockées dans une couche d'entités spatio-temporelle. | Chaîne |
| Exportation des données (archive de couche d’entités) | Spécifie si les données purgées sont exportées vers une archive de couche d’entités avant d’être purgées. Les options sont les suivantes : Do not export data (Ne pas exporter les données) et Export data (Exporter les données). Les données exportées vers l’archive de couche d’entités sont conservées pendant un an à compter de la date d’exportation. Le paramètre Data retention (time period for retaining data) (Conservation des données [période de conservation des données]) ne s’applique pas si l’option Replace existing features and schema (Remplacer les entités et la structure existantes) est sélectionnée. Ce paramètre n'est applicable que si des données sont stockées dans une couche d'entités spatio-temporelle. | Chaîne |
| Journalisation supplémentaire (facultatif) | Indique si la journalisation des requêtes au format brut émises par Velocity est activée. 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 |
Considérations et limitations
Tenez compte des points suivants lorsque vous utilisez la sortie :
- Les couches d'entités hébergées par Velocity ne peuvent pas être partagées publiquement.
- Si vous sélectionnez l’option Keep existing features and schema (Conserver les entités et la structure existantes), à chaque exécution de l’analyse, les entités écrites dans la nouvelle couche d’entités en sortie doivent conserver une structure cohérente.
- Si le paramètre Store data in spatiotemporal feature layer (Stocker les données dans la couche d’entités spatio-temporelle) n’est pas coché, une couche d’entités hébergée est créée pour stocker les données. Ce stockage consomme des crédits. Il est important de noter également les points suivants :
- Les restrictions des analyses temps réel pour les sorties des couches d’entités hébergées ArcGIS Online sont les suivantes :
- Les entités sont écrites depuis des analyses temps réel Velocity dans la couche d'entités hébergées toutes les 15 secondes.
- Il est possible d’écrire jusqu’à 120 événements toutes les 15 secondes, soit un total de 480 événements par minute. Par conséquent, le débit moyen des données en sortie dans le temps ne doit pas dépasser 120 événements toutes les 15 secondes ou huit événements par seconde.
- Si une analyse génère plus de 480 mises à jour d’entité au cours d’une minute, les entités en trop sont stockées dans un cache temporaire et écrites dans la couche d’entités hébergée lors de la prochaine opération de mise à jour. L'ordre temporel est conservé lorsque les entités sont vidées du cache. Le cache est conservé à hauteur de 4 800 entités, seuil au-delà duquel les nouveaux enregistrements peuvent être supprimés pendant le vidage du cache.
- Si vous utilisez l’option de stockage Keep only latest feature for each Track ID value (Conserver uniquement la dernière entité pour chaque valeur d’ID de suivi) et qu’il existe plusieurs observations pour un ID de suivi donné au cours des 15 secondes séparant l’envoi de deux mises à jour, seule la dernière entité de ce suivi est écrite dans la couche d’entités hébergée. Les observations supplémentaires de la trace ne sont pas prises en compte dans le seuil de 480 mises à jour par minute. En d'autres termes, une ingestion plus rapide peut être prise en charge avec cette option de stockage si 480 ressources ou périphériques au plus sont suivis avec des mises à jour plus rapprochées qu’une minute.
- Les restrictions des analyses Big Data pour les sorties des couches d’entités hébergées ArcGIS Online sont les suivantes :
- Les entités sont écrites depuis des analyses Big Data Velocity dans la couche d'entités hébergée à la fin de chaque exécution.
- Les analyses Big Data non planifiées exécutées une seule fois écrivent jusqu’à 50 000 enregistrements dans une sortie de couche d’entités hébergée ArcGIS Online.
- Les analyses Big Data planifiées ou exécutées de manière périodique contrôlent le nombre d’entités en sortie pouvant être écrites dans une sortie de couche d’entités hébergée ArcGIS Online en fonction de la fréquence d’exécution. Pour chaque minute qui passe entre deux exécutions, il est possible d’écrire 480 enregistrements. Par exemple, une analyse exécutée toutes les minutes peut écrire 480 entités en sortie par exécution, une analyse exécutée toutes les cinq minutes peut écrire 2 400 entités en sortie par exécution et une analyse exécutée toutes les 30 minutes peut écrire 14 400 entités en sortie par exécution.
- Les restrictions des analyses temps réel pour les sorties des couches d’entités hébergées ArcGIS Online sont les suivantes :
- Actuellement, les analyses Big Data exécutées une seule fois ne peuvent écrire une sortie dans des couches d’entités hébergées ArcGIS Online que dans la référence spatiale WGS84 (4326). Utilisez l’outil Project (Projeter) avant cette sortie, si nécessaire.
- Les éléments du portail des couches d’entités (et des couches d’images de carte) associés à la sortie Couche d’entités (nouvelle) doivent appartenir au créateur pour que Velocity puisse écrire dans la sortie. Pour changer la propriété d’un élément, reconfigurez l’analyse de sorte qu’elle écrive dans une couche d’entités existante à l’aide de la sortie Feature Layer (existing) (Couche d’entités (existante)).
Vous avez un commentaire à formuler concernant cette rubrique ?