신중한 고려 끝에 두 단계로 Amazon Kinesis Data Analytics for SQL applications를 중단하기로 결정했습니다.
1. 2025년 10월 15일부터 SQL 애플리케이션을 위한 새 Kinesis Data Analytics를 생성할 수 없습니다.
2. 2026년 1월 27일부터 애플리케이션이 삭제됩니다. SQL 애플리케이션용 Amazon Kinesis Data Analytics를 시작하거나 작동할 수 없습니다. 해당 시점부터 에 대한 Amazon Kinesis Data AnalyticsSQL에 대한 지원을 더 이상 사용할 수 없습니다. 자세한 내용은 Amazon Kinesis Data Analytics for SQL Applications 중단 단원을 참조하십시오.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
UpdateApplication
참고
이 설명서는 Amazon Kinesis Data Analytics API 버전 1용이며, SQL 애플리케이션만 지원합니다. API 버전 2에서 SQL 및 Java 애플리케이션을 지원합니다. 버전 2에 대한 자세한 설명은 Amazon Kinesis Data Analytics API V2 설명서를 참조하십시오.
기존 Amazon Kinesis Analytics 애플리케이션을 업데이트합니다. 이 API를 사용하여 애플리케이션 코드, 입력 구성 및 출력 구성을 업데이트할 수 있습니다.
Amazon Kinesis Analytics는 애플리케이션을 업데이트할 때마다 CurrentApplicationVersionId
을 업데이트 한다는 것을 유의하십시오.
이 작업에는 kinesisanalytics:UpdateApplication
작업 권한이 필요합니다.
구문 요청
{
"ApplicationName": "string
",
"ApplicationUpdate": {
"ApplicationCodeUpdate": "string
",
"CloudWatchLoggingOptionUpdates": [
{
"CloudWatchLoggingOptionId": "string
",
"LogStreamARNUpdate": "string
",
"RoleARNUpdate": "string
"
}
],
"InputUpdates": [
{
"InputId": "string
",
"InputParallelismUpdate": {
"CountUpdate": number
},
"InputProcessingConfigurationUpdate": {
"InputLambdaProcessorUpdate": {
"ResourceARNUpdate": "string
",
"RoleARNUpdate": "string
"
}
},
"InputSchemaUpdate": {
"RecordColumnUpdates": [
{
"Mapping": "string
",
"Name": "string
",
"SqlType": "string
"
}
],
"RecordEncodingUpdate": "string
",
"RecordFormatUpdate": {
"MappingParameters": {
"CSVMappingParameters": {
"RecordColumnDelimiter": "string
",
"RecordRowDelimiter": "string
"
},
"JSONMappingParameters": {
"RecordRowPath": "string
"
}
},
"RecordFormatType": "string
"
}
},
"KinesisFirehoseInputUpdate": {
"ResourceARNUpdate": "string
",
"RoleARNUpdate": "string
"
},
"KinesisStreamsInputUpdate": {
"ResourceARNUpdate": "string
",
"RoleARNUpdate": "string
"
},
"NamePrefixUpdate": "string
"
}
],
"OutputUpdates": [
{
"DestinationSchemaUpdate": {
"RecordFormatType": "string
"
},
"KinesisFirehoseOutputUpdate": {
"ResourceARNUpdate": "string
",
"RoleARNUpdate": "string
"
},
"KinesisStreamsOutputUpdate": {
"ResourceARNUpdate": "string
",
"RoleARNUpdate": "string
"
},
"LambdaOutputUpdate": {
"ResourceARNUpdate": "string
",
"RoleARNUpdate": "string
"
},
"NameUpdate": "string
",
"OutputId": "string
"
}
],
"ReferenceDataSourceUpdates": [
{
"ReferenceId": "string
",
"ReferenceSchemaUpdate": {
"RecordColumns": [
{
"Mapping": "string
",
"Name": "string
",
"SqlType": "string
"
}
],
"RecordEncoding": "string
",
"RecordFormat": {
"MappingParameters": {
"CSVMappingParameters": {
"RecordColumnDelimiter": "string
",
"RecordRowDelimiter": "string
"
},
"JSONMappingParameters": {
"RecordRowPath": "string
"
}
},
"RecordFormatType": "string
"
}
},
"S3ReferenceDataSourceUpdate": {
"BucketARNUpdate": "string
",
"FileKeyUpdate": "string
",
"ReferenceRoleARNUpdate": "string
"
},
"TableNameUpdate": "string
"
}
]
},
"CurrentApplicationVersionId": number
}
요청 파라미터
요청은 JSON 형식으로 다음 데이터를 받습니다.
- ApplicationName
-
업데이트할 Amazon Kinesis Analytics 애플리케이션의 명칭입니다.
유형: 문자열
길이 제약: 최소 길이는 1. 최대 길이 128.
패턴:
[a-zA-Z0-9_.-]+
필수 여부: 예
- ApplicationUpdate
-
애플리케이션 업데이트에 대해 설명합니다.
유형: ApplicationUpdate객체
필수 여부: 예
- CurrentApplicationVersionId
-
최신 애플리케이션 버전 ID. DescribeApplication작업을 사용하여 이 값을 가져올 수 있습니다.
타입: Long
유효 범위: 최소값 1. 최대값 999999999.
필수 여부: 예
Response Elements
작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 반송합니다.
Errors
- CodeValidationException
-
사용자가 제공한 애플리케이션 코드 (쿼리) 가 유효하지 않습니다. 이는 단순한 구문 오류일 수 있습니다.
HTTP 상태 코드: 400
- ConcurrentModificationException
-
애플리케이션을 동시에 수정한 결과 예외가 발생했습니다. 예컨대, 두 사람이 동시에 같은 애플리케이션을 편집하려고 하는 경우를 예로 들 수 있습니다.
HTTP 상태 코드: 400
- InvalidArgumentException
-
지정한 입력 파라미터 값이 유효하지 않습니다.
HTTP 상태 코드: 400
- ResourceInUseException
-
이 작업을 위한 애플리케이션을 얻을 수 없습니다.
HTTP 상태 코드: 400
- ResourceNotFoundException
-
지정된 애플리케이션을 찾을 수 없습니다.
HTTP 상태 코드: 400
- UnsupportedOperationException
-
지정된 파라미터가 지원되지 않거나 지정된 리소스가 이 작업에 유효하지 않아 요청이 거부되었습니다.
HTTP 상태 코드: 400
참고
언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.