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 votre portail. 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 data store relationnel ou d’un data store de cache tuilé 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>.
• Data store de cache tuilé - Cliquez sur data (données) > items (éléments) > nosqlDatabases > AGSDataStore_nosql_<nom du stockage des données> > 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) > objectStores > <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 data store relationnel, de data store de cache tuilé ou de graph 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 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 data store relationnel, un graph store ou un data store de cache tuilé en mode Principal-secours uniquement)

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 (Intègre avec avertissement) : cet état s’applique aux graph stores et aux object stores uniquement. Un ou plusieurs composants ne sont pas disponibles, mais le Data Store peut néanmoins être utilisé. Dans le cas d’object stores qui contiennent plusieurs machines, il se peut que le Data Store ne soit pas hautement disponible à ce stade.
  • 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 répertoires de données relationnelles ou du cache de tuiles, 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) : il s’applique aux machines dans un data store relationnel, un graph store ou un data store de cache tuilé en mode Principal-secours uniquement et indique si la machine est la machine principale (primary) ou de secours (standby). Dans le cas d’un object store, le rôle est primary (principal) pour une instance seule, et cluster_member (membre de grappe) pour un object store déployé en mode grappe.
• Messages : messages d’avertissement et d’erreur liés au statut du répertoire de données. Par exemple, si vous validez un répertoire de données du cache de tuiles à plusieurs machines, vous recevez un message si les données du cache de scène ne sont pas hautement disponibles (en d’autres termes, s’il n’existe qu’une seule copie d’un ou de plusieurs caches de scène).

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.
• Pour déterminer si le data store de cache tuilé est hautement disponible.
• 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, si vous ne parvenez pas à créer un graphe de connaissances ou à y accéder, ou si vous ne parvenez pas à exécuter GeoAnalytics Tools.

Supprimer une machine de secours

Vous pouvez supprimer une machine de secours d’un data store relationnel ou d’un data store de cache tuilé en mode principal-secours à 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. Une fois cette option activée, les entités et l’étendue sont mises en cache dans l’object store à chaque fois que le service d’entités reçoit une requête unique. 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 validate l’object store pour voir le pourcentage d’espace disque en cours d’utilisation sur les machines de l’object store et exécutez un utilitaire pour déterminer les caches de couches qui sont les plus grands. 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.

Activer la mise en cache des réponses aux requêtes des couches d’entités

Pour activer la mise en cache au niveau d’une couche ou de plusieurs couches dans une couche d’entités hébergée (service d’entités), l’administrateur de ArcGIS Server du site du serveur d’hébergement doit se connecter au répertoire administrateur de ArcGIS Server du serveur d’hébergement et soumettre la demande suivante avec l’opération REST Mettre à jour la définition :

{
    "layerCache": {
        "enabled": true
    }
}

Si les données sont régulièrement mises à jour, n’activez pas la mise en cache ; chaque fois que la couche est mise à jour, le cache doit être recréé ; vous n’observerez donc pas de gains de performance en utilisant des requêtes mises en cache pour des couches d’entités fréquemment mises à jour.

Définir ou changer la stratégie d’expiration des caches

Les caches sont créés pour une requête unique. Si vous disposez d’assez d’espace disque sur la machine de l’object store et si de nombreux clients accèdent à la couche, définissez le cache de sorte qu’il n’expire pas. L’exemple de demande illustré à la section précédente active une mise en cache sans délai d’expiration.

En cas de couches qui ne sont pas continuellement sollicitées ou lorsque l’espace disque est un problème, définissez la durée (en nombre de jours) pendant laquelle le cache des réponses aux requêtes est conservé pour une couche.

{
    "layerCache": {
        "enabled": true, 
        "expiration": <duration_in_days>
    }
}

Rappelez-vous que les caches expirent au minuit, heure UTC. Si vous réglez la stratégie d’expiration sur 1, le cache peut perdurer quasiment deux jours, selon l’heure à laquelle il a été créé.

Ainsi, si un client a accès à une couche d’entités à 16 h 00 UTC, son cache dure jusqu’à minuit UTC le jour suivant.

Supprimer un cache d’une couche

Si l’object store manque d’espace disque, vous verrez un avertissement dans les journaux ArcGIS Data Store et la commande REST validate affiche le volume d’espace disque utilisé. Vous ne pouvez pas ajouter d’espace disque ou de machines à un object store, aussi vous pouvez être amené à vider les caches pour libérer de l’espace. Pour ce faire, l’administrateur ArcGIS Server du serveur d’hébergement doit désactiver la mise en cache pour cette couche.

{
    "layerCache": {
        "enabled": false
    }
}