慎重に検討した結果、Amazon Kinesis Data Analytics for SQL アプリケーションを中止することにしました。 1. **2025 年 9 月 1** 日以降、Amazon Kinesis Data Analytics for SQL アプリケーションのバグ修正は提供されません。これは、今後の廃止によりサポートが制限されるためです。 2. **2025 年 10 月 15** 日以降、新しい Kinesis Data Analytics for SQL アプリケーションを作成することはできません。 3. **2026 年 1 月 27 日**以降、アプリケーションは削除されます。Amazon Kinesis Data Analytics for SQL アプリケーションを起動することも操作することもできなくなります。これ以降、Amazon Kinesis Data Analytics for SQL のサポートは終了します。詳細については、「[Amazon Kinesis Data Analytics for SQL アプリケーションのサポート終了](discontinuation.md)」を参照してください。 翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # AddApplicationReferenceDataSource **注記** このドキュメントの対象は、SQL アプリケーションのみがサポートされる Amazon Kinesis Data Analytics API のバージョン 1 です。バージョン 2 の API では、SQL および Java アプリケーションがサポートされます。バージョン 2 の詳細については、[Amazon Kinesis Data Analytics API V2 のドキュメント](/kinesisanalytics/latest/apiv2/Welcome.html)を参照してください。 既存のアプリケーションにリファレンスデータソースを追加します。 Amazon Kinesis Analytics は、リファレンスデータ (つまり、Amazon S3 オブジェクト) を読み取り、アプリケーション内にアプリケーション内テーブルを作成します。リクエストでは、ソース (S3 バケット名とオブジェクトのキー名)、作成するアプリケーション内テーブルの名前、および Amazon S3 オブジェクトのデータが結果のアプリケーション内テーブルの列にマッピングされる方法を説明する必要なマッピング情報を入力します。 概念については、「[アプリケーション入力の設定](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-input.html)」を参照してください。アプリケーションに追加できるデータソースの制限については、「[制限](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/limits.html)」を参照してください。 このオペレーションには `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](#API_AddApplicationReferenceDataSource_RequestSyntax) ** 既存のアプリケーションの名前。 タイプ: 文字列 長さの制限: 最小長は 1 です。最大長は 128 です。 パターン: `[a-zA-Z0-9_.-]+` 必須: はい ** [CurrentApplicationVersionId](#API_AddApplicationReferenceDataSource_RequestSyntax) ** 参照データソースを追加するアプリケーションのバージョン。[DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) オペレーションを使用して、アプリケーションの現在のバージョンを見つけることができます。指定したバージョンが現在のバージョンでない場合は、`ConcurrentModificationException` が返されます。 タイプ: Long 有効範囲: 最小値は 1 です。最大値は 999999999 です。 必須: はい ** [ReferenceDataSource](#API_AddApplicationReferenceDataSource_RequestSyntax) ** リファレンスデータソースは、Amazon S3 バケット内のオブジェクトにすることができます。Amazon Kinesis Analytics は、オブジェクトを読み取り、作成されているアプリケーション内テーブルにデータをコピーします。S3 バケット、オブジェクトのキー名、および作成されているアプリケーション内テーブルを指定します。また、ユーザーに代わって Amazon Kinesis Analytics が S3 バケットからのオブジェクトの読み取りを引き受けることができる必要なアクセス許可を持つ IAM ロールも指定する必要があります。 型: [ReferenceDataSource](API_ReferenceDataSource.md) オブジェクト 必須: はい ## レスポンス要素 アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラー ** ConcurrentModificationException ** アプリケーションへの同時変更の結果としてスローされる例外。例えば、2 人の個人が同じアプリケーションを同時に編集しようとしています。 ** message ** HTTP ステータスコード: 400 ** InvalidArgumentException ** 指定された入力パラメータ値が無効です。 ** message ** HTTP ステータスコード: 400 ** ResourceInUseException ** このオペレーションではアプリケーションを使用できません。 ** message ** HTTP ステータスコード: 400 ** ResourceNotFoundException ** 指定されたアプリケーションが見つかりません。 ** message ** HTTP ステータスコード: 400 ** UnsupportedOperationException ** 指定されたパラメータがサポートされていないか、指定されたリソースがこのオペレーションに対して有効でないため、リクエストは拒否されました。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。 言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource)