에서 저널 내보내기 요청 QLDB - 아마존 퀀텀 레저 데이터베이스 (아마존QLDB)
AWS Management ConsoleQLDB API내보내기 작업 만료

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

에서 저널 내보내기 요청 QLDB

중요

지원 종료 알림: 기존 고객은 2025년 7월 31일 지원이 종료될 QLDB 때까지 Amazon을 사용할 수 있습니다. 자세한 내용은 아마존 QLDB 원장을 Amazon Aurora SQL Postgre로 마이그레이션을 참조하십시오.

Amazon은 지정된 날짜 및 시간 범위와 지정된 Amazon S3 버킷 대상에 대한 저널 블록 내보내기를 요청할 수 있는 QLDB 기능을 제공합니다. API 저널 내보내기 작업은 Amazon Ion 형식의 텍스트 또는 바이너리 표현이나 JSON라인 텍스트 형식으로 데이터 객체를 쓸 수 있습니다. 다음을 사용할 수 있습니다. AWS Management Console, 그리고 AWS SDK, 또는 AWS Command Line Interface (AWS CLI) 를 눌러 내보내기 작업을 생성합니다.

AWS Management Console

QLDB콘솔을 QLDB 사용하여 저널 내보내기 요청을 제출하려면 다음 단계를 따르십시오.

내보내기를 요청하려면(콘솔)

  1. 에 로그인하십시오. AWS Management Console를 누르고 https://console.aws.amazon.com/qldb에서 아마존 QLDB 콘솔을 엽니다.

  2. 탐색 창에서 내보내기를 선택합니다.

  3. 내보내기 작업 생성을 선택합니다.

  4. 내보내기 작업 생성 페이지에서 다음 내보내기 설정을 입력합니다.

    • 원장 - 내보내기하려는 저널 블록이 있는 원장입니다.

    • 시작 날짜 및 시간 — 내보낼 저널 블록 범위의 협정 세계시 (UTC) 기준 포함 시작 타임스탬프입니다. 이 타임스탬프는 종료 날짜 및 시간보다 이전이어야 합니다. 원장보다 빠른 시작 타임스탬프를 제공하는 경우 원장의 시작 타임스탬프가 QLDB 기본값으로 설정됩니다. CreationDateTime CreationDateTime

    • 종료 날짜 및 시간 — 익스포트할 저널 블록 범위의 단독 종료 타임스탬프 (UTC) 이 날짜와 시간은 미래일 수 없습니다.

    • 저널 블록 대상 - 내보내기 작업이 데이터 객체를 기록하는 Amazon S3 버킷 및 접두사 이름. 다음 Amazon S3 URI 형식을 사용하십시오.

      s3://amzn-s3-demo-bucket/prefix/

      출력 객체에 대해 S3 버킷 이름과 선택적 접두사 이름을 지정해야 합니다. 다음은 예입니다.

      s3://amzn-s3-demo-bucket/journalExport/

      버킷 이름과 접두사는 모두 Amazon S3 이름 지정 규칙 및 규칙을 준수해야 합니다. 버킷 이름 지정에 대한 자세한 내용은 Amazon S3 개발자 안내서의 버킷 규제 및 제한을 참조하세요. 객체 이름 접두사에 대한 자세한 내용은 객체 키와 메타데이터 섹션을 참조하세요.

      참고

      크로스 리전 쿼리는 지원되지 않습니다. 지정된 Amazon S3 버킷은 동일한 위치에 있어야 합니다. AWS 리전 원장으로 사용하세요.

    • S3 암호화 - 내보내기 작업에서 Amazon S3 버킷에 데이터를 쓰기 위해 사용하는 암호화 설정입니다. Amazon S3의 서버 측 암호화 옵션에 대한 자세한 내용은 Amazon S3 개발자 안내서의 서버 측 암호화를 사용한 데이터 보호를 참조하세요.

      • 버킷 기본 암호화 - 지정된 Amazon S3 버킷의 기본 암호화 설정을 사용합니다.

      • AES-256 — Amazon S3 관리 키 (-S3) 와 함께 서버 측 암호화를 사용합니다. SSE

      • AWS- — 다음과 KMS 같은 서버 측 암호화 사용 AWS KMS 관리 키 (SSE-KMS).

        이 유형을 다른 유형 선택과 함께 선택하는 경우 AWS KMS key옵션을 선택하면 다음 Amazon 리소스 이름 (ARN) 형식의 대칭 암호화 KMS 키도 지정해야 합니다.

        arn:aws:kms:aws-region:account-id:key/key-id

    • 서비스 액세스 - Amazon S3 버킷에 QLDB 쓰기 권한을 부여하는 IAM 역할입니다. 해당하는 경우 IAM 역할은 KMS 키 QLDB 사용 권한도 부여해야 합니다.

      저널 내보내기를 요청할 QLDB 때 역할을 전달하려면 IAM 역할 리소스에서 iam:PassRole 작업을 수행할 권한이 있어야 합니다.

      • 새 서비스 역할 생성 및 사용 - 콘솔에서 지정된 Amazon S3 버킷에 필요한 권한을 가진 새 역할을 생성하도록 합니다.

      • 기존 서비스 역할 사용 — 이 역할을 수동으로 만드는 방법을 IAM 알아보려면 을 참조하십시오내보내기 권한.

    • 출력 형식 - 내보낸 저널 데이터의 출력 형식

      • Ion 텍스트 - (기본값)Amazon Ion의 텍스트 표현

      • Ion 이진수 - Amazon 이온의 이진수 표현

      • JSON— 줄바꿈으로 구분된 텍스트 형식 JSON

        원하는 경우 Ion 저널 JSON 데이터를 내보낸 데이터 QLDB 개체로 하향 변환합니다. JSON 자세한 내용은 다음으로 하향 변환 JSON 단원을 참조하십시오.

  5. 원하는 대로 설정되었으면 내보내기 작업 생성을 선택합니다.

    내보내기 작업을 완료하는 데 걸리는 시간은 데이터 크기에 따라 다릅니다. 요청을 성공적으로 제출하면 콘솔이 기본 내보내기 페이지로 돌아가고 내보내기 작업이 현재 상태와 함께 나열됩니다.

  6. Amazon S3 콘솔에서 내보내기 객체를 볼 수 있습니다.

    에서 Amazon S3 콘솔을 엽니다 https://console.aws.amazon.com/s3/.

    이러한 출력 객체의 형식에 대한 자세한 내용은 저널 익스포트 출력은 다음과 같습니다. QLDB 섹션을 참조하세요.

참고

내보내기 작업은 완료 후 7일이 지나면 만료됩니다. 자세한 내용은 내보내기 작업 만료 단원을 참조하십시오.

QLDB API

Amazon에서 다음과 같이 저널 내보내기를 요청할 수도 QLDB API 있습니다. AWS SDK또는 AWS CLI. 는 응용 프로그램에서 사용할 수 있는 다음 작업을 QLDB API 제공합니다.

  • ExportJournalToS3 - 주어진 원장에서 날짜 및 시간 범위 내의 저널 콘텐츠를 주어진 Amazon S3 버킷으로 내보냅니다. 내보내기 작업은 Amazon Ion 형식의 텍스트 또는 바이너리 표현이나 JSON 라인 텍스트 형식의 객체로 데이터를 쓸 수 있습니다.

  • DescribeJournalS3Export - 저널 내보내기 작업에 대한 자세한 정보를 반환합니다. 출력에는 현재 상태, 작성 시간, 원본 내보내기 요청의 파라미터가 포함됩니다.

  • ListJournalS3Exports— 현재와 관련된 모든 원장에 대한 저널 내보내기 작업 설명 목록을 반환합니다. AWS 계정 및 지역. 각 내보내기 작업 설명의 출력에는 DescribeJournalS3Export에서 반환한 것과 동일한 세부 정보가 포함됩니다.

  • ListJournalS3ExportsForLedger - 주어진 원장에 대한 저널 내보내기 작업 설명 목록을 반환합니다. 각 내보내기 작업 설명의 출력에는 DescribeJournalS3Export에서 반환한 것과 동일한 세부 정보가 포함됩니다.

이러한 API 작업에 대한 전체 설명은 를 참조하십시오아마존 QLDB API 레퍼런스.

를 사용하여 저널 데이터를 내보내는 방법에 대한 자세한 내용은 AWS CLI자세한 내용은 AWS CLI 커맨드 레퍼런스.

샘플 애플리케이션(Java)

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

다음 클래스의 자습서 코드는 내보내기 생성, 내보내기 상태 확인, 내보내기 출력 처리의 예를 제공합니다.

Class 설명
ExportJournal vehicle-registration 샘플 원장의 저널 블록을 10분 전부터 지금까지의 타임스탬프 범위로 내보냅니다. 지정된 S3 버킷에 출력 객체를 쓰거나, 지정되지 않은 경우 고유한 버킷을 생성합니다.
DescribeJournalExport vehicle-registration 샘플 원장의 지정된 exportId에 대한 저널 내보내기 작업에 대해 설명합니다.
ListJournalExports vehicle-registration 샘플 원장에 대한 저널 내보내기 작업 설명 목록을 반환합니다.
ValidateQldbHashChain 주어진 exportId를 사용하여 vehicle-registration 샘플 원장의 해시 체인을 확인합니다. 제공되지 않은 경우 해시 체인 확인에 사용할 새 내보내기를 요청합니다.

내보내기 작업 만료

완료된 저널 내보내기 작업에는 7일의 보존 기간이 적용됩니다. 이 한도가 만료되면 해당 파일은 자동으로 영구 삭제됩니다. 이 만료 기간은 고정 한도이며 변경할 수 없습니다.

완료된 내보내기 작업이 삭제된 후에는 더 이상 QLDB 콘솔이나 다음 API 작업을 사용하여 작업에 대한 메타데이터를 검색할 수 없습니다.

  • DescribeJournalS3Export

  • ListJournalS3Exports

  • ListJournalS3ExportsForLedger

하지만 이 만료는 내보낸 데이터 자체에는 영향을 주지 않습니다. 모든 메타데이터는 내보내기로 작성된 매니페스트 파일에 보존됩니다. 이 만료는 저널 내보내기 작업을 나열하는 API 작업을 보다 원활하게 수행할 수 있도록 설계되었습니다. QLDB이전 내보내기 작업을 제거하여 여러 페이지의 작업을 파싱하지 않고도 최근 내보내기만 볼 수 있도록 합니다.