Skip To Content

ArcGIS Data Store REST 명령

ArcGIS Data Store를 구성할 때에는 포털의 호스팅 서버로 사용할 GIS Server 사이트와 연결합니다. 데이터 저장소의 상태를 변경하거나 확인하는 작업은ArcGIS Server 관리자로 호스팅 서버의 ArcGIS Server 관리자 디렉터리에서 수행됩니다. (URL 형식은 https://gisserver.domain.com:6443/arcgis/admin) 또한 ArcGIS Server 관리자 디렉터리의 GIS Server 사이트 및 관계형 데이터 저장소에서 스탠바이 머신을 제거할 수 있습니다. 다음 섹션에서는 이러한 작업을 요약하고 ArcGIS API 문서에 연결합니다.

호스팅 서버의 ArcGIS Server 관리자가 아닌 경우 여기에 설명된 작업을 완료하려면 해당 사용자와 함께 작업을 수행해야 합니다.

다음은 각 데이터 저장소 유형의 운영에 접근하기 위해 이동해야 하는 ArcGIS Server 관리자 디렉터리의 경로입니다.

  • 관계형 데이터 저장소 - data > items > enterpriseDatabases > <데이터 저장소 이름> > machines > <머신 이름>를 클릭합니다.
  • 시공간 빅데이터 저장소 - data > items > nosqlDatabases > AGSDataStore_bigdata_<데이터 저장소 이름> > machines > <머신 이름>를 클릭합니다.
  • 타일 캐시 데이터 저장소 - data > items > nosqlDatabases > AGSDataStore_nosql_<데이터 저장소 이름> > machines > <머신 이름>을 클릭합니다.
  • 객체 저장소 - data > items > objectStores > <데이터 저장소 이름> > machines > <머신 이름>을 클릭합니다.

데이터 저장소 머신 상태 변경

데이터 저장소에서 개별 머신을 중지하고 다시 시작할 수 있습니다. 프라이머리-스탠바이 타일 캐시 데이터 저장소의 스탠바이 머신 또는 스탠바이 관계형 데이터 저장소 머신을 프라이머리 머신 수준으로 승격할 수도 있습니다.

데이터 저장소를 일시적으로 오프라인 상태로 전환하는 등 유지관리 작업을 수행하는 경우 페일오버되는 것을 원하지 않을 수 있으므로 온프레미스 배포에서는 프라이머리 데이터 저장소 머신을 중지해도 데이터 저장소 페일오버가 발생하지 않습니다.

예를 들어, 다음 업그레이드 시나리오의 일부로 데이터 저장소 머신 상태를 변경합니다.

  • 스탠바이 머신을 중지합니다.
  • 스탠바이 머신을 업그레이드합니다.
  • 스탠바이 머신을 시작합니다.
  • makePrimary 명령을 사용해 스탠바이를 프라이머리로 승격합니다.
  • 이전 프라이머리 머신을 중지합니다.
  • 이전 프라이머리 머신을 업그레이드합니다.
  • 이전 프라이머리 머신을 시작합니다.
  • 이전 프라이머리 머신을 스탠바이 머신으로 다시 데이터 저장소에 추가합니다.

ArcGIS Server 사이트 관리자로 호스팅 서버의 ArcGIS Server 관리자 디렉터리에 로그인하고 특정 머신으로 이동한 후 다음 명령을 사용해 데이터 저장소 머신 상태를 변경합니다.

  • 일시 정지
  • start
  • makePrimary(스탠바이 관계형 타일 캐시 데이터 저장소 머신 또는 프라이머리-스탠바이 모드의 타일 캐시 데이터 저장소만 해당)

데이터 저장소 유효성 검사

데이터 저장소에서 validate ArcGIS Server REST 명령을 사용하여 머신의 상태를 확인할 수 있습니다.

ArcGIS Server 관리자 디렉터리에 ArcGIS Server 사이트 관리자로 로그인합니다. 검사하려는 특정 데이터 저장소 유형 중 하나의 머신으로 이동한 다음 유효성 검사를 클릭하여 해당 데이터 저장소와 관련된 정보를 확인합니다. 데이터 저장소의 상태와 관련된 주요 정보에는 다음이 포함되어 있습니다.

  • 전반적인 상태 - 값은 정상 또는 비정상입니다. 데이터 저장소는 머신 중 절반 이상에 접근할 수 없는 경우 비정상적인 건강 상태로 간주됩니다("데이터 저장소.전반적인 상태": "비정상"). 머신은 접근할 수 없는 경우 비정상적인 건강 상태로 간주됩니다. ("머신.전반적인 상태": "비정상").
  • 진행 상태 - 관계형 또는 타일 캐시 데이터 저장소에 대해 가능한 값은 시작됨 또는 중지됨입니다. 중지된 경우 호스팅 피처 레이어 또는 호스팅 씬 레이어를 포털에 발행할 수 없습니다.
  • clusterStatus - 시공간 빅데이터 저장소의 경우 진행 상태는 다음과 같습니다.
    • green - 모든 데이터를 사용할 수 있습니다.
    • 노란색 - 데이터를 사용할 수 있지만 일부 또는 모든 데이터 복제본을 사용할 수 없으며 시공간 빅데이터 저장소가 현재 고가용성이 아닙니다. 단일 머신 시공간 빅데이터 저장소를 구성한 경우에는 항상 이 상태가 표시됩니다. 또한 머신에서 데이터를 재밸런싱 중이거나 시공간 빅데이터 저장소에 있는 하나 이상의 머신에 접근할 수 없는 경우에도 이 상태가 표시될 수 있습니다. 다중 머신 시공간 빅데이터 저장소를 사용할 때 노란색 상태가 표시되면 각 머신의 유효성을 검사하여 모든 머신이 사용 가능한지 확인하세요. 사용 가능한 경우 몇 시간 정도 기다렸다가 다시 확인합니다. 그래도 상태가 노란색이면 ArcGIS Server 로그에서 오류를 확인합니다.
    • 빨간색 - 일부 또는 모든 데이터에 접근할 수 없습니다. 로그를 확인하고 오류를 수정합니다.
  • diskSpacePercentUsed - 각 객체 저장소 머신의 각 디스크에 사용된 디스크 공간의 비율(%)을 표시합니다. 객체 저장소 시스템에 디스크 공간이 부족할 위험이 있는 경우 캐시 보존 정책을 변경하거나 가장 많은 공간을 차지하는 계층의 캐시를 즉시 삭제할 수도 있습니다. 호스팅 피처 레이어에서 레이어의 캐시 크기를 확인하려면 listobjectstorage 유틸리티를 사용합니다.
  • 역할 - 관계형 데이터 저장소 또는 프라이머리-스탠바이 타일 캐시 데이터 저장소의 머신에만 적용되며, 머신이 프라이머리 머신이지 또는 스탠바이 머신인지를 나타냅니다.
  • 메시지—여기서 데이터 저장소 상태와 관련된 경고 및 오류 메시지를 확인할 수 있습니다. 예를 들어 다중 머신 타일 캐시 데이터 저장소를 유효성 검사하는 경우 씬 캐시 데이터의 현재 가용성이 높지 않은 경우(즉 씬 캐시 중 하나 이상의 복사본만 있는 경우) 메시지가 표시됩니다.

머신이 중지되었는지 또는 시작되었는지 확인하거나 makePrimary 명령을 사용한 후 스탠바이 머신이 프라이머리 머신이 되었는지 확인하거나 타일 캐시 데이터 저장소가 고가용성 상태인지 확인하기 위해 데이터 저장소의 유효성을 검사합니다. 또는 호스팅 피처 또는 씬 레이어를 발행하거나 접근할 수 없는 경우 또는 GeoAnalytics Tools를 실행할 수 없는 경우에도 초기 문제 해결 단계로서 데이터 저장소의 유효성을 검사할 수 있습니다.

스탠바이 머신 제거

관계형 데이터 스토어 또는 프라이머리-스탠바이 타일 캐시 데이터 저장소에서 remove ArcGIS Server ArcGIS Server REST 명령을 사용하여 스탠바이 머신을 제거할 수 있습니다. 예를 들어 다른 컴퓨터를 스탠바이 머신으로 사용하려면 데이터 저장소에서 이전 스탠바이 머신을 제거하고 새 머신에 ArcGIS Data Store를 설치한 다음 새 머신을 스탠바이 머신으로 구성할 수 있습니다.

remove 명령을 사용하려면 ArcGIS Server 사이트 관리자로 호스팅 서버의 ArcGIS Server 관리자 디렉터리에 로그인하세요.

호스팅 피처 레이어 관리를 위한 쿼리 응답 캐시 관리

자주 쿼리되는 호스팅 피처 레이어의 경우 호스팅 서버의 ArcGIS Server 관리자는 개별 레이어에서 쿼리 응답 캐싱을 활성화하여 성능을 향상시킬 수 있습니다. 활성화되면 클라이언트가 피처 서비스에 고유한 쿼리를 보낼 때마다 피처와 범위가 객체 저장소에 캐시됩니다. 캐시가 저장되는 기간(캐시 만료 정책)과 객체 저장소가 실행 중인 머신에서 사용 가능한 디스크 공간의 용량에 따라 객체 저장소가 가득 찰 수 있으며 이에 따라 작동을 중지할 수 있습니다.

ArcGIS Data Store 관리자는 다른 소프트웨어와는 별도로 머신에 객체 저장소를 구성하고 이러한 캐시를 저장할 수 있는 여유 디스크 공간이 있는지 확인해야 합니다. 또한 객체 저장소가 용량 한도에 가까워지는 시기를 감지하려면 ArcGIS Data Store 로그를 모니터링해야 합니다. 객체 저장소의 유효성을 검사하여 객체 저장소 머신에서 사용 중인 디스크 공간의 비율(%)을 확인하고 유틸리티를 실행하여 용량이 가장 큰 레이어 캐시를 확인할 수 있습니다. 필요한 경우 ArcGIS Server 관리자와 협력하여 캐시 만료 정책을 변경하거나 대용량 레이어 캐시를 삭제합니다.

피처 레이어에 대한 쿼리 응답 캐싱 활성화

호스팅 피처 레이어(피처 서비스)의 레이어에서 캐싱을 활성화하려면 호스팅 서버 사이트의 ArcGIS Server 관리자가 호스팅 서버의 ArcGIS Server 관리자 디렉터리에 로그인하고 다음 요청을 제출해야 합니다.

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

데이터가 자주 업데이트되는 경우에는 캐싱을 사용하지 마세요. 레이어가 업데이트될 때마다 캐시를 다시 생성해야 하므로 자주 편집하는 피처 레이어에서 캐시된 쿼리를 사용할 때 성능이 향상되지 않습니다.

캐시 만료 정책 설정 또는 변경

캐시는 고유한 쿼리별로 생성됩니다. 객체 저장소 머신에 여유 디스크 공간이 있고 많은 클라이언트가 레이어에 접근하는 경우 캐시가 만료되지 않도록 설정합니다. 이전 섹션에 나온 요청 예시에서는 만료 없이 캐싱을 활성화합니다.

지속적으로 접근하지 않는 레이어의 경우 또는 디스크 공간에 문제가 있는 경우 레이어에 대한 쿼리 응답 캐시가 보존되는 기간(일)을 설정합니다.

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

캐시는 UTC 시간으로 자정에 만료됩니다. 만료 정책을 1로 설정하면 캐시가 생성된 시기에 따라 최대 2일 동안 지속될 수 있습니다.

예를 들어 클라이언트가 4:00 UTC에 피처 레이어에 접근하면 캐시는 다음 날 24:00 UTC까지 유지됩니다.

레이어에 대한 캐시 삭제

객체 저장소에 디스크 공간이 부족하면 ArcGIS Data Store 로그에 경고가 표시되고 validate REST 명령은 사용된 디스크 공간의 양을 표시합니다. 기존 객체 저장소에 디스크 공간이나 머신을 추가할 수 없으므로 여유 디스크 공간을 확보하기 위해 캐시를 정리해야 할 수 있습니다. 캐시 정리하려면 호스팅 서버의 ArcGIS Server 관리자가 해당 레이어에 대한 캐싱을 비활성화해야 합니다.

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