慎重に検討した結果、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)」を参照してください。 翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # DiscoverInputSchema **注記** このドキュメントの対象は、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 ストリームまたは Amazon Kinesis Firehose 配信ストリーム) または S3 オブジェクトのサンプルレコードを評価することによって、スキーマを推測します。レスポンスでは、推測されたスキーマと、オペレーションでスキーマを推測するために使用されたサンプルレコードも返されます。 推測されたスキーマは、アプリケーションのストリーミングソースを設定するときに使用できます。概念については、「[アプリケーション入力の設定](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-input.html)」を参照してください。Amazon Kinesis Analytics コンソールを使用してアプリケーションを作成する場合、コンソールはこのオペレーションを使用してスキーマを推測し、コンソールのユーザーインターフェイスに表示します。 このオペレーションには `kinesisanalytics:DiscoverInputSchema` アクションを実行するアクセス許可が必要です。 ## リクエストの構文 ``` { "InputProcessingConfiguration": { "InputLambdaProcessor": { "ResourceARN": "string", "RoleARN": "string" } }, "InputStartingPositionConfiguration": { "InputStartingPosition": "string" }, "ResourceARN": "string", "RoleARN": "string", "S3Configuration": { "BucketARN": "string", "FileKey": "string", "RoleARN": "string" } } ``` ## リクエストパラメーター リクエストは以下のデータを JSON 形式で受け入れます。 ** [InputProcessingConfiguration](#API_DiscoverInputSchema_RequestSyntax) ** レコードのスキーマを検出する前に、[InputProcessingConfiguration](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_InputProcessingConfiguration.html) を使用してレコードを前処理します。 型: [InputProcessingConfiguration](API_InputProcessingConfiguration.md) オブジェクト 必須: いいえ ** [InputStartingPositionConfiguration](#API_DiscoverInputSchema_RequestSyntax) ** Amazon Kinesis Analytics で、指定したストリーミングソースから検出の目的でレコードの読み取りを開始するポイント。 型: [InputStartingPositionConfiguration](API_InputStartingPositionConfiguration.md) オブジェクト 必須: いいえ ** [ResourceARN](#API_DiscoverInputSchema_RequestSyntax) ** ストリーミングソースの Amazon リソースネーム (ARN)。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 2,048 です。 パターン: `arn:.*` 必須: いいえ ** [RoleARN](#API_DiscoverInputSchema_RequestSyntax) ** Amazon Kinesis Analytics がユーザーに代わってストリームにアクセスするために引き受けることができる IAM ロールの ARN。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 2,048 です。 パターン: `arn:.*` 必須: いいえ ** [S3Configuration](#API_DiscoverInputSchema_RequestSyntax) ** Amazon S3 オブジェクトのデータからスキーマを検出するには、このパラメータを指定します。 型: [S3Configuration](API_S3Configuration.md) オブジェクト 必須: いいえ ## レスポンスの構文 ``` { "InputSchema": { "RecordColumns": [ { "Mapping": "string", "Name": "string", "SqlType": "string" } ], "RecordEncoding": "string", "RecordFormat": { "MappingParameters": { "CSVMappingParameters": { "RecordColumnDelimiter": "string", "RecordRowDelimiter": "string" }, "JSONMappingParameters": { "RecordRowPath": "string" } }, "RecordFormatType": "string" } }, "ParsedInputRecords": [ [ "string" ] ], "ProcessedInputRecords": [ "string" ], "RawInputRecords": [ "string" ] } ``` ## レスポンス要素 アクションが成功すると、サービスは HTTP 200 レスポンスを返します。 サービスから以下のデータが JSON 形式で返されます。 ** [InputSchema](#API_DiscoverInputSchema_ResponseSyntax) ** ストリーミングソースから推測されたスキーマ。ストリーミングソース内のデータ形式、アプリケーション内ストリームで作成可能な対応カラムに対して各データ要素をマッピングする方法を定義します。 型: [SourceSchema](API_SourceSchema.md) オブジェクト ** [ParsedInputRecords](#API_DiscoverInputSchema_ResponseSyntax) ** 要素の配列。各要素はストリームレコード内の行に対応します (ストリームレコードは複数の行を持つことができます)。 型: 文字列の配列の配列 ** [ProcessedInputRecords](#API_DiscoverInputSchema_ResponseSyntax) ** `InputProcessingConfiguration` パラメータで指定されたプロセッサによって変更されたストリームデータ。 型: 文字列の配列 ** [RawInputRecords](#API_DiscoverInputSchema_ResponseSyntax) ** スキーマを推測するためにサンプリングされた生のストリームデータ。 型: 文字列の配列 ## エラー ** InvalidArgumentException ** 指定された入力パラメータ値が無効です。 ** message ** HTTP ステータスコード: 400 ** ResourceProvisionedThroughputExceededException ** Amazon Kinesis Streams ProvisionedThroughputExceededException が原因で、検出においてストリーミングソースからレコードを取得できませんでした。詳細については、Amazon Kinesis Streams API リファレンスの [GetRecords](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_GetRecords.html) を参照してください。 HTTP ステータスコード: 400 ** ServiceUnavailableException ** サービスは利用できません。戻ってオペレーションを再試行してください。 HTTP ステータスコード: 500 ** UnableToDetectSchemaException ** 日付形式が有効ではありません。Amazon Kinesis Analytics は、指定されたストリーミングソースのスキーマを検出できません。 HTTP ステータスコード: 400 ** UnsupportedOperationException ** 指定されたパラメータがサポートされていないか、指定されたリソースがこのオペレーションに対して有効でないため、リクエストは拒否されました。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。 言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/DiscoverInputSchema) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/DiscoverInputSchema) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/DiscoverInputSchema) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/DiscoverInputSchema) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/DiscoverInputSchema) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/DiscoverInputSchema) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/DiscoverInputSchema) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/DiscoverInputSchema) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/DiscoverInputSchema) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/DiscoverInputSchema)