AddApplicationOutput - Amazon Kinesis Data Analytics for SQL Applications 開發人員指南

在仔細考慮之後,我們決定在兩個步驟中停止 Amazon Kinesis Data Analytics for SQL 應用程式:

1. 從 2025 年 10 月 15 日起,您將無法為SQL應用程式建立新的 Kinesis Data Analytics。

2. 我們將從 2026 年 1 月 27 日起刪除您的應用程式。您將無法啟動或操作SQL應用程式的 Amazon Kinesis Data Analytics。從那時SQL起,Amazon Kinesis Data Analytics 將不再提供 的支援。如需詳細資訊,請參閱Amazon Kinesis Data Analytics for SQL 應用程式終止

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

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

類型:Long

有效範圍:最小值為 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 的詳細資訊,請參閱下列內容: