对于新项目,建议您使用新的适用于 Apache Flink Studio 的托管服务,而不是使用适用于 SQL 应用程序的 Kinesis Data Analytics。Managed Service for Apache Flink Studio 不仅操作简单,还具有高级分析功能,使您能够在几分钟内构建复杂的流处理应用程序。
本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
AddApplicationInput
注意
本文档适用于 Amazon Kinesis Data Analytics API 版本 1,该版本仅支持 SQL 应用程序。版本 2 的 API 支持 SQL 和 Java 应用程序。有关版本 2 的更多信息,请参阅 Amazon Kinesis Data Analytics API V2 文档。
向您的 Amazon Kinesis 应用程序添加流式传输源。有关概念信息,请参阅配置应用程序输入。
可以在创建应用程序时添加流式传输源,也可以在创建应用程序后使用此操作添加流式传输源。有关更多信息,请参阅 CreateApplication。
任何配置更新(包括使用此操作添加流式传输源)都会生成新版本的应用程序。您可以使用 DescribeApplication 操作来找到当前应用程序版本。
此操作需要执行 kinesisanalytics:AddApplicationInput
操作的权限。
请求语法
{
"ApplicationName": "string
",
"CurrentApplicationVersionId": number
,
"Input": {
"InputParallelism": {
"Count": number
},
"InputProcessingConfiguration": {
"InputLambdaProcessor": {
"ResourceARN": "string
",
"RoleARN": "string
"
}
},
"InputSchema": {
"RecordColumns": [
{
"Mapping": "string
",
"Name": "string
",
"SqlType": "string
"
}
],
"RecordEncoding": "string
",
"RecordFormat": {
"MappingParameters": {
"CSVMappingParameters": {
"RecordColumnDelimiter": "string
",
"RecordRowDelimiter": "string
"
},
"JSONMappingParameters": {
"RecordRowPath": "string
"
}
},
"RecordFormatType": "string
"
}
},
"KinesisFirehoseInput": {
"ResourceARN": "string
",
"RoleARN": "string
"
},
"KinesisStreamsInput": {
"ResourceARN": "string
",
"RoleARN": "string
"
},
"NamePrefix": "string
"
}
}
请求参数
请求接受采用 JSON 格式的以下数据。
- ApplicationName
-
您要向其添加流式传输源的现有 Amazon Kinesis Analytics 应用程序的名称。
类型:字符串
长度限制:长度下限为 1。长度上限为 128。
模式:
[a-zA-Z0-9_.-]+
必需:是
- CurrentApplicationVersionId
-
您的 Amazon Kinesis Analytics 应用程序的当前版本。您可以使用 DescribeApplication 操作来找到当前应用程序版本。
类型:长整型
有效范围:最小值为 1。最大值为 999999999。
必需:是
- Input
-
要添加的输入。
类型:Input 对象
必需:是
响应元素
如果此操作成功,则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。
错误
- CodeValidationException
-
用户提供的应用程序代码(查询)无效。这可能是一个简单的语法错误。
HTTP 状态代码:400
- ConcurrentModificationException
-
由于对应用程序进行并发修改而引发的异常。例如,两个人尝试同时编辑同一个应用程序。
HTTP 状态代码:400
- InvalidArgumentException
-
指定的输入参数值无效。
HTTP 状态代码:400
- ResourceInUseException
-
该应用程序不可用于此操作。
HTTP 状态代码:400
- ResourceNotFoundException
-
无法找到指定的应用程序。
HTTP 状态代码:400
- UnsupportedOperationException
-
请求被拒绝,因为不支持指定的参数或指定的资源对此操作无效。
HTTP 状态代码:400
另请参阅
有关在特定语言的 Amazon SDK 中使用此 API 的更多信息,请参阅以下内容: