기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# QLDB에서 저널 내보내기 요청
**중요**
지원 종료 공지: 기존 고객은 07/31/2025에 지원이 종료될 때까지 Amazon QLDB를 사용할 수 있습니다. 자세한 내용은 [Amazon QLDB 원장을 Amazon Aurora PostgreSQL로 마이그레이션](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/)을 참조하세요.
Amazon QLDB는 지정된 날짜 및 시간 범위와 지정된 Amazon S3 버킷 대상으로 저널 블록 내보내기를 요청하는 API를 제공합니다. 저널 내보내기 작업은 [Amazon Ion](ion.md) 형식의 텍스트 또는 이진 표현이나 [JSON Lines](https://jsonlines.org/) 텍스트 형식으로 데이터 객체를 쓸 수 있습니다. AWS Management Console, AWS SDK 또는 AWS Command Line Interface (AWS CLI)를 사용하여 내보내기 작업을 생성할 수 있습니다.
**Topics**
+ [AWS Management Console](#export-journal.request.con)
+ [QLDB API](#export-journal.request.api)
+ [내보내기 작업 만료](#export-journal.request.expiration)
## AWS Management Console
다음 단계에 따라 QLDB 콘솔을 사용하여 QLDB에서 저널 내보내기 요청을 제출하세요.
**내보내기를 요청하려면(콘솔)**
1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/qldb](https://console.aws.amazon.com/qldb) Amazon QLDB 콘솔을 엽니다.
1. 탐색 창에서 **내보내기**를 선택합니다.
1. **내보내기 작업 생성**을 선택합니다.
1. **내보내기 작업 생성** 페이지에서 다음 내보내기 설정을 입력합니다.
+ **원장** - 내보내기하려는 저널 블록이 있는 원장입니다.
+ **시작 날짜 및 시간** - 내보내기할 저널 블록 범위의 포함되는 시작 타임스탬프로, 협정 세계시(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 개발자 안내서*의 [버킷 규제 및 제한](https://docs.aws.amazon.com/AmazonS3/latest/userguide/BucketRestrictions.html)을 참조하세요. 객체 이름 접두사에 대한 자세한 내용은 [객체 키와 메타데이터](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingMetadata.html) 섹션을 참조하세요.
**참고**
크로스 리전 쿼리는 지원되지 않습니다. 지정된 Amazon S3 버킷은 원장 AWS 리전 과 동일한에 있어야 합니다.
+ **S3 암호화** - 내보내기 작업에서 Amazon S3 버킷에 데이터를 쓰기 위해 사용하는 암호화 설정입니다. Amazon S3의 서버 측 암호화 옵션에 대한 자세한 내용은 *Amazon S3 개발자 안내서*의 [서버 측 암호화를 사용한 데이터 보호](https://docs.aws.amazon.com/AmazonS3/latest/userguide/serv-side-encryption.html)를 참조하세요.
+ **버킷 기본 암호화** - 지정된 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에서 이 역할을 수동으로 생성하는 방법을 알아보려면 [내보내기 권한](export-journal.perms.md) 섹션을 참조하세요.
+ **출력 형식** - 내보낸 저널 데이터의 출력 형식
+ **Ion 텍스트** - (기본값)Amazon Ion의 텍스트 표현
+ **Ion 이진수** - Amazon 이온의 이진수 표현
+ **JSON** - 줄바꿈으로 구분된 JSON 텍스트 형식
JSON을 선택하면 QLDB는 내보낸 데이터 객체의 Ion 저널 데이터를 JSON으로 하향 변환합니다. 자세한 내용은 [JSON으로 하향 변환](export-journal.output.md#export-journal.output.json)을 참조하십시오.
1. 원하는 대로 설정되었으면 **내보내기 작업 생성**을 선택합니다.
내보내기 작업을 완료하는 데 걸리는 시간은 데이터 크기에 따라 다릅니다. 요청을 성공적으로 제출하면 콘솔이 기본 **내보내기** 페이지로 돌아가고 내보내기 작업이 현재 상태와 함께 나열됩니다.
1. Amazon S3 콘솔에서 내보내기 객체를 볼 수 있습니다.
[https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)에서 S3 콘솔을 엽니다.
이러한 출력 객체의 형식에 대한 자세한 내용은 [QLDB의 저널 내보내기 출력](export-journal.output.md) 섹션을 참조하세요.
**참고**
내보내기 작업은 완료 후 7일이 지나면 만료됩니다. 자세한 내용은 [내보내기 작업 만료](#export-journal.request.expiration)을 참조하십시오.
## 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 참조](api-reference.md) 섹션을 참조하세요.
를 사용하여 저널 데이터를 내보내는 방법에 대한 자세한 AWS CLI내용은 [AWS CLI 명령 참조](https://docs.aws.amazon.com/cli/latest/reference/qldb/index.html)를 참조하세요.
### 샘플 애플리케이션(Java)
기본 내보내기 작업의 Java 코드 예제는 GitHub 리포지토리 [aws-samples/amazon-qldb-dmv-sample-java](https://github.com/aws-samples/amazon-qldb-dmv-sample-java)를 참조하세요. 이 샘플 애플리케이션을 다운로드하여 설치하는 방법에 대한 자세한 내용은 [Amazon QLDB Java 샘플 애플리케이션 설치](sample-app.java.md) 섹션을 참조하세요. 내보내기를 요청하기 전에 [Java 자습서](getting-started.java.tutorial.md)의 1\$13단계에 따라 샘플 원장을 생성하고 샘플 데이터와 함께 로드해야 합니다.
다음 클래스의 자습서 코드는 내보내기 생성, 내보내기 상태 확인, 내보내기 출력 처리의 예를 제공합니다.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/qldb/latest/developerguide/export-journal.request.html)
## 내보내기 작업 만료
완료된 저널 내보내기 작업에는 7일의 보존 기간이 적용됩니다. 이 한도가 만료되면 해당 파일은 자동으로 영구 삭제됩니다. 이 만료 기간은 고정 한도이며 변경할 수 없습니다.
완료된 내보내기 작업이 삭제된 후에는 더 이상 QLDB 콘솔 또는 다음 API 작업을 사용하여 작업에 대한 메타데이터를 검색할 수 없습니다.
+ `DescribeJournalS3Export`
+ `ListJournalS3Exports`
+ `ListJournalS3ExportsForLedger`
하지만 이 만료는 내보낸 데이터 자체에는 영향을 주지 않습니다. 모든 메타데이터는 내보내기로 작성된 매니페스트 파일에 보존됩니다. 이 만료는 저널 내보내기 작업을 나열하는 API 작업을 보다 원활하게 수행할 수 있도록 설계되었습니다. QLDB는 이전 내보내기 작업을 제거하여 여러 페이지의 작업을 파싱하지 않고도 최근 내보내기만 볼 수 있도록 합니다.