Skip to main content

Commandes REST ArcGIS Data Store

Lorsque vous configurez ArcGIS Data Store, vous l’associez au serveur d’hébergement. Les actions qui permettent de modifier ou de vérifier le statut du data store sont effectuées à partir du répertoire administrateur ArcGIS Server du serveur d’hébergement en tant qu’administrateur ArcGIS Server. (Le format d’URL est https://gisserver.example.com:6443/arcgis/admin.) Vous pouvez également supprimer une machine de secours d’un relational data store exécuté en mode principal-secours et supprimer la machine de secours du site GIS Server dans le répertoire administrateur ArcGIS Server. Les sections suivantes récapitulent ces opérations et sont liées à la documentation sur l’API REST ArcGIS.

Si vous n’êtes pas l’administrateur ArcGIS Server pour le serveur d’hébergement, vous devez collaborer avec la personne concernée pour réaliser les tâches décrites dans cette rubrique.

Voici les chemins d’accès que vous devez suivre dans le répertoire administrateur ArcGIS Server afin d’accéder aux opérations pour chaque type ArcGIS Data Store :

  • Relational data store - Cliquez sur data (données) > items (éléments) > enterpriseDatabases > > machines > .

  • Spatiotemporal Big Data store - Cliquez sur data (données) > items (éléments) > nosqlDatabases > AGSDataStore_bigdata_ > machines > .

  • Graph store - Cliquez sur data (données) > items (éléments) > nosqlDatabases > AGSDataStore_graph_ > machines > .

  • Object store - Cliquez sur data (données) > items (éléments) > cloudStores > > machines > .

Modifier le statut d’une machine de data store

Vous pouvez arrêter et redémarrer des machines individuelles d'un stockage des données. Vous pouvez également promouvoir une machine de secours de relational data store comme machine principale.

L’arrêt de la machine principale de data store n’entraîne pas le basculement du data store sur un déploiement sur site, car vous ne souhaitez pas nécessairement effectuer un basculement si vous réalisez une tâche de maintenance, par exemple si vous placez temporairement le data store hors connexion.

Par exemple, vous modifiez l'état de la machine du stockage des données dans le cadre du scénario de mise à niveau suivant :

  • Arrêtez la machine de secours.

  • Mettez à niveau la machine de secours.

  • Démarrez la machine de secours.

  • Utilisez la commande makePrimary pour promouvoir la machine de secours au niveau de machine principale.

  • Arrêtez l'ancienne machine principale.

  • Mettez à niveau l'ancienne machine principale.

  • Démarrez l'ancienne machine principale.

  • Rajoutez l'ancienne machine principale au stockage des données en tant que machine de secours.

Connectez-vous au répertoire administrateur ArcGIS Server du serveur d’hébergement en tant qu’administrateur du site ArcGIS Server et accédez à une machine spécifique pour utiliser l’une des commandes suivantes afin de modifier le statut d’une machine de data store :

  • stop

  • start

  • makePrimary (machines de secours d’un relational data store)

Valider le data store

Vous pouvez vérifier le statut des machines d’un data store à l’aide de la commande REST ArcGIS Server validate.

Connectez-vous au répertoire administrateur ArcGIS Server du serveur d’hébergement en tant qu’administrateur du site ArcGIS Server, accédez à l’une des machines pour le type de data store spécifique que vous voulez vérifier et cliquez sur validate pour voir les informations sur ce data store. Les informations importantes relatives au statut d’un répertoire de données sont les suivantes :

  • overallhealth : les valeurs sont les suivantes :

    • Healthy (Intègre) : tous les composants de toutes les machines membres sont accessibles et fonctionnent.

    • HealthyWithWarning : cet état s’applique aux relational data stores, aux object stores et aux graph stores uniquement. Un ou plusieurs composants ne sont pas disponibles, mais le Data Store peut néanmoins être utilisé. Cette valeur est renvoyée pour le relational data store si la machine principale est intègre, mais que la machine de secours n’est pas disponible. Le relational data store n’est pas hautement disponible à ce stade. Pour les object stores ou les graph stores qui s’exécutent en mode agrégat, le data store peut ne pas être hautement disponible.

    • Unhealthy (Non intègre) : un Data Store est considéré comme non intègre si plus de la moitié des machines qui le composent sont inaccessibles ("datastore.overallhealth": "Unhealthy"). Une machine est considérée comme non intègre si elle est inaccessible ("machine.overallhealth": "Unhealthy").

  • status (statut) : pour les relational data stores, les valeurs possibles sont Started (Démarré) ou Stopped (Arrêté). En cas d’arrêt, vous ne pouvez pas publier sur votre portail les couches d’entités hébergées ou les couches 3D hébergées.

  • clusterStatus - Pour les Spatiotemporal Big Data Stores, les statuts sont les suivants :

    • vert : toutes les données sont disponibles.

    • jaune : les données sont disponibles, mais certaines copies de réplica des données ou toutes sont indisponibles et votre stockage de Big Data spatio-temporelles n’est actuellement pas hautement disponible. Ce statut apparaîtra toujours si vous avez configuré un stockage de Big Data spatio-temporelles à une seule machine. Ce statut peut également apparaître si les machines sont en train de rééquilibrer les données ou qu’une ou plusieurs machines de votre Spatiotemporal Big Data Store sont inaccessibles. Si vous disposez d’un Spatiotemporal Big Data Store sur plusieurs machines et qu’un statut jaune apparaît, confirmez que toutes les machines sont encore disponibles en les validant les unes après les autres. Si elles sont disponibles, attendez plusieurs heures puis vérifiez à nouveau. Si le statut est toujours jaune, recherchez la présence d’erreurs dans les journaux ArcGIS Server.

    • rouge : certaines données ou toutes sont inaccessibles. Examinez les journaux et corrigez les erreurs.

  • role (rôle) : pour les machines d’un relational data store, cela indique si la machine est la machine primary (principale) ou standby (de secours). Dans l’object store et le graph store, le rôle est primary (principal) pour une instance seule, et cluster_member (membre de grappe) en cas de déploiement en mode grappe.

  • Messages : messages d’avertissement et d’erreur liés au statut du répertoire de données.

Vous pouvez utiliser la validation :

  • Pour confirmer qu’une machine de data store a été arrêtée ou démarrée.

  • Pour confirmer que la commande makePrimary a promu la machine de secours en machine principale.

  • Comme première étape de dépannage, si des couches hébergées ne peuvent pas être publiées ou ne sont pas accessibles, ou si vous ne parvenez pas à créer un graphe de connaissances ou à y accéder.

Supprimer une machine de secours

Vous pouvez retirer une machine de secours d’un relational data store à l’aide de la commande REST ArcGIS Server remove. Par exemple, si vous souhaitez utiliser un autre ordinateur comme machine de secours, vous pouvez supprimer l’ancienne machine de secours du data store, installer ArcGIS Data Store sur la nouvelle machine et configurer la nouvelle machine comme machine de secours.

Connectez-vous au répertoire administrateur ArcGIS Server du serveur d’hébergement en tant qu’administrateur du site ArcGIS Server pour utiliser la commande remove.

Gérer les caches de réponses aux requêtes

Les administrateurs d’organisation et les propriétaires de couches d’entités et de couches d’images de carte peuvent activer la mise en cache des réponses aux requêtes pour chaque couche afin d’améliorer les performances des requêtes. Ces réponses aux requêtes sont mises en cache dans l’object store. Selon la durée pendant laquelle les caches sont conservés (appelée stratégie d’expiration des caches) et le volume d’espace disque disponible sur la machine ou les machines où l’object store est exécuté, il arrive que l’object store finisse par occuper tout l’espace et cesse alors de fonctionner.

En tant qu’administrateur ArcGIS Data Store, vous devez faire ce qui suit si le déploiement d’ArcGIS Enterprise utilise un object store ArcGIS Data Store :

  • Configurez l’object store sur des machines disposant d’un espace disque suffisant pour stocker ces caches, ainsi que les autres données stockées dans l’object store.

  • Surveillez les journaux ArcGIS Data Store pour détecter lorsque l’object store approche de sa capacité maximale. Vous pouvez valider l’object store pour déterminer le pourcentage d’espace disque en cours d’utilisation sur les machines de l’object store. Si nécessaire, collaborez avec l’administrateur ArcGIS Server pour changer la stratégie d’expiration des caches ou supprimer les caches des couches de grande taille en désactivant la mise en cache des réponses pour ces couches d’entités.

  • Exécutez périodiquement l’utilitaire maintaindatastore pour effacer les caches expirés de l’object store.

Pour des informations sur les caches de réponses aux requêtes, quand les utiliser et comment les activer, voir Activer la mise en cache des réponses.

Pour savoir comment modifier la politique d’expiration, voir Update Definition dans l’aide de l’API REST ArcGIS.