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

# 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에서 발생하는 런타임 오류를 설명합니다.

다음은 서비스에서 반환하는 일반적인 예외 목록입니다. 각 예외에는 특정 오류 메시지와 가능한 해결 방법에 대한 간단한 설명 및 제안이 포함됩니다.<a name="streams.errors.varlist"></a>

**AccessDeniedException**  
메시지: User: *userARN* is not authorized to perform: iam:PassRole on resource: *roleARN*  
IAM 역할을 QLDB 서비스에 전달할 권한이 없습니다. QLDB에는 모든 저널 스트림 요청에 대한 역할이 필요하며 이 역할을 QLDB에 전달할 수 있는 권한이 있어야 합니다. 이 역할은 지정된 Amazon Kinesis Data Streams 리소스에 대한 쓰기 권한을 QLDB에 제공합니다.  
QLDB 서비스(`qldb.amazonaws.com`)의 지정된 IAM 역할 리소스에서 `PassRole` API 작업을 수행할 권한을 부여하는 IAM 정책을 정의했는지 확인하세요. 정책 예제는 [Amazon QLDB의 자격 증명 기반 정책 예](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-stream-to-kinesis)을 참조하십시오.

**IllegalArgumentException**  
메시지:  QLDB encountered an error validating Kinesis Data Streams: Response from Kinesis: *errorCode**errorMessage*  
이 오류의 가능한 원인은 제공된 Kinesis Data Streams 리소스가 존재하지 않기 때문입니다. 또는 QLDB에 지정된 Kinesis 데이터 스트림에 데이터 레코드를 쓸 수 있는 충분한 권한이 없습니다.  
스트림 요청에서 제공하는 Kinesis 데이터 스트림이 올바른지 확인하세요. 자세한 내용은 *Amazon Kinesis Data Streams 개발자 안내서*의 [데이터 스트림 생성 및 업데이트](https://docs.aws.amazon.com/streams/latest/dev/amazon-kinesis-streams.html)를 참조하세요.  
또한 다음 작업에 QLDB 서비스(`qldb.amazonaws.com`) 권한을 부여하는 지정된 Kinesis 데이터 스트림에 대한 정책을 정의했는지 확인합니다. 자세한 내용은 [스트림 권한](streams.perms.md)을 참조하십시오.  
+ `kinesis:PutRecord`
+ `kinesis:PutRecords`
+ `kinesis:DescribeStream`
+ `kinesis:ListShards`

**IllegalArgumentException**  
메시지:  Kinesis 구성을 검증하는 동안 Kinesis 데이터 스트림에서 예상치 못한 응답이 발생했습니다. Kinesis의 응답: *errorCode**errorMessage*  
제공된 Kinesis 오류 응답으로 인해 제공된 Kinesis 데이터 스트림에 데이터 레코드를 쓰려는 시도가 실패했습니다. 발생 가능한 원인에 대한 자세한 내용은 *Amazon Kinesis Data Streams 개발자 안내서*의 [Amazon Kinesis Data Streams 생산자 문제 해결](https://docs.aws.amazon.com/streams/latest/dev/troubleshooting-producers.html)을 참조하세요.

**IllegalArgumentException**  
메시지:  시작 날짜는 종료 날짜보다 이후일 수 없습니다.  
`InclusiveStartTime` 및 `ExclusiveEndTime`은 [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) 날짜 및 시간 형식이어야 하며 협정 세계시(UTC)여야 합니다.

**IllegalArgumentException**  
메시지:  종료일은 미래일 수 없습니다   
`InclusiveStartTime` 및 `ExclusiveEndTime`은 UTC 기준의 `ISO 8601` 날짜 및 시간 형식이어야 합니다.

**LimitExceededException**  
메시지:  Kinesis Data Streams에 대한 동시 실행 저널 스트림 제한인 5개를 초과했습니다‭ ‬  
QLDB는 기본적으로 동시 저널 스트림을 5개로 제한합니다.