기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

DFENeptune에서 사용할 통계 관리

DFE엔진은 Neptune 그래프의 데이터에 대한 정보를 사용하여 쿼리 실행을 계획할 때 효과적인 절충안을 마련합니다. 이 정보는 쿼리 계획의 지침이 될 수 있는 소위 특성 세트와 조건자 통계를 포함하는 통계의 형태를 취합니다.

엔진 릴리스 1.2.1.0부터 또는 엔드포인트를 사용하여 이러한 통계에서 그래프에 대한 요약 정보를 검색할 수 있습니다. GetGraphSummaryAPIsummary

이러한 DFE 통계는 현재 그래프의 데이터가 10% 이상 변경되거나 최신 통계가 10일 이상 경과한 경우 다시 생성됩니다. 그러나 이러한 트리거는 향후 변경될 수 있습니다.

다음 엔드포인트 중 하나를 통해 DFE 통계 생성을 관리할 수 있습니다.

아래 예제에서 는 이러한 엔드포인트 중 하나를 $STATISTICS_ENDPOINT 나타냅니다. URLs

DFE통계 생성을 위한 크기 제한

현재 다음 크기 제한 중 하나에 도달하면 DFE 통계 생성이 중단됩니다.

이러한 제한은 변경할 수 있습니다.

통계의 DFE 현재 상태

다음 curl 요청을 사용하여 DFE 통계의 현재 상태를 확인할 수 있습니다.

curl -G "$STATISTICS_ENDPOINT"

상태 요청에 대한 응답에는 다음 필드가 포함됩니다.

통계가 생성되지 않은 경우 상태 요청에 대한 응답은 다음과 같습니다.

{
  "status" : "200 OK",
  "payload" : {
    "autoCompute" : true,
    "active" : false,
    "statisticsId" : -1
   }
}

DFE통계를 사용할 수 있는 경우 응답은 다음과 같습니다.

{
  "status" : "200 OK",
  "payload" : {
    "autoCompute" : true,
    "active" : true,
    "statisticsId" : 1588893232718,
    "date" : "2020-05-07T23:13Z",
    "summary" : {
      "signatureCount" : 5,
      "instanceCount" : 1000,
      "predicateCount" : 20
    }
  }
}

DFE통계 크기 제한을 초과하는 등의 이유로 통계 생성이 실패한 경우 응답은 다음과 같습니다.

{
  "status" : "200 OK",
  "payload" : {
    "autoCompute" : true,
    "active" : false,
    "statisticsId" : 1588713528304,
    "date" : "2020-05-05T21:18Z",
    "note" : "Limit reached: Statistics are not available"
  }
}

통계 자동 생성 비활성화 DFE

활성화하면 기본적으로 DFE 통계 자동 생성이 활성화됩니다. DFE

다음과 같이 자동 생성을 비활성화할 수 있습니다.

curl -X POST "$STATISTICS_ENDPOINT" -d '{ "mode" : "disableAutoCompute" }'

요청이 성공하면 HTTP 응답 코드는 다음과 200 같고 응답은 다음과 같습니다.

{
  "status" : "200 OK"
}

상태 요청을 실행하고 응답의 autoCompute 필드가 false로 설정되어 있는지 확인하여 자동 생성이 비활성화되었는지 확인할 수 있습니다.

통계 자동 생성을 비활성화해도 진행 중인 통계 계산은 종료되지 않습니다.

DB 클러스터의 Writer 인스턴스가 아닌 리더 인스턴스에 자동 생성을 비활성화하도록 요청하면 요청이 실패하고 HTTP 반환 코드 400이 표시되고 다음과 같은 결과가 출력됩니다.

{
  "detailedMessage" : "Writes are not permitted on a read replica instance",
  "code" : "ReadOnlyViolationException",
  "requestId":"8eb8d3e5-0996-4a1b-616a-74e0ec32d5f7"
}

기타 일반적인 오류 목록은 일반적인 오류 섹션을 참조하세요.

통계 자동 생성 다시 활성화 DFE

활성화하면 기본적으로 DFE 통계 자동 생성이 이미 활성화되어 있습니다DFE. 자동 생성을 비활성화한 경우 나중에 다음과 같이 다시 활성화할 수 있습니다.

curl -X POST "$STATISTICS_ENDPOINT" -d '{ "mode" : "enableAutoCompute" }'

요청이 성공하면 HTTP 응답 코드는 다음과 200 같으며 응답은 다음과 같습니다.

{
  "status" : "200 OK"
}

상태 요청을 실행하고 응답의 autoCompute 필드가 true로 설정되어 있는지 확인하여 자동 생성이 활성화되었는지 확인할 수 있습니다.

통계 생성을 수동으로 트리거합니다. DFE

다음과 같이 DFE 통계 생성을 수동으로 시작할 수 있습니다.

curl -X POST "$STATISTICS_ENDPOINT" -d '{ "mode" : "refresh" }'

요청이 성공하면 출력은 다음과 같으며 HTTP 반환 코드는 200입니다.

{
  "status" : "200 OK",
  "payload" : {
    "statisticsId" : 1588893232718
  }
}

출력의 statisticsId는 현재 진행 중인 통계 생성 실행의 ID입니다. 요청 당시 실행이 이미 처리 중이었던 경우 요청은 새 실행을 시작하지 않고 해당 실행의 ID를 반환합니다. 한 번에 하나의 통계 생성 실행만 수행될 수 있습니다.

DFE통계가 생성되는 동안 페일오버가 발생하면 새 작성기 노드가 마지막으로 처리된 체크포인트를 선택하고 거기서부터 통계 실행을 재개합니다.

StatsNumStatementsScanned CloudWatch 메트릭을 사용하여 통계 계산을 모니터링합니다.

이 StatsNumStatementsScanned CloudWatch 지표는 서버 시작 이후 통계 계산을 위해 스캔한 총 명령문 수를 반환합니다. 각 통계 계산 조각에서 업데이트됩니다.

통계 계산이 트리거될 때마다 이 수치는 증가하며 계산이 수행되지 않을 때는 일정하게 유지됩니다. 따라서 시간 경과에 따른 StatsNumStatementsScanned 값 그래프를 보면 통계 계산이 이루어진 시기와 속도를 매우 명확하게 파악할 수 있습니다.

계산이 진행 중일 때 그래프의 기울기는 속도를 나타냅니다. 기울기가 가파를수록 통계가 더 빨리 계산된다는 뜻입니다.

그래프가 0에서 평평한 선으로만 그려진 경우 통계 기능은 활성화되었으나 통계가 전혀 계산되지 않은 것입니다. 통계 기능이 비활성화되었거나 통계 계산을 지원하지 않는 엔진 버전을 사용하는 경우에는 StatsNumStatementsScanned가 존재하지 않습니다.

앞서 설명한 것처럼 통계를 사용하여 통계 계산을 비활성화할 수 있지만 이 계산을 중단하면 통계가 최신 상태로 유지되지 않아 DFE 엔진에 대한 쿼리 계획 생성 성능이 저하될 수 있습니다. API

사용 CloudWatch 방법에 아마존을 이용한 Neptune 모니터링 CloudWatch 대한 자세한 내용은 을 참조하십시오.

DFE통계 엔드포인트에서 AWS Identity and Access Management (IAM) 인증 사용

awscurl 또는 및 와 함께 작동하는 다른 도구를 사용하여 IAM 인증을 통해 DFE 통계 엔드포인트에 안전하게 액세스할 수 있습니다. HTTPS IAM 적절한 보안 인증 정보를 설정하는 방법을 보려면 임시 자격 awscurl 증명과 함께 사용하여 IAM 인증이 활성화된 상태에서 DB 클러스터에 안전하게 연결을 참조하세요. 그런 다음 아래와 같이 상태 요청을 제출할 수 있습니다.

awscurl "$STATISTICS_ENDPOINT" \
    --region (your region) \
    --service neptune-db

또는 예를 들어, 다음을 포함하는 이름의 JSON 파일을 만들 수 있습니다. request.json

{ "mode" : "refresh" }

그런 다음 아래와 같이 통계 생성을 수동으로 시작할 수 있습니다.

awscurl "$STATISTICS_ENDPOINT" \
    --region (your region) \
    --service neptune-db \
    -X POST -d @request.json

DFE통계 삭제

통계 엔드포인트에 HTTP DELETE 요청하여 데이터베이스의 모든 통계를 삭제할 수 있습니다.

curl -X "DELETE" "$STATISTICS_ENDPOINT"

유효한 HTTP 반환 코드는 다음과 같습니다.

리더 노드의 통계 엔드포인트로 삭제 요청을 보내면 ReadOnlyViolationException이 발생합니다.

DFE통계 요청의 일반적인 오류 코드

다음은 통계 엔드포인트에 요청할 때 발생할 수 있는 일반적인 오류 목록입니다.

예를 들어, DFE 및 통계가 활성화되지 않은 상태에서 요청을 보내면 다음과 같은 응답을 받게 됩니다.

{
  "code" : "BadRequestException",
  "requestId" : "b2b8f8ee-18f1-e164-49ea-836381a3e174",
  "detailedMessage" : "Bad route: /sparql/statistics"
}