Skip To Content

Comandos REST de ArcGIS Data Store

Al configurar ArcGIS Data Store, lo asocia al sitio de GIS Server que actúa como servidor de alojamiento del portal. Las acciones que cambian o comprueban el estado del data store se realizan desde el Directorio de administrador de ArcGIS Server para el servidor de alojamiento como administrador de ArcGIS Server. (El formato de la dirección URL es https://gisserver.domain.com:6443/arcgis/admin). También puede eliminar un equipo de respaldo de un data store relacional y el sitio de GIS Server en el Directorio de administrador de ArcGIS Server. En los siguientes apartados se resumen estas operaciones y se vinculan con la documentación de la API de ArcGIS.

Si no es el administrador de ArcGIS Server para el servidor de alojamiento, tendrá que trabajar con dicha persona para completar las tareas que se describen a continuación.

A continuación se indican las rutas del Directorio del administrador de ArcGIS Server que necesita seguir para acceder a las operaciones de cada tipo de data store:

  • Data store relacional: haga clic en datos > elementos > enterpriseDatabases > <nombre de data store> > equipos > <nombre de equipo>.
  • Big data store espaciotemporal: haga clic en datos > elementos > nosqlDatabases > AGSDataStore_bigdata_<nombre data store> > equipos > <nombre de equipo>.
  • Data store de caché de teselas: haga clic en datos > elementos > nosqlDatabases > AGSDataStore_nosql_<nombre data store> > equipos > <nombre de equipo>.
  • Almacén de objetos: haga clic en datos > elementos > objectStores > <nombre data store> > equipos > <nombre equipo>.

Cambiar el estado de un equipo de data store

Puede detener y reiniciar equipos individuales en un data store. También puede convertir un equipo de data store relacional de respaldo o un equipo de data store de caché de teselas de respaldo principal en el equipo principal.

Al detener el equipo de data store principal no se produce una conmutación por error del data store cuando se trata de implementaciones locales, pues es posible que no desee la conmutación por error si está realizando una tarea de mantenimiento como, por ejemplo, dejar temporalmente el data store sin conexión.

Por ejemplo, puede cambiar el estado del equipo de data store como parte del siguiente escenario de actualización:

  • Detenga el equipo de respaldo.
  • Actualice el equipo de respaldo.
  • Inicie el equipo de respaldo.
  • Ascienda el equipo de respaldo a principal usando el comando makePrimary.
  • Detenga el equipo principal anterior.
  • Actualice el equipo principal anterior.
  • Inicie el equipo principal anterior.
  • Vuelva a agregar el equipo principal anterior al data store como equipo de respaldo.

Inicie sesión en el Directorio de administrador de ArcGIS Server para el servidor de alojamiento como administrador del sitio de ArcGIS Server y vaya a un equipo específico para utilizar cualquiera de los siguientes comandos a fin de cambiar el estado de un equipo de data store:

  • parada
  • start
  • makePrimary (equipos de respaldo del data store relacional o data store de caché de teselas en modo de respaldo principal únicamente)

Validar el data store

Puede comprobar el estado de los equipos en un data store usando el comando REST validar de ArcGIS Server.

Inicie sesión en el Directorio de administrador de ArcGIS Server para el servidor de alojamiento como administrador del sitio de ArcGIS Server, vaya a uno de los equipos del data store concreto, escriba lo que desea verificar y haga clic en validate para ver información relacionada con ese data store. La información importante relacionada con el estado de un data store incluye:

  • overallhealth: los valores son Healthy o Unhealthy. Se considera que un data store es incorrecto si no se puede acceder a más de la mitad de los equipos ("datastore.overallhealth": "Unhealthy"). Se considera que un equipo es incorrecto si no se puede acceder a él ("machine.overallhealth": "Unhealthy").
  • status: en los data stores relacionales o de caché de teselas, los valores posibles son Started o Stopped. Cuando está detenido, no puede publicar capas de entidades alojadas ni capas de escena alojadas en su portal.
  • clusterStatus: en los big data stores espaciotemporales, los estados son:
    • green: todos los datos están disponibles.
    • yellow: los datos están disponibles, pero algunas o ninguna de las copias de réplica de los datos están disponibles y su big data store espaciotemporal no presenta actualmente una alta disponibilidad. Siempre verá este estado si configuró un big data store espaciotemporal en un solo equipo. También puede ver este estado si los equipos están reequilibrando datos o si no se puede acceder a uno o varios equipos de su big data store espaciotemporal. Si tiene un big data store espaciotemporal en varios equipos y ve el estado yellow, verifique que todos los equipos están aún disponibles validando cada equipo. Si están disponibles, espere unas horas y compruébelo de nuevo. Si el estado sigue siendo yellow, examine los registros de ArcGIS Server para ver si contienen errores.
    • red: no se puede acceder a algunos datos o a ninguno. Examine los registros y corrija los errores.
  • diskSpacePercentUsed: muestra el porcentaje de espacio en disco utilizado para cada disco de cada uno de los equipos del almacén de datos. Si el equipo del almacén de datos corre el riesgo de quedarse sin espacio en disco, cambie la política de retención de la caché o elimine inmediatamente las cachés de las capas que utilizan la mayor parte del espacio. Para ver el tamaño de la caché de las capas de entidades alojadas, ejecute la utilidad listobjectstorage.
  • role: se aplica solamente a equipos en data stores relacionales o de caché de teselas de respaldo principales e indica si el equipo es el equipo primary o standby.
  • messages: aquí verá mensajes de error y de advertencia relacionados con el estado del data store. Por ejemplo, si valida un data store de caché de teselas de varios equipos, recibirá un mensaje si los datos de la caché de escenas no son de alta disponibilidad en este momento (es decir, solo hay una copia de una o varias cachés de escenas).

Puede validar el data store para confirmar que un equipo se haya detenido o iniciado, que el equipo de respaldo se haya convertido en principal después de usar el comando makePrimary, para identificar si su data store de caché de teselas tiene un estado de alta disponibilidad, como paso inicial de resolución de problemas si no se pueden publicar capas de entidades o de escenas alojadas o no se puede acceder a ellas, o si no puede ejecutar GeoAnalytics Tools.

Eliminar un equipo de respaldo

Puede eliminar un equipo de respaldo de un data store relacional o de un data store de caché de teselas de respaldo principal utilizando el comando REST remove de ArcGIS Server. Por ejemplo, si desea usar un equipo diferente como equipo de respaldo, puede eliminar el equipo de respaldo antiguo del data store, instalar ArcGIS Data Store en el nuevo equipo y configurar el nuevo equipo como equipo de respaldo.

Inicie sesión en el Directorio de administrador de ArcGIS Server para el servidor de alojamiento como el administrador del sitio de ArcGIS Server para usar el comando remove.

Administrar cachés de respuestas de consultas para capas de entidades alojadas

En el caso de las capas de entidades alojadas consultadas con frecuencia, el administrador de ArcGIS Server para el servidor de alojamiento puede habilitar el almacenamiento en la caché de respuestas de consultas en capas individuales con el objeto de mejorar el rendimiento. Una vez habilitado, cada vez que un cliente envía una consulta única al servicio de entidades, las entidades y la extensión se almacenan en la caché del almacén de objetos. Dependiendo de cuánto tiempo se almacenen las cachés (la política de caducidad de la caché) y de cuánto espacio en disco esté disponible en los equipos donde se ejecuta el almacén de objetos, el almacén de objetos puede llenarse y dejar de funcionar.

Como administrador de ArcGIS Data Store, debe configurar el almacén de objetos en uno o varios equipos independientes del resto del software y asegurarse de que hay suficiente espacio en disco para almacenar estas memorias caché. También debe supervisar los registros de ArcGIS Data Store para detectar si el almacén de objetos se está acercando a su capacidad máxima. Puede validar el almacén de objetos para ver qué porcentaje de espacio en disco está en uso en los equipos del almacén de objetos y ejecutar una utilidad para determinar qué cachés de capa son más grandes. Si es necesario, trabaje con el administrador de ArcGIS Server para cambiar la política de caducidad de la caché o eliminar la caché de las capas que ocupan más espacio.

Habilitar el almacenamiento en la caché de respuestas a consultas para las capas de entidades

Para habilitar el almacenamiento en la caché en una o más capas de una capa de entidades alojadas (servicio de entidades), el administrador de ArcGIS Server del sitio del servidor de alojamiento debe iniciar sesión en el Directorio de administrador de ArcGIS Server para el servidor de alojamiento y enviar la siguiente solicitud:

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

Si los datos se actualizan con frecuencia, no habilite el almacenamiento en caché; cada vez que se actualiza la capa, la caché tiene que reconstruirse, de modo que no obtendrá mejoras de rendimiento al utilizar consultas en caché en capas de entidades editadas con frecuencia.

Configurar o cambiar la política de caducidad de la caché

Las cachés se construyen por consulta única. Si tiene suficiente espacio en disco en el equipo del almacén de objetos y muchos clientes acceden a la capa, configure la caché para que no caduque. La solicitud de ejemplo mostrada en la sección anterior permite el almacenamiento en caché sin caducidad.

En el caso de las capas a las que no se accede continuamente, o si el espacio en disco es un problema, establezca cuánto tiempo (en días) se conserva la caché de respuesta a las consultas para una capa.

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

Tenga en cuenta que las cachés caducan a medianoche, hora UTC. Si se establece la política de caducidad en 1, la caché puede persistir hasta casi dos días, dependiendo de cuándo se cree la caché.

Por ejemplo, si un cliente accede a una capa de entidades a las 4:00 UTC, su caché persistirá hasta las 24:00 UTC del día siguiente.

Borrar la caché de una capa

Si el almacén de objetos se está quedando sin espacio en disco, aparecerá una advertencia en los registros de ArcGIS Data Store y el comando REST validate mostrá el espacio en disco utilizado. No se puede añadir espacio en disco o equipos a un almacén de objetos existente, por lo que puede ser necesario limpiar las cachés para liberar espacio en disco. Para ello, el administrador de ArcGIS Server del servidor de alojamiento debe deshabilitar el almacenamiento en la caché para la capa en cuestión.

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