1단계: QLDB에서 다이제스트 요청

Amazon QLDB는 원장에 있는 저널의 현재 팁을 다루는 다이제스트를 요청하는 API를 제공합니다. 저널 팁은 QLDB가 요청을 수신한 시점을 기준으로 가장 최근에 커밋된 블록을 나타냅니다. AWS Management Console, AWS SDK 또는 AWS Command Line Interface (AWS CLI) 를 사용하여 다이제스트를 가져올 수 있습니다.

AWS Management Console

다음 단계에 따라 QLDB 콘솔을 사용하여 리소스를 복원합니다.

다이제스트를 요청하려면(콘솔)

1. 에 AWS Management Console로그인하고 https://console.aws.amazon.com/qldb 에서 Amazon QLDB 콘솔을 엽니다.

2. 탐색 창에서 원장을 선택합니다.

3. 원장 목록에서 다이제스트를 요청하려는 원장명을 선택합니다.

4. 다이제스트 가져오기를 선택합니다. 다이제스트 가져오기 대화 상자에는 다음과 같은 다이제스트 세부 정보가 표시됩니다.

   • 다이제스트 – 요청한 다이제스트의 SHA-256 해시 값.

   • 다이제스트 팁 주소 – 요청한 다이제스트에 포함된 저널의 최신 블록 위치. 주소에는 다음과 같은 두 가지 필드가 있습니다.

     • strandId - 블록을 포함하는 저널 스트랜드의 고유 ID입니다.

     • sequenceNo – 스트랜드 내 블록의 위치를 지정하는 인덱스 번호.

   • 원장 – 다이제스트를 요청한 원장 이름.

   • 날짜 – 다이제스트를 요청한 시점의 타임스탬프.

5. 다이제스트 정보를 검토합니다. 그런 다음 저장을 선택합니다. 기본 파일 이름을 유지하거나 새 이름을 입력할 수 있습니다.

   참고

   원장의 데이터를 수정하지 않아도 다이제스트 해시 및 팁 주소 값이 변경되는 것을 확인할 수 있습니다. 이는 PartiQL 편집기에서 쿼리를 실행할 때마다 콘솔이 원장의 시스템 카탈로그를 검색하기 때문입니다. 이는 저널에 커밋되어 최신 블록 주소를 변경하는 읽기 트랜잭션입니다.

   이 단계는 콘텐츠가 포함된 일반 텍스트 파일을 Amazon Ion 형식으로 저장합니다. 파일의 파일 이름 확장자는 .ion.txt이며 이전 대화 상자에 나열된 모든 다이제스트 정보를 포함합니다. 다음은 다이제스트 파일의 내용을 보여주는 예제입니다. 필드 순서는 브라우저에 따라 다를 수 있습니다.

   {
     "digest": "42zaJOfV8iGutVGNaIuzQWhD5Xb/5B9lScHnvxPXm9E=",
     "digestTipAddress": "{strandId:\"BlFTjlSXze9BIh1KOszcE3\",sequenceNo:73}",
     "ledger": "my-ledger",
     "date": "2019-04-17T16:57:26.749Z"
   }

6. 나중에 액세스할 수 있는 위치에 이 파일을 저장하세요. 나중에 이 파일을 사용하여 문서 수정본을 확인할 수 있습니다.

   중요

   나중에 확인하는 문서 수정본은 저장한 다이제스트에 포함되어야 합니다. 즉, 문서 주소의 시퀀스 번호는 다이제스트 팁 주소의 시퀀스 번호보다 작거나 같아야 합니다.

QLDB API

Amazon QLDB API를 AWS SDK 또는 AWS CLI와 함께 사용하여 원장의 다이제스트를 요청할 수도 있습니다. 애플리케이션 프로그램에서 사용할 수 있는 다음과 같은 기능이 API에서 제공됩니다.

• GetDigest— 저널에서 가장 최근에 커밋된 블록의 원장 요약을 반환합니다. 응답에는 256비트 해시 값과 블록 주소가 포함됩니다.

를 사용하여 다이제스트를 요청하는 방법에 대한 자세한 내용은 명령 참조의 AWS CLIget-digest 명령을 참조하십시오.AWS CLI

샘플 애플리케이션

자바 코드 예제는 aws-samples/ -java 리포지토리를 참조하십시오. GitHub amazon-qldb-dmv-sample 이 샘플 애플리케이션을 다운로드하여 설치하는 방법에 대한 자세한 내용은 Amazon QLDB Java 샘플 애플리케이션 설치 섹션을 참조하세요. 다이제스트를 요청하기 전에 Java 자습서의 1~3단계에 따라 샘플 원장을 생성하고 샘플 데이터와 함께 로드해야 합니다.

클래스의 자습서 코드는 샘플 원장에 다이제스트를 요청하는 예를 GetDigest제공합니다. vehicle-registration

저장한 다이제스트를 사용하여 문서 수정본을 확인하려면 2단계: QLDB에서 데이터 확인로 진행합니다.