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 URL es https://gisserver.domain.com:6443/arcgis/admin). También puede eliminar un equipo de respaldo de un data store relacional o data store de caché de teselas que se ejecute en modo principal-en espera y eliminar el equipo de respaldo desde 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>.
  • Graph store: haga clic en datos > elementos > nosqlDatabases > AGSDataStore_graph_<data store name> > equipos > <machine name>.
  • 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 respaldo en el equipo principal del data store relacional, del data store de caché de teselas o del almacén de gráficos.

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
  • inicio
  • makePrimary (equipos de respaldo del data store relacional, el almacén de gráficos o el 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 los siguientes:
    • Healthy: todos los componentes de todos los equipos de miembros son accesibles y funcionan.
    • HealthyWithWarning: este estado se aplica solo a los data store relacionales, almacenes de objetos y graph store. Uno o varios componentes no están disponibles, pero el data store todavía se puede utilizar. Este valor se devuelve para graph store y data store relacionales cuando el equipo principal está en buen estado, pero el equipo de respaldo no está disponible. El graph store o el data store relacional no tienen una alta disponibilidad en este punto. Para los almacenes de objetos que contienen más de un equipo, es posible que el data store no esté altamente disponible en función del número de equipos que haya en el clúster.
    • 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.
  • role: se aplica solamente a equipos en data stores relacionales, almacén de gráficos o data store de caché de teselas de respaldo principales e indica si el equipo es el equipo principal o de respaldo. En un almacén de objetos, el rol será principal para una única instancia y cluster_member para un almacén de objetos implementado en el modo de clúster.
  • 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 utilizar la validación para lo siguiente:

  • Confirme que el equipo de data store se ha detenido o iniciado.
  • Confirme que el comando makePrimary ha ascendido el equipo de respaldo a equipo principal.
  • Identifique si el data store de caché de teselas se encuentra en un estado de alta disponibilidad.
  • Como primer paso para solucionar el problema si las capas de escenas o entidades alojadas no se pueden publicar o no se puede acceder a ellas, si no se puede crear o acceder a un gráfico de conocimiento o no se 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 el servicio de entidades recibe una consulta única, las entidades y la extensión se almacenan en caché en el 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 para eliminar cachés de capas grandes.

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

Para habilitar el almacenamiento en caché en una capa o capas en una capa de entidades alojada (servicio de entidades), el administrador 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 con la operación REST Actualizar definición:

{
    "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
    }
}