Skip To Content

Comandi REST ArcGIS Data Store

Quando si configura ArcGIS Data Store, esso viene associato al sitoGIS Server che funge da server di hosting del portale. Le azioni che modificano o verificano lo stato del Data store vengono eseguite daArcGIS Server Administrator Directory per il server di hosting come amministratore di ArcGIS Server. (Il formato dell'URL è https://gisserver.domain.com:6443/arcgis/admin.) Puoi anche rimuovere una macchina standby da un data store relazionale o da un data store tile cache che funziona in modalità primary-standby e rimuovere la macchina standby dal sito GIS Server nell'Administrator Directory ArcGIS Server. Nelle sezioni seguenti vengono riepilogate queste operazioni e vengono forniti i collegamenti alla documentazione delle API di ArcGIS.

Se non si è l'amministratore diArcGIS Server per il server di hosting, sarà necessario lavorare con tale persona per completare le attività qui descritte.

I seguenti sono i percorsi nell'Administrator Directory diArcGIS Server che devono essere seguiti per accedere alle operazioni per ogni tipo di Data Store:

  • Data Store relazionale: fare clic su dati > elementi > enterpriseDatabases > <nome data store> > computer > <nome computer>.
  • Spatiotemporal Big Data Store:fare clic su dati > elementi > nosqlDatabases > AGSDataStore_bigdata_<nome archivio dati> > computer > <nome computer>.
  • Data Store cache tile: fare clic su dati > elementi > nosqlDatabases > AGSDataStore_nosql_<nome archivio dati> > computer > <nome computer>.
  • Archivio grafico-Clicca data > items > nosqlDatabases > AGSDataStore_graph_<nome archivio dati> > macchine > <nome computer>.
  • Archivio oggetti: fare clic su dati > elementi > objectStores > <nome archivio dati> > computer > <nome computer>.

Modificare lo stato di un computer dell'archivio dati

È possibile arrestare e riavviare singoli computer in un Data Store, Inoltre, è possibile promuovere un computer standby del Data Store relazionale o lo standby in un Data Store cache tile primario-standy impostandolo come primario.

L'arresto del computer del Data store primario non causa il failover del Data store in un'installazione locale, poiché questo potrebbe non essere richiesto quando si esegue un'attività di manutenzione, ad esempio la disattivazione temporanea del Data store.

Lo stato del computer dell'archivio dati viene ad esempio modificato nel seguente scenario di aggiornamento:

  • Arresto del computer di standby.
  • Aggiornamento del computer di standby.
  • Avvio del computer di standby.
  • Innalzamento di livello del computer di standby a computer primario con il comando makePrimary.
  • Arresto del computer primario precedente.
  • Aggiornamento del computer primario precedente.
  • Avvio del computer primario precedente.
  • Aggiunta del computer primario precedente all'archivio dati come computer di standby.

Accedere adArcGIS Server Administrator Directory per il server di hosting come amministratore del sito diArcGIS Server e passare a un computer specifico per utilizzare uno dei seguenti comandi per modificare lo stato di un computer del Data store:

  • arresta
  • avvia
  • makePrimary (solo computer del Data Store relazionale o del Data Store cache tile in modalità primaria-standby).

Convalidare l'archivio dati

È possibile verificare lo stato dei computer in un Data Store utilizzando il comando REST validate di ArcGIS Server.

Accedere all'Administrator Directory diArcGIS Server per il server di hosting come amministratore del sitoArcGIS Server, accedere a uno dei computer del tipo di Data Store specifico che si desidera controllare e fare clic su validate per visualizzare le informazioni relative a tale Data Store. Le informazioni importanti relative allo stato di un Data Store includono quanto segue:

  • overallhealth: i valori sono i seguenti:
    • Healthy: tutti i componenti di tutti i computer dei membri sono raggiungibili e funzionanti.
    • HealthyWithWarning: questo stato si applica solo agli archivi grafici e di oggetti. Uno o più componenti non sono disponibili, ma il Data Store è ancora utilizzabile. Per gli archivi di oggetti che contengono più di un computer, il Data Store potrebbe non essere completamente disponibile al momento.
    • Unhealthy: un Data Store viene considerato non integro se non risulta accessibile più della metà dei computer al suo interno ("datastore.overallhealth": "Unhealthy"). Un computer viene considerato non integro se non è accessibile ("computer.integritagenerale": "Non integro").
  • stato: per i Data Store relazionali o cache tile, i valori possibili sono Avviato o Arrestato. Se arrestato, non è possibile pubblicare feature layer hosted o layer della scena hosted sul portale.
  • Stato cluster : per gli Spatiotemporal Big Data Store, gli stati sono i seguenti:
    • verde: tutti i dati sono disponibili.
    • giallo: i dati sono disponibili, ma alcune o tutte le copie di replica dei dati non sono disponibili e lo Spatiotemporal Big Data Store non è attualmente in alta affidabilità. Si visualizzerà sempre questo stato se si configura uno Spatiotemporal Big Data Store su un solo computer. Si potrebbe anche visualizzare questo stato se i computer stanno effettuando il ribilanciamento di dati o se non è possibile accedere a uno o più computer dello Spatiotemporal Big Data Store. Se si dispone di uno Spatiotemporal Big Data Store a più computer e si visualizza uno stato giallo, verificare che tutti i computer siano ancora disponibili convalidando ciascun computer. Se sono disponibili, attendere svariate ore e verificare nuovamente. Se lo stato è ancora giallo, verificare eventuali errori nel log di ArcGIS Server.
    • rosso: non è possibile accedere ad alcuni o a tutti i dati. Verificare i log e correggere eventuali errori.
  • ruolo: si applica solo a computer di Data Store relazionali o Data Store cache tile primario-standby e indica se il computer è quello primario o di standby. Per gli archivi di oggetti, il ruolo sarà primary per un'istanza singola e cluster_member per un archivio di oggetti installato in modalità cluster.
  • messaggi: qui vengono visualizzati messaggi di avvertimento e di errore relativi allo stato del Data Store. Per esempio, se si convalida un Data Store cache tile a più computer, si riceverà un messaggio se i dati cache della scena non hanno attualmente una disponibilità elevata (in altre parole, c'è solo una copia di una o più cache della scena).

È opportuno convalidare il Data Store per verificare se un computer è stato arrestato o avviato, se il computer di standby è stato impostato come principale dopo aver utilizzato il comando makePrimary, per identificare se il Data Store cache tile si trova in stato di disponibilità elevata, oppure come passaggio iniziale di risoluzione dei problemi se non si riesce a pubblicare o ad accedere ai feature layer o ai layer della scena hosted o se non si riesce a eseguireGeoAnalytics Tools.

Rimuovere un computer di standby

È possibile rimuovere un computer standby da un Data Store relazionale o da Data Store cache tile primario-standby utilizzando il comando REST remove di ArcGIS Server. Se ad esempio si desidera utilizzare un computer diverso per il computer di standby, è possibile rimuovere il vecchio computer di standby dall'archivio dati, installareArcGIS Data Store nel nuovo computer e configurare quest'ultimo come standby.

Accedere adArcGIS Server Administrator Directory per il server di hosting come amministratore del sito diArcGIS Server per utilizzare il comando rimozione.

Gestire cache delle risposte alle interrogazioni per gli hosted feature layer

Per gli hosted feature layer che vengono interrogati frequentemente, l'amministratore diArcGIS Server per il server di hosting, può abilitare la memorizzazione nelle cache delle risposte all'interrogazione su layer individuali per aumentarne la performance. In seguito all'attivazione, ogni volta che il feature service riceve un'interrogazione univoca, le feature e l'estensione vengono memorizzati nella cache dell'archivio di oggetti. A seconda del tempo di permanenza nelle cache (politica di scadenza delle cache) e di quanto spazio su disco sia disponibile sul computer o sui computer in cui l'archivio oggetti è in esecuzione, quest'ultimo può riempirsi e smettere di funzionare.

L'amministratore di ArcGIS Data Store, deve configurare l'archivio oggetti su un computer o su computer separati dagli altri software, nonché garantire un'ampia disponibilità di spazio su disco per l'archiviazione delle cache. Inoltre, monitorare i log diArcGIS Data StoreArcGIS Data Store per rilevare quando l'archivio oggetti sia prossimo all'esaurimento dello spazio su disco. È possibile validare l'archivio oggetti per verificare la quantità di spazio su disco in uso sui computer archivio oggetti, eseguendo un'utilità per determinare quali sono le cache dei layer più grandi. Se necessario, collaborare con l'amministratore di ArcGIS Server per cambiare la politica di scadenza della cache o per eliminare le cache dei layer di dimensioni elevate.

Abilitare la memorizzazione nelle cache delle risposte alle interrogazioni per i feature layer.

Per abilitare la memorizzazione nelle cache su layer in un feature layer (feature service) in hosting, l'amministratore di ArcGIS Server del sito del server di hosting deve accedere all'Administrator Directory di ArcGIS Server per il server di hosting e inoltrare la richiesta seguente con l'operazione REST Aggiorna definizione:

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

Se i dati vengono aggiornati di frequente, non abilitare la memorizzazione nelle cache; ogni volta che si effetuerà l'aggiornamento del layer, la cache dovrà essere ricostruita, quindi non si assisterà ad un incremento delle prestazioni quando si utilizzano le interrogazioni memorizzate nelle cache su feature layer modificati di frequente.

Impostare o cambiare la politica di scadenza delle cache

Le cache sono create per ogni interrogazione unica. Se si dispone di spazio sufficiente sul computer archivio oggetti e molti clienti accedono al layer, impostare la cache in modo tale che non scada. L'esempio di richiesta mostrato nella precedente sezione abilita la memorizzazione nella cache senza scadenza.

Per i layer a cui non si accede continuamente, o se preoccupa lo spazio su disco, impostare la durata (in giorni) di memorizzazione nelle cache delle risposte alle interrogazioni per un layer.

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

Prestare attenzione poiché le cache scadranno a mezzanotte (fuso orario UTC). Se la politica di scadenza viene impostata su 1, la cache si conserverà per quasi due giorni, a seconda di quando è stata creata.

Ad esempio, se un cliente accede ad un feature layer alle 4:00 UTC, la cache si conserverà fino alle 24:00 UTC del giorno successivo.

Eliminare una cache per un layer

Se si sta esaurendo lo spazio su disco dell'archivio oggetti, comparirà un avviso nei log diArcGIS Data Store e il comando REST validate mostrerà la quantità di spazio su disco utilizzato. Non è possibile aggiungere spazio su disco o computer ad un archivio oggetti esistente, quindi potrebbe essere necessario rimuovere le cache per liberare spazio su disco. Per farlo, l'amministratore diArcGIS Server del server di hosting deve disabilitare la memorizzazione nelle cache per quel layer.

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