在仔細考慮之後,我們決定在兩個步驟中停止 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 的詳細資訊,請參閱下列內容: