Azure Cosmos DB

Le type de source de données Azure Cosmos DB dans ArcGIS Velocity lit les enregistrements provenant des collections de bases de données stockées dans Azure Cosmos DB.

Exemple

Un chercheur souhaite charger les données d’une collection de base de données stockée dans Azure Cosmos DB vers Velocity pour effectuer une analyse.

Remarques sur l'utilisation

• La clé principale est chiffrée lors du premier enregistrement de l’analyse et stockée dans cet état.
• Vous pouvez spécifier une clause WHERE pour limiter les enregistrements chargés à partir de la collection de conteneur Azure Cosmos DB.
• Des variables d’exécution d’analyse peuvent être spécifiées dans le paramètre Where clause (Clause WHERE) pour charger uniquement les nouvelles entités de la collection de conteneur Azure Cosmos DB pour chaque exécution.

Paramètres

Paramètre	Description	Type de données
Extrémité	URL d’extrémité pour Azure Cosmos DB, par exemple, https://yourCosmosDBAccountName.documents.azure.com:443/.	Chaîne
Clé primaire	Clé primaire pour Azure Cosmos DB.	Chaîne
Base de données	Nom du conteneur Azure Cosmos DB qui renferme la collection de données à lire.	Chaîne
Collection	Nom de la collection Azure Cosmos DB dans le conteneur spécifié qui renferme les données.	Chaîne
Clause Where (facultative)	Limite le nombre d’entités chargées à partir de la collection de conteneur Azure Cosmos DB. Utilisez un format de requête simple. Par exemple, si le jeu de données comporte un champ numérique nommé course, vous pouvez spécifier une clause WHERE course = 49.5845184 ; si le jeu de données comporte un champ de type chaîne nommé user_id, vous pouvez spécifier une clause WHERE user_id = 'pete1234'. Dans l’interface Azure Cosmos DB, ces requêtes prennent la forme SELECT * FROM c WHERE c.user_id = 'pete1234' ; il est toutefois nécessaire de spécifier user_id = 'pete1234' pour ce paramètre dans Velocity. Pour interroger des champs de type chaîne, utilisez un guillemet simple autour du texte faisant partie de la requête, par exemple, road_type = 'asphalt'. Vous pouvez spécifier des variables d’exécution d’analyse pour charger uniquement les nouvelles entités pour chaque exécution d’une analyse de Big Data récurrente. Ces variables sont remplacées par les heures de début planifiées de l’analyse en question pour interroger les champs de type chaîne ISO 8601 dans Azure Cosmos DB. Les variables d’exécution d’analyse disponibles sont $analytic.AnalyticLastSuccessfulRunScheduledStartTime et $analytic.AnalyticScheduledStartTime. Pour la première exécution consécutive au démarrage d’une analyse de Big Data planifiée, la variable $feature.AnalyticLastSuccessfulRunScheduledStartTime indique l’heure d’origine ISO 8601 du 1er janvier 1970, toutes les entités postérieures à ce moment sont donc chargées. Pour en tenir compte, spécifiez une partie supplémentaire de la requête de la clause WHERE pour renvoyer les entités postérieures à la première exécution attendue de l’analyse récurrente. Par exemple, vous pouvez spécifier une clause WHERE, comme illustré ci-dessous, dans laquelle l’analyse a démarré le 6 juin 2021 à 12:01:01 UTC. yourISO8601StringTimestampField > '$analytic.AnalyticLastSuccessfulRunScheduledStartTime' and yourISO8601StringTimestampField <= '$analytic.AnalyticScheduledStartTime' and yourISO8601StringTimestampField > '2021-06-04T12:01:01.0Z'	Chaîne

Considérations et limitations

• Lorsque vous spécifiez une clause WHERE pour filtrer des valeurs de chaîne, entourez les valeurs de texte de guillemets simples.
• Lorsque vous spécifiez des champs de type date, seules les configurations suivantes sont prises en charge pour cette source de données :
  • Secondes Epoch comme 1616673883
  • Millisecondes Epoch comme 1616673883000
  • Format de date/heure ISO 8601 sans fuseau horaire tel que 2021-03-25T12:05:34
  • Format de date/heure ISO 8601 avec fuseau horaire tel que 2021-03-25T12:05:34+0000
  • Chaînes de date au format (les millisecondes sont facultatives) : aaaa-MM-jj HH:mm:ss[.fffffffff] telles que2021-03-25 12:05:34 ou 2021-03-25 12:05:34.435
• Le paramètre Where clause (Clause WHERE) peut être utilisé pour spécifier des variables d’exécution d’analyse afin de limiter chaque récurrence de l’analyse au chargement des entités les plus récentes depuis la dernière analyse exécutée. Vous trouverez des détails supplémentaires plus haut.