빠른 재설정 API를 사용하여 Amazon Neptune DB 클러스터 비우기

먼저 데이터베이스 재설정을 수행하는 데 사용할 수 있는 토큰을 생성합니다. 이 단계는 다른 사람이 실수로 데이터베이스를 재설정하는 것을 방지하기 위한 것입니다.

이를 위해서는 DB 클러스터의 라이터 인스턴스에 있는 /system 엔드포인트에 initiateDatabaseReset 작업을 지정하라는 HTTP POST 요청을 보내면 됩니다.

JSON 콘텐츠 유형을 사용하는 curl 명령은 다음과 같습니다.

curl -X POST \
  -H 'Content-Type: application/json' \
      https://your_writer_instance_endpoint:8182/system \
  -d '{ "action" : "initiateDatabaseReset" }'

또는 x-www-form-urlencoded 콘텐츠 유형 사용:

curl -X POST \
  -H 'Content-Type: application/x-www-form-urlencoded' \
      https://your_writer_instance_endpoint:8182/system \
  -d 'action=initiateDatabaseReset '

initiateDatabaseReset 요청은 다음과 같이 JSON 응답으로 재설정 토큰을 반환합니다.

{
  "status" : "200 OK",
  "payload" : {
    "token" : "new_token_guid"
  }
}

토큰은 발급 후 1시간(60분) 동안 유효합니다.

요청을 리더 인스턴스나 상태 엔드포인트로 보내면 Neptune에서 ReadOnlyViolationException이 발생합니다.

initiateDatabaseReset 요청을 여러 번 보내는 경우 가장 최근에 생성된 토큰만 실제로 재설정을 수행하는 두 번째 단계에서 유효합니다.

initiateDatabaseReset 요청 직후 서버를 다시 시작하면 생성된 토큰은 유효하지 않게 되므로 새 토큰을 받으려면 새 요청을 보내야 합니다.

다음으로, initiateDatabaseReset에서 돌려받은 토큰과 함께 DB 클러스터의 라이터 인스턴스에 있는 /system 엔드포인트로 performDatabaseReset 요청을 보냅니다. 이렇게 하면 DB 클러스터의 데이터가 모두 삭제됩니다.

JSON 콘텐츠 유형을 사용하는 curl 명령:

curl -X POST \
  -H 'Content-Type: application/json' \
      https://your_writer_instance_endpoint:8182/system \
  -d '{
        "action" : "performDatabaseReset",
        "token" : "token_guid"
      }'

또는 x-www-form-urlencoded 콘텐츠 유형 사용:

curl -X POST \
  -H 'Content-Type: application/x-www-form-urlencoded' \
      https://your_writer_instance_endpoint:8182/system \
  -d 'action=performDatabaseReset&token=token_guid'

요청은 JSON 응답을 반환합니다. 요청이 수락된 경우 응답은 다음과 같습니다.

{
  "status" : "200 OK"
}

전송한 토큰이 발급된 토큰과 일치하지 않는 경우 응답은 다음과 같습니다.

{
  "code" : "InvalidParameterException",
  "requestId":"token_guid",
  "detailedMessage" : "System command parameter 'token' : 'token_guid' does not match database reset token"
}

요청이 수락되고 재설정이 시작되면 서버가 다시 시작되고 데이터가 삭제됩니다. 재설정하는 동안에는 DB 클러스터에 다른 요청을 보낼 수 없습니다.

AWS_ACCESS_KEY_ID 및 AWS_SECRET_ACCESS_KEY 환경 변수를 올바르게 설정하세요(임시 자격 증명을 사용하는 경우에도 AWS_SECURITY_TOKEN입니다).

initiateDatabaseReset 요청은 다음과 같습니다.

awscurl -X POST --service neptune-db "$SYSTEM_ENDPOINT" \
  -H 'Content-Type: application/json' --region us-west-2 \
  -d '{ "action" : "initiateDatabaseReset" }'

performDatabaseReset 요청은 다음과 같습니다.

awscurl -X POST --service neptune-db "$SYSTEM_ENDPOINT" \
  -H 'Content-Type: application/json' --region us-west-2 \
  -d '{ "action" : "performDatabaseReset" }'