기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
QLDB에서 저널 내보내기 요청
중요
지원 종료 알림: 기존 고객은 07/31/2025에 지원이 종료될 때까지 Amazon QLDB를 사용할 수 있습니다. 자세한 내용은 Amazon QLDB 원장을 Amazon Aurora PostgreSQL로 마이그레이션
Amazon QLDB는 지정된 날짜 및 시간 범위와 지정된 Amazon S3 버킷 대상으로 저널 블록 내보내기를 요청하는 API를 제공합니다. 저널 내보내기 작업은 Amazon Ion 형식의 텍스트 또는 이진 표현이나 JSON Lines
AWS Management Console
다음 단계에 따라 QLDB 콘솔을 사용하여 QLDB에서 저널 내보내기 요청을 제출하세요.
내보내기를 요청하려면(콘솔)
에 로그인 AWS Management Console하고 https://console.aws.amazon.com/qldb
Amazon QLDB 콘솔을 엽니다. -
탐색 창에서 내보내기를 선택합니다.
-
내보내기 작업 생성을 선택합니다.
-
내보내기 작업 생성 페이지에서 다음 내보내기 설정을 입력합니다.
-
원장 - 내보내기하려는 저널 블록이 있는 원장입니다.
-
시작 날짜 및 시간 - 내보내기할 저널 블록 범위의 포함되는 시작 타임스탬프로, 협정 세계시(UTC) 기준입니다. 이 타임스탬프는 종료 날짜 및 시간보다 이전이어야 합니다. 원장의
CreationDateTime
보다 이전인 시작 타임스탬프를 제공하는 경우 QLDB는 기본값을 원장의CreationDateTime
으로 설정합니다. -
종료 날짜 및 시간 - 내보낼 저널 블록 범위의 불포함되는 종료 타임스탬프(UTC)입니다. 이 날짜와 시간은 미래일 수 없습니다.
-
저널 블록 대상 - 내보내기 작업이 데이터 객체를 기록하는 Amazon S3 버킷 및 접두사 이름. 다음 Amazon S3 URI 형식을 사용하세요.
s3://amzn-s3-demo-qldb-cloudtrail/
prefix
/출력 객체에 대해 S3 버킷 이름과 선택적 접두사 이름을 지정해야 합니다. 다음은 예입니다.
s3://amzn-s3-demo-qldb-cloudtrail/journalExport/
버킷 이름과 접두사는 모두 Amazon S3 이름 지정 규칙 및 규칙을 준수해야 합니다. 버킷 이름 지정에 대한 자세한 내용은 Amazon S3 개발자 안내서의 버킷 규제 및 제한을 참조하세요. 객체 이름 접두사에 대한 자세한 내용은 객체 키와 메타데이터 섹션을 참조하세요.
참고
크로스 리전 쿼리는 지원되지 않습니다. 지정된 Amazon S3 버킷은 원장 AWS 리전 과 동일해야 합니다.
-
S3 암호화 - 내보내기 작업에서 Amazon S3 버킷에 데이터를 쓰기 위해 사용하는 암호화 설정입니다. Amazon S3의 서버 측 암호화 옵션에 대한 자세한 내용은 Amazon S3 개발자 안내서의 서버 측 암호화를 사용한 데이터 보호를 참조하세요.
-
버킷 기본 암호화 - 지정된 Amazon S3 버킷의 기본 암호화 설정을 사용합니다.
-
AES-256 - Amazon S3 관리형 키(SSE-S3)로 서버 측 암호화를 사용.
-
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 역할은 QLDB에 KMS 키를 사용할 수 있는 권한도 부여해야 합니다.
저널 내보내기를 요청할 때 QLDB에 역할을 전달하려면 IAM 역할 리소스에서
iam:PassRole
작업을 수행할 수 있는 권한이 있어야 합니다.-
새 서비스 역할 생성 및 사용 - 콘솔에서 지정된 Amazon S3 버킷에 필요한 권한을 가진 새 역할을 생성하도록 합니다.
-
기존 서비스 역할 사용 - IAM에서 이 역할을 수동으로 생성하는 방법을 알아보려면 내보내기 권한 섹션을 참조하세요.
-
-
출력 형식 - 내보낸 저널 데이터의 출력 형식
-
Ion 텍스트 - (기본값)Amazon Ion의 텍스트 표현
-
Ion 이진수 - Amazon 이온의 이진수 표현
-
JSON - 줄바꿈으로 구분된 JSON 텍스트 형식
JSON을 선택하면 QLDB는 내보낸 데이터 객체의 Ion 저널 데이터를 JSON으로 하향 변환합니다. 자세한 내용은 JSON으로 하향 변환을 참조하십시오.
-
-
-
원하는 대로 설정되었으면 내보내기 작업 생성을 선택합니다.
내보내기 작업을 완료하는 데 걸리는 시간은 데이터 크기에 따라 다릅니다. 요청을 성공적으로 제출하면 콘솔이 기본 내보내기 페이지로 돌아가고 내보내기 작업이 현재 상태와 함께 나열됩니다.
-
Amazon S3 콘솔에서 내보내기 객체를 볼 수 있습니다.
https://console.aws.amazon.com/s3/
에서 Amazon S3 콘솔을 엽니다. 이러한 출력 객체의 형식에 대한 자세한 내용은 QLDB의 저널 내보내기 출력 섹션을 참조하세요.
참고
내보내기 작업은 완료 후 7일이 지나면 만료됩니다. 자세한 내용은 내보내기 작업 만료을 참조하십시오.
QLDB API
AWS SDK 또는와 함께 Amazon QLDB API를 사용하여 저널 내보내기를 요청할 수도 있습니다 AWS CLI. 애플리케이션 프로그램에서 사용할 수 있는 다음과 같은 기능이 QLDB API에서 제공됩니다.
-
ExportJournalToS3
- 주어진 원장에서 날짜 및 시간 범위 내의 저널 콘텐츠를 주어진 Amazon S3 버킷으로 내보냅니다. 내보내기 작업은 Amazon Ion 형식의 텍스트 또는 이진수 표현이나 JSON Lines 텍스트 형식의 객체로 데이터를 쓸 수 있습니다. -
DescribeJournalS3Export
- 저널 내보내기 작업에 대한 자세한 정보를 반환합니다. 출력에는 현재 상태, 작성 시간, 원본 내보내기 요청의 파라미터가 포함됩니다. -
ListJournalS3Exports
- 현재 AWS 계정 및 리전과 관련된 모든 원장에 대한 저널 내보내기 작업 설명 목록을 반환합니다. 각 내보내기 작업 설명의 출력에는DescribeJournalS3Export
에서 반환한 것과 동일한 세부 정보가 포함됩니다. -
ListJournalS3ExportsForLedger
- 주어진 원장에 대한 저널 내보내기 작업 설명 목록을 반환합니다. 각 내보내기 작업 설명의 출력에는DescribeJournalS3Export
에서 반환한 것과 동일한 세부 정보가 포함됩니다.
이러한 API작업 설명 전체를 보려면 Amazon QLDB API 참조 섹션을 참조하세요.
를 사용하여 저널 데이터를 내보내는 방법에 대한 자세한 AWS CLI내용은 AWS CLI 명령 참조를 참조하세요.
샘플 애플리케이션(Java)
기본 내보내기 작업의 Java 코드 예제는 GitHub 리포지토리 aws-samples/amazon-qldb-dmv-sample-java
다음 클래스의 자습서 코드는 내보내기 생성, 내보내기 상태 확인, 내보내기 출력 처리의 예를 제공합니다.
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는 이전 내보내기 작업을 제거하여 여러 페이지의 작업을 파싱하지 않고도 최근 내보내기만 볼 수 있도록 합니다.