AddApplicationReferenceDataSource - 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 應用程式終止

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

AddApplicationReferenceDataSource

注意

此文件適用於 Amazon Kinesis Data Analytics API 第 1 版,僅支援 SQL 應用程式。第 2 版的 API 則支援 SQL 和 Java 應用程式。如需第 2 版的詳細資訊,請參閱 Amazon Kinesis Data Analytics API V2 文件

將參考資料來源新增到現有應用程式。

Amazon Kinesis Analytics 會讀取參考資料 (即 Amazon S3 物件),並在您的應用程式內建立應用程式內資料表。在請求中,您可以提供來源 (S3 儲存貯體名稱和物件鍵名稱)、要建立的應用程式內資料表名稱,以及描述 Amazon S3 物件中的資料如何映射到結果應用程式內資料表中資料行的必要映射資訊。

如需概念資訊,請參閱設定應用程式輸入。如需了解您可以新增到您應用程式的資料來源限制,請參閱限制

這項操作需要許可來執行 kinesisanalytics:AddApplicationOutput 動作。

請求語法

{ "ApplicationName": "string", "CurrentApplicationVersionId": number, "ReferenceDataSource": { "ReferenceSchema": { "RecordColumns": [ { "Mapping": "string", "Name": "string", "SqlType": "string" } ], "RecordEncoding": "string", "RecordFormat": { "MappingParameters": { "CSVMappingParameters": { "RecordColumnDelimiter": "string", "RecordRowDelimiter": "string" }, "JSONMappingParameters": { "RecordRowPath": "string" } }, "RecordFormatType": "string" } }, "S3ReferenceDataSource": { "BucketARN": "string", "FileKey": "string", "ReferenceRoleARN": "string" }, "TableName": "string" } }

請求參數

請求接受採用 JSON 格式的下列資料。

ApplicationName

現有應用程式的名稱。

類型:字串

長度限制:長度下限為 1。長度上限為 128。

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

必要:是

CurrentApplicationVersionId

您要為其新增參考資料來源的應用程式版本。您可以使用該DescribeApplication操作來獲取當前應用程序版本。如果指定的版本不是目前版本,則會傳回 ConcurrentModificationException

類型:Long

有效範圍:最小值為 1。最大值為 999999999。

必要:是

ReferenceDataSource

參考資料來源可以是您 Amazon S3 儲存貯體中的物件。Amazon Kinesis Analytics 會讀取物件,並將資料複製到所建立的應用程式內資料表。您可以提供 S3 儲存貯體、物件鍵名稱,以及所建立的結果應用程式內資料表。您也必須提供具備必要許可的 IAM 角色,讓 Amazon Kinesis Analytics 能取得該角色來代您從 S3 儲存貯體讀取物件。

類型:ReferenceDataSource 物件

必要:是

回應元素

如果動作成功,則服務會傳回具空 HTTP 內文的 HTTP 200 回應。

錯誤

ConcurrentModificationException

並行修改應用程式的結果拋出例外。例如,有兩個人嘗試同時編輯相同的應用程式。

HTTP 狀態碼:400

InvalidArgumentException

指定的輸入參數值無效。

HTTP 狀態碼:400

ResourceInUseException

應用程式不適用於此作業。

HTTP 狀態碼:400

ResourceNotFoundException

找不到指定的應用程式。

HTTP 狀態碼:400

UnsupportedOperationException

請求被拒絕,因為指定的參數不受支持,或指定的資源對此操作無效。

HTTP 狀態碼:400

另請參閱

如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊,請參閱下列內容: