Skip To Content

Polecenia interfejsu REST ArcGIS Data Store

Podczas konfigurowania aplikacji ArcGIS Data Store użytkownik wiąże ją z serwerem GIS Server, który służy jako serwer hostujący portalu. Działania służące do zmieniania lub sprawdzania statusu magazynu danych są wykonywane przez administratora serwera ArcGIS Server w aplikacji ArcGIS Server Administrator Directory serwera hostującego. (Adres URL ma następujący format: https://gisserver.domain.com:6443/arcgis/admin). Za pomocą aplikacji ArcGIS Server Administrator Directory można również usunąć komputer zapasowy z relacyjnego magazynu danych i witryny GIS Server. Poniższe sekcje zawierają podsumowanie tych operacji i łącza do dokumentacji interfejsu ArcGIS API.

Jeśli nie jesteś administratorem ArcGIS Server serwera hostującego, musisz wykonać opisane tu działania we współpracy z osobą pełniącą tę funkcję.

Poniżej znajdują się ścieżki w aplikacji ArcGIS Server Administrator Directory, których należy użyć, aby uzyskać dostęp do operacji dla każdego typu magazynu danych:

  • Relacyjny magazyn danych — kliknij dane > elementy > enterpriseDatabases > <nazwa magazynu danych> > komputery > <nazwa komputera>.
  • Magazyn dużych zbiorów danych czasowo-przestrzennych — kliknij dane > elementy > nosqlDatabases > AGSDataStore_bigdata_<nazwa magazynu danych> > komputery > <nazwa komputera>.
  • Magazyn danych pamięci podręcznej kafli — kliknij dane > elementy > nosqlDatabases > AGSDataStore_nosql_<nazwa magazynu danych> > komputery > <nazwa komputera>.
  • Magazyn obiektów — kliknij dane > elementy > objectStores > <nazwa magazynu danych> > komputery > <nazwa komputera>.

Zmiana statusu komputera magazynu danych

W magazynie danych można zatrzymywać i restartować pojedyncze komputery. Ponadto można wypromować zapasowy komputer relacyjnego magazynu danych lub zapasowy komputer magazynu danych pamięci podręcznej kafli działającego w trybie podstawowy-zapasowy tak, aby stał się komputerem podstawowym.

Zatrzymanie podstawowego komputera magazynu danych nie powoduje przełączenia awaryjnego magazynu danych we wdrożeniu lokalnym, ponieważ przełączenie awaryjne może być niepożądane w przypadku wykonywania czynności konserwacyjnych, takich jak tymczasowa praca magazynu danych w trybie offline.

Status komputera magazynu danych można na przykład zmienić w ramach następującego scenariusza aktualizacji:

  • Zatrzymanie komputera zapasowego.
  • Zaktualizowanie komputera zapasowego.
  • Uruchomienie komputera zapasowego.
  • Wypromowanie komputera zapasowego jako komputera podstawowego za pomocą polecenia makePrimary.
  • Zatrzymanie komputera, który wcześniej był komputerem podstawowym.
  • Zaktualizowanie komputera, który wcześniej był komputerem podstawowym.
  • Uruchomienie komputera, który wcześniej był komputerem podstawowym.
  • Dodanie komputera, który wcześniej był komputerem podstawowym, z powrotem do magazynu danych jako komputera zapasowego.

Zaloguj się do aplikacji ArcGIS Server Administrator Directory serwera hostującego jako administrator witryny serwera ArcGIS Server i przejdź do konkretnego komputera, aby użyć jednego z następujących poleceń do zmiany statusu komputera magazynu danych:

  • stop
  • uruchom
  • makePrimary (dotyczy tylko komputerów zapasowych relacyjnego magazynu danych lub magazynu danych pamięci podręcznej kafli działającego w trybie podstawowy-zapasowy)

Sprawdzanie magazynu danych

Status komputerów w magazynie danych można sprawdzić za pomocą polecenia validate interfejsu REST serwera ArcGIS Server.

Zaloguj się do aplikacji ArcGIS Server Administrator Directory serwera hostującego jako administrator witryny serwera ArcGIS Server. Przejdź do jednego z komputerów w magazynie danych, który chcesz sprawdzić i kliknij przycisk polecenie validate, aby wyświetlić informacje dotyczące tego magazynu danych. Oto istotne informacje związane ze statusem magazynu danych:

  • ogólna kondycja (overallhealth) — może pojawić się wartość Sprawny (Healthy) lub Niesprawny (Unhealthy). Magazyn danych jest uważany za niesprawny, jeśli ponad połowa znajdujących się w nim komputerów jest niedostępna ("datastore.overallhealth": "Unhealthy"). Komputer jest uważany za niesprawny, jeśli jest niedostępny ("machine.overallhealth": "Unhealthy").
  • status — w przypadku relacyjnego magazynu danych lub magazynu danych pamięci podręcznej kafli może pojawić się wartość Uruchomiony (Started) lub Zatrzymany (Stopped). W przypadku stanu zatrzymany nie można publikować hostowanych warstw obiektowych ani hostowanych warstw scen w portalu.
  • clusterStatus — w przypadku magazynów dużych zbiorów danych czasowo-przestrzennych dostępne są następujące statusy:
    • zielony — wszystkie dane są dostępne.
    • żółty — dane są dostępne, ale niektóre lub wszystkie kopie replik danych są niedostępne, a magazyn dużych zbiorów danych czasowo-przestrzennych jest obecnie niedostępny w trybie wysokiej dostępności. Ten status zawsze będzie wyświetlany, jeśli skonfigurowano magazyn dużych zbiorów danych czasowo-przestrzennych na jednym komputerze. Ten status jest wyświetlany także wtedy, gdy komputery wykonują operację równoważenia danych lub co najmniej jeden komputer w magazynie dużych zbiorów danych czasowo-przestrzennych jest niedostępny. Jeśli używasz magazynu dużych zbiorów danych czasowo-przestrzennych złożonego z wielu komputerów i wyświetlany jest żółty status, upewnij się, czy wszystkie komputery są nadal dostępne, sprawdzając każdy z nich. Jeśli są one dostępne, poczekaj kilka godzin i sprawdź ponownie. Jeśli nadal wyświetlany jest żółty status, sprawdź dzienniki serwera ArcGIS Server pod kątem błędów.
    • czerwony — niektóre lub wszystkie dane są niedostępne. Sprawdź dzienniki i usuń błędy.
  • diskSpacePercentUsed — przedstawia wartość procentową przestrzeni dyskowej użytej dla każdego dysku na każdym komputerze magazynu obiektów. W przypadku zagrożenia brakiem przestrzeni dyskowej na komputerze magazynu obiektów może być potrzebna zmiana zasad zachowania pamięci podręcznej lub nawet natychmiastowe usunięcie pamięci podręcznych z warstw wykorzystujących najwięcej przestrzeni. Aby zobaczyć rozmiary pamięci podręcznych warstw w hostowanych warstwach obiektowych, użyj programu narzędziowego listobjectstorage.
  • rola — dotyczy tylko komputerów w relacyjnym magazynie danych lub magazynie danych pamięci podręcznej kafli działającym w trybie podstawowy-zapasowy i wskazuje, czy dany komputer jest komputerem podstawowym), czy też zapasowym.
  • komunikaty — w tym miejscu pojawią się ostrzeżenia i komunikaty o błędach związane ze statusem magazynu danych. Na przykład: po zweryfikowaniu magazynu danych pamięci podręcznej kafli obsługiwanego przez wiele komputerów zostanie wyświetlony komunikat informujący, że dane pamięci podręcznej scen nie są obecnie wysoko dostępne (innymi słowy, istnieje tylko jedna kopia co najmniej jednej pamięci podręcznych scen).

Magazyn danych można sprawdzić, aby potwierdzić, czy komputer jest zatrzymany lub uruchomiony, potwierdzić, czy komputer zapasowy stał się komputerem podstawowym po wykonaniu polecenia makePrimary, zidentyfikować, czy magazyn danych pamięci podręcznej kafli jest w stanie wysokiej dostępności lub w ramach początkowego etapu rozwiązywania problemów, gdy nie można publikować hostowanych warstw obiektów lub scen albo uzyskiwać do nich dostępu, bądź też nie można uruchomić narzędzi GeoAnalytics Tools

Usuwanie komputera zapasowego

Komputer zapasowy można usunąć z relacyjnego magazynu danych lub magazynu danych pamięci podręcznej kafli działającego w trybie podstawowy-zapasowy, używając polecenia remove interfejsu REST serwera ArcGIS Server. Jeśli na przykład chcesz użyć innego komputera jako zapasowego, możesz usunąć stary komputer zapasowy z magazynu danych, zainstalować oprogramowanie ArcGIS Data Store na nowym komputerze i skonfigurować ten nowy komputer jako zapasowy.

Zaloguj się do aplikacji ArcGIS Server Administrator Directory serwera hostującego jako administrator witryny serwera ArcGIS Server, aby użyć polecenia remove.

Zarządzanie pamięciami podręcznymi odpowiedzi na zapytania dla hostowanych warstw obiektowych

W przypadku często odpytywanych hostowanych warstw obiektowych administrator ArcGIS Server serwera hostującego może włączyć buforowanie w pamięci podręcznej odpowiedzi na zapytania dla poszczególnych warstw, aby poprawić wydajność. Po włączeniu przy każdym wysłaniu przez klienta unikalnego zapytania do usługi obiektowej obiekty i zasięg są buforowane w magazynie obiektów. W zależności od czasu przechowywania pamięci podręcznych (zasady wygasania pamięci podręcznej) oraz dostępności przestrzeni dyskowej komputera lub komputerów, na których jest uruchomiony magazyn obiektów, ten magazyn obiektów może zostać zapełniony i przestać działać.

Administrator aplikacji ArcGIS Data Store musi skonfigurować magazyn danych na komputerze lub komputerach bez innego oprogramowania i upewnić się, że jest dostępne dostatecznie dużo przestrzeni dyskowej do magazynowania tych pamięci podręcznych. Konieczne jest również monitorowanie dzienników aplikacji ArcGIS Data Store, aby wykryć, gdy magazyn obiektów zbliża się do progu pojemności. Aby sprawdzić, jaki procent przestrzeni dyskowej jest używany na komputerach magazynu obiektów, możesz zweryfikować magazyn obiektów. Możesz również uruchomić program narzędziowy, aby sprawdzić, które pamięci podręczne warstw są największe. W razie konieczności we współpracy z administratorem serwera ArcGIS Server zmień zasady wygasania pamięci podręcznych lub usuń duże pamięci podręczne warstw.

Włączanie buforowania w pamięci podręcznej odpowiedzi na zapytania w warstwach obiektowych

Aby włączyć buforowanie w pamięci podręcznej dla warstwy lub warstw w hostowanej warstwie obiektowej (usłudze obiektowej), administrator serwera ArcGIS Server witryny serwera hostującego musi zalogować się w aplikacji ArcGIS Server Administrator Directory serwera hostującego i przesłać następujący wniosek

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

Jeśli dane są często aktualizowane, nie należy włączać buforowania w pamięci podręcznej. Każdorazowe zaktualizowanie warstwy będzie wymagało ponownego utworzenia pamięci podręcznej, dlatego podczas korzystania z buforowanych zapytań w odniesieniu do często edytowanych warstw obiektowych nie będzie zauważalnej poprawy wydajności.

Konfigurowanie lub zmiana zasad wygasania pamięci podręcznej

Pamięci podręczne są tworzone dla każdego unikalnego zapytania. Jeśli masz odpowiednio dużo przestrzeni dyskowej na komputerze magazynu obiektów i dostęp do warstw uzyskuje wielu klientów, skonfiguruj pamięć podręczną tak, aby nigdy nie wygasała. Przykładowy wniosek pokazany w poprzedniej sekcji włącza buforowanie w pamięci podręcznej bez wygasania.

W przypadku warstw, które nie są używane stale, lub gdy przestrzeń dyskowa jest cenna, skonfiguruj czas (w dniach), przez jaki jest zachowywana pamięć podręczna odpowiedzi na zapytanie dla danej warstwy.

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

Pamiętaj, że pamięci podręczne wygasną o północy czasu UTC. Jeśli skonfigurujesz zasady wygasania na 1, pamięć podręczna będzie przechowywana przez blisko dwa dni, w zależności od czasu jej utworzenia.

Jeśli na przykład klient uzyska dostęp do warstwy obiektowej o godzinie 4:00 czasu UTC, jej pamięć podręczna będzie przechowywana do godziny 24:00 czasu UTC następnego dnia.

Usuwanie pamięci podręcznej warstwy

Jeśli zaczyna brakować przestrzeni dyskowej magazynu obiektów, w dziennikach aplikacji ArcGIS Data Store zostanie zapisane ostrzeżenie, a polecenie REST validate wyświetli informacje o wielkości zajętej przestrzeni dyskowej. Do istniejącego magazynu obiektów nie można dodać przestrzeni dyskowej ani komputerów, dlatego w celu zwolnienia przestrzeni dyskowej może być konieczne wyczyszczenie pamięci podręcznych. W tym celu administrator serwera hostującego ArcGIS Server musi wyłączyć buforowanie w pamięci podręcznej w tej warstwie.

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