

신중한 고려 후 Amazon Kinesis Data Analytics for SQL 애플리케이션을 중단하기로 결정했습니다.

1. **2025년 9월 1**일부터 Amazon Kinesis Data Analytics for SQL 애플리케이션에 대한 버그 수정은 제공되지 않습니다. 곧 중단될 예정이므로 지원이 제한될 예정이기 때문입니다.

2. **2025년 10월 15**일부터 새 Kinesis Data Analytics for SQL 애플리케이션을 생성할 수 없습니다.

3. **2026년 1월 27**일부터 애플리케이션이 삭제됩니다. Amazon Kinesis Data Analytics for SQL 애플리케이션을 시작하거나 작동할 수 없게 됩니다. 그 시점부터 Amazon Kinesis Data Analytics for SQL에 대한 지원을 더 이상 이용할 수 없습니다. 자세한 내용은 [Amazon Kinesis Data Analytics for SQL 애플리케이션 단종](discontinuation.md) 단원을 참조하십시오.

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

# 오류 처리
<a name="error-handling"></a>

Amazon Kinesis Data Analytics는 API 또는 SQL 오류를 사용자에게 직접 반환합니다. API 작업에 대한 자세한 설명은 [작업](API_Operations.md) 섹션을 참조하십시오. SQL 오류 처리에 대한 자세한 설명은 [Amazon Kinesis Data Analytics SQL 참조](https://docs.aws.amazon.com/kinesisanalytics/latest/sqlref/analytics-sql-reference.html)를 참고하십시오.

Amazon Kinesis Data Analytics는 `error_stream`이라고 하는 애플리케이션 내 오류 스트림을 사용하여 런타임 오류를 보고합니다.



## 애플리케이션 내 오류 스트림을 사용한 오류 보고
<a name="error-handling-errorstream"></a>

Amazon Kinesis Data Analytics는 `error_stream`이라고 하는 애플리케이션 내 오류 스트림에 런타임 오류를 보고합니다. 다음은 발생할 수 있는 오류의 예입니다:
+ 스트리밍 소스로부터 읽은 레코드가 입력 스키마에 부합하지 않습니다.
+ 애플리케이션 코드가 0으로 나누기를 지정했습니다.
+ 행이 순서에 벗어난 상태입니다(예: 레코드의 순서 이탈을 야기하는 사용자가 수정한 `ROWTIME` 값을 지닌 스트림 상에 레코드가 나타나는 경우).
+ 소스 스트림에 있는 데이터가 스키마에 지정된 데이터 유형으로 변환되지 않습니다(강제 변환 오류). 변환 가능한 데이터 유형에 관한 정보는 [JSON 데이터 유형을 SQL 데이터 유형으로 매핑하기](sch-mapping.md#sch-mapping-datatypes) 섹션을 참조하십시오.

SQL 코드에서 이러한 오류를 프로그래밍 방식으로 처리하거나 오류 스트림 상의 데이터를 외부 대상에 유지하는 것이 좋습니다. 이를 위해서는 애플리케이션에 출력 구성을 추가해야 합니다([애플리케이션 출력 구성](how-it-works-output.md) 참조). 애플리케이션 내 오류 스트림 작동 방식의 예는 [예: 애플리케이션 내 오류 스트림 탐색](app-explore-error-stream.md) 섹션을 참조하십시오.

**참고**  
시스템 계정을 사용하여 오류 스트림이 생성되었기 때문에 Kinesis Data Analytics 애플리케이션은 오류 스트림을 프로그래밍 방식으로 액세스하거나 수정할 수 없습니다. 오류 출력을 사용하여 애플리케이션에서 발생할 수 있는 에러가 무엇인지 판단해야 합니다. 그런 다음 애플리케이션의 SQL 코드를 작성하여 예상되는 오류 상태를 처리합니다.

### 오류 스트림 스키마
<a name="error-handling-errorstream-schema"></a>

오류 스트림의 스키마는 다음과 같습니다.


****  

|  |  |  | 
| --- |--- |--- |
| *필드* | *데이터 형식* | *참고* | 
| ERROR\_TIME | TIMESTAMP | 오류 발생 시간 | 
| ERROR\_LEVEL | VARCHAR(10) |  | 
| ERROR\_NAME | VARCHAR(32) |  | 
| MESSAGE | VARCHAR(4096) |  | 
| DATA\_ROWTIME | TIMESTAMP | 수신 레코드의 ROW TIME | 
| DATA\_ROW | VARCHAR(49152) |  기존 행에 있는 16진수 인코딩 데이터. 표준 라이브러리를 사용하여 이 값을 16진수로 디코딩하거나 이 [ 16진수 - 문자열 변환기](http://string-functions.com/hex-string.aspx) 같은 웹 리소스를 사용할 수 있습니다. | 
| PUMP\_NAME | VARCHAR(128) |  `CREATE PUMP`로 정의된 원본 펌프 | 