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. (Format adresu URL to https://gisserver.domain.com:6443/arcgis/admin). Komputer zapasowy można usunąć z relacyjnego magazynu danych lub magazynu danych pamięci podręcznej kafli działającego w trybie podstawowy-zapasowy. Komputer zapasowy można również usunąć z witryny GIS Server w aplikacji ArcGIS Server Administrator Directory. 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 wykresów — 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ć komputer zapasowy relacyjnego magazynu danych, magazynu danych pamięci podręcznej kafli lub magazynu wykresów, 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, magazynu wykresów lub magazynu danych pamięci podręcznej kafli działających 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 przyjmować następujące wartości:
    • Sprawny (Healthy) — wszystkie komponenty na wszystkich komputerach członkowskich są osiągalne i działają.
    • Sprawny z ostrzeżeniem (HealthyWithWarning) — ten stan dotyczy tylko magazynów obiektów i magazynów wykresów. Co najmniej jeden komponent nie jest dostępny, ale magazyn danych wciąż działa. W przypadku magazynów obiektów zawierających więcej niż jeden komputer magazyn danych może nie być wysoko dostępny.
    • 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 (yellow) — 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 (red) — niektóre lub wszystkie dane są niedostępne. Sprawdź dzienniki i usuń błędy.
  • rola — dotyczy tylko komputerów w relacyjnym magazynie danych, magazynie wykresów 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. W przypadku magazynu obiektów rola będzie miała wartość podstawowa dla pojedynczej instancji, a dla magazynu obiektów wdrożonego w trybie klastra wartość członek_klastra.
  • 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).

Weryfikacji można użyć w następujących sytuacjach:

  • Potwierdzenie, że komputer magazynu danych został zatrzymany lub uruchomiony.
  • Potwierdzenie, że polecenie makePrimary awansowało komputer zapasowy do roli komputera podstawowego.
  • Określenie, czy magazyn danych pamięci podręcznej kafli jest w stanie wysokiej dostępności.
  • Jako etap początkowy rozwiązywania problemów, jeśli nie można opublikować hostowanych warstw obiektowych lub warstw sceny ani uzyskać do nich dostępu, jeśli nie można utworzyć wykresu wiedzy ani uzyskać do niego dostępu bądź nie można uruchomić narzędzi GeoAnalytics Tools.

Usunięcie 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 tej funkcji za każdym razem, gdy usługa obiektowa otrzymuje unikalne zapytanie, 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 witryny serwera hostującego ArcGIS Server musi zalogować się do aplikacji Administrator Directory serwera hostującego ArcGIS Server i przesłać następujący wniosek za pomocą operacji REST Aktualizowanie definicji:

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