AddApplicationOutput - SQL适用于应用程序的 Amazon Kinesis Data Analytics 开发者指南

经过仔细考虑,我们决定分两个步骤停止使用亚马逊 Kinesis Data Analytics SQL 的应用程序:

1. 从 2025 年 10 月 15 日起,您将无法为应用程序创建新的 Kinesis Data Analytic SQL s。

2. 从 2026 年 1 月 27 日起,我们将删除您的应用程序。您将无法启动或操作适用于应用程序的 Amazon Kinesis Data Analytic SQL s。从那时起,亚马逊 Kinesis Data Analytics SQL 将不再提供支持。有关更多信息,请参阅 适用于应用程序的 Amazon Kinesis Data Analytic SQL s 停产

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

AddApplicationOutput

注意

本文档适用于 Amazon Kinesis Data Analytics API 版本 1,该版本仅支持 SQL 应用程序。版本 2 的 API 支持 SQL 和 Java 应用程序。有关版本 2 的更多信息,请参阅 Amazon Kinesis Data Analytics API V2 文档

将外部目标添加到您的 Amazon Kinesis Analytics 应用程序。

如果您希望 Amazon Kinesis Analytics 将数据从应用程序中的应用程序内部流传递到外部目标(例如 Amazon Kinesis 流、Amazon Kinesis Firehose 传输流或 AWS Lambda 函数),则可以使用此操作将相关配置添加到您的应用程序。您可以为您的应用程序配置一个或多个输出。每个输出配置都映射一个应用程序内部流和一个外部目标。

您可以使用其中一个输出配置将数据从应用程序内的错误流传输到外部目标,以便您分析错误。有关更多信息,请参阅了解应用程序输出(目标)

任何配置更新(包括使用此操作添加流式传输源)都会生成新版本的应用程序。您可以使用 DescribeApplication 操作来找到当前应用程序版本。

有关可配置的应用程序输入和输出数量的限制,请参阅限制

此操作需要执行 kinesisanalytics:AddApplicationOutput 操作的权限。

请求语法

{ "ApplicationName": "string", "CurrentApplicationVersionId": number, "Output": { "DestinationSchema": { "RecordFormatType": "string" }, "KinesisFirehoseOutput": { "ResourceARN": "string", "RoleARN": "string" }, "KinesisStreamsOutput": { "ResourceARN": "string", "RoleARN": "string" }, "LambdaOutput": { "ResourceARN": "string", "RoleARN": "string" }, "Name": "string" } }

请求参数

请求接受采用 JSON 格式的以下数据。

ApplicationName

要将输出配置添加到的应用程序的名称。

类型:字符串

长度限制:长度下限为 1。长度上限为 128。

模式:[a-zA-Z0-9_.-]+

必需:是

CurrentApplicationVersionId

要将输出配置添加到的应用程序的名称。您可以使用 DescribeApplication 操作来获得当前应用程序版本。如果指定的版本不是当前版本,则返回 ConcurrentModificationException

类型:长整型

有效范围:最小值为 1。最大值为 999999999。

必需:是

Output

对象的数组,每个对象描述一项输出配置。在输出配置中,指定应用程序内部流的名称、目标(即 Amazon Kinesis 流、Amazon Kinesis Firehose 传输流或 AWS Lambda 函数),并记录在写入该目标时要使用的格式。

类型:Output 对象

必需:是

响应元素

如果此操作成功,则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。

错误

ConcurrentModificationException

由于对应用程序进行并发修改而引发的异常。例如,两个人尝试同时编辑同一个应用程序。

HTTP 状态代码:400

InvalidArgumentException

指定的输入参数值无效。

HTTP 状态代码:400

ResourceInUseException

该应用程序不可用于此操作。

HTTP 状态代码:400

ResourceNotFoundException

无法找到指定的应用程序。

HTTP 状态代码:400

UnsupportedOperationException

由于不支持指定的参数或指定的资源对此操作无效,请求被拒绝。

HTTP 状态代码:400

另请参阅

有关在特定语言的 AWS SDK 中使用此 API 的更多信息,请参阅以下内容: