Commandes REST de ArcGIS Data Store

Lorsque vous configurez ArcGIS Data Store, vous l’associez au site GIS Server qui fait office de serveur d’hébergement pour le portail ArcGIS Enterprise. Les actions qui permettent de modifier ou de vérifier le statut du data store sont effectuées à partir du répertoire administrateur de ArcGIS Server du serveur d’hébergement en tant qu’administrateur ArcGIS Server. (Le format d’URL est https://gisserver.domain.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 ArcGIS.

Si vous n’êtes pas l’administrateur de ArcGIS Server pour le serveur d’hébergement, vous devrez 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 de ArcGIS Server afin d’accéder aux opérations pour chaque type de data store :

• Data store relationnel - Cliquez sur data (données) > items (éléments) > enterpriseDatabases > <nom du data store> > machines > <nom de la machine>.
• Spatiotemporal Big Data Store - Cliquez sur data (données) > items (éléments) > nosqlDatabases > AGSDataStore_bigdata_<nom du data store> > machines > <nom de la machine>.
• Base de graphiques - Cliquez sur data (données) > items (éléments) > nosqlDatabases > AGSDataStore_graph_<nom du data store> > machines > <nom de la machine>.
• Object store - Cliquez sur data (données) > items (éléments) > cloudStores > <nom du data store> > machines > <nom de la machine>.

Modifier l'état d'une machine de stockage des données

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 répertoire de données relationnelles 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 de 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 dans un relational data store)

Valider le stockage des données

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

Connectez-vous au répertoire administrateur de 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 (intégrité globale) : 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 data stores relationnels, 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 data store relationnel si la machine principale est intègre, mais que la machine de secours n’est pas disponible. Le data store relationnel 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 les couches d’entités hébergées ou les couches de scènes 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 d’entités ou de scène 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 remove de ArcGIS Server. 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 de ArcGIS Server du serveur d’hébergement en tant qu’administrateur du site ArcGIS Server pour utiliser la commande remove.

Gérer les caches des réponses aux requêtes des couches d’entités hébergées

En ce qui concerne les couches d’entités hébergées régulièrement interrogées, l’administrateur de ArcGIS Server du serveur d’hébergement peut activer la mise en cache des réponses aux requêtes au niveau des couches afin d’améliorer les performances. 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 de ArcGIS Data Store, vous devez configurer l’object store sur une machine ou des machines ne comportant pas d’autres logiciels et vous assurer qu’il existe suffisamment d’espace disque disponible pour conserver ces caches. Vous devez également surveiller les journaux ArcGIS Data Store pour détecter lorsque l’object store a presque atteint 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 de 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.

Pour plus d’informations sur les caches de réponses aux requêtes d’entités et quand les utiliser, reportez-vous à la rubrique Mise en cache des réponses.

Pour obtenir des instructions pour activer la mise en cache des réponses aux requêtes pour les couches d’entités hébergées, reportez-vous aux rubriques Couche d’entités et Update Definition dans l’aide de ArcGIS REST API.