翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# DiscoverInputSchema
<a name="API_DiscoverInputSchema"></a>

指定されたストリーミングソース (Kinesis データストリームまたは Kinesis Data Firehose 配信ストリーム) または Amazon S3 オブジェクトのサンプルレコードを評価することで、SQL ベースの Kinesis Data Analytics アプリケーションのスキーマを推測します。レスポンスでは、推測されたスキーマと、オペレーションでスキーマを推測するために使用されたサンプルレコードも返されます。

 推測されたスキーマは、アプリケーションのストリーミングソースを設定するときに使用できます。Kinesis Data Analytics コンソールを使用してアプリケーションを作成する場合、コンソールはこのオペレーションを使用してスキーマを推測し、コンソールのユーザーインターフェイスに表示します。

## リクエストの構文
<a name="API_DiscoverInputSchema_RequestSyntax"></a>

```
{
   "InputProcessingConfiguration": { 
      "InputLambdaProcessor": { 
         "ResourceARN": "string"
      }
   },
   "InputStartingPositionConfiguration": { 
      "InputStartingPosition": "string"
   },
   "ResourceARN": "string",
   "S3Configuration": { 
      "BucketARN": "string",
      "FileKey": "string"
   },
   "ServiceExecutionRole": "string"
}
```

## リクエストパラメーター
<a name="API_DiscoverInputSchema_RequestParameters"></a>

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [InputProcessingConfiguration](#API_DiscoverInputSchema_RequestSyntax) **   <a name="APIReference-DiscoverInputSchema-request-InputProcessingConfiguration"></a>
レコードのスキーマを検出する前に、[InputProcessingConfiguration](API_InputProcessingConfiguration.md) を使用してレコードを前処理します。  
型: [InputProcessingConfiguration](API_InputProcessingConfiguration.md) オブジェクト  
必須: いいえ

 ** [InputStartingPositionConfiguration](#API_DiscoverInputSchema_RequestSyntax) **   <a name="APIReference-DiscoverInputSchema-request-InputStartingPositionConfiguration"></a>
Kinesis Data Analytics が検出目的で指定されたストリーミングソースからレコードの読み取りを開始するポイント。  
型: [InputStartingPositionConfiguration](API_InputStartingPositionConfiguration.md) オブジェクト  
必須: いいえ

 ** [ResourceARN](#API_DiscoverInputSchema_RequestSyntax) **   <a name="APIReference-DiscoverInputSchema-request-ResourceARN"></a>
ストリーミングソースの Amazon リソースネーム (ARN)。  
タイプ: 文字列  
長さの制約: 最小長は 1 です。最大長は 2,048 です。  
パターン: `arn:.*`   
必須: いいえ

 ** [S3Configuration](#API_DiscoverInputSchema_RequestSyntax) **   <a name="APIReference-DiscoverInputSchema-request-S3Configuration"></a>
Amazon S3 オブジェクトのデータからスキーマを検出するには、このパラメータを指定します。  
型: [S3Configuration](API_S3Configuration.md) オブジェクト  
必須: いいえ

 ** [ServiceExecutionRole](#API_DiscoverInputSchema_RequestSyntax) **   <a name="APIReference-DiscoverInputSchema-request-ServiceExecutionRole"></a>
ストリーミングソースへのアクセスに使用されるロールの ARN。  
タイプ: 文字列  
長さの制約: 最小長は 1 です。最大長は 2,048 です。  
パターン: `arn:.*`   
必須: はい

## レスポンスの構文
<a name="API_DiscoverInputSchema_ResponseSyntax"></a>

```
{
   "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" ]
}
```

## レスポンス要素
<a name="API_DiscoverInputSchema_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [InputSchema](#API_DiscoverInputSchema_ResponseSyntax) **   <a name="APIReference-DiscoverInputSchema-response-InputSchema"></a>
ストリーミングソースから推測されたスキーマ。ストリーミングソース内のデータ形式、アプリケーション内ストリームで作成可能な対応カラムに対して各データ要素をマッピングする方法を定義します。  
型: [SourceSchema](API_SourceSchema.md) オブジェクト

 ** [ParsedInputRecords](#API_DiscoverInputSchema_ResponseSyntax) **   <a name="APIReference-DiscoverInputSchema-response-ParsedInputRecords"></a>
要素の配列。各要素はストリームレコード内の行に対応します (ストリームレコードは複数の行を持つことができます)。  
型: 文字列の配列の配列

 ** [ProcessedInputRecords](#API_DiscoverInputSchema_ResponseSyntax) **   <a name="APIReference-DiscoverInputSchema-response-ProcessedInputRecords"></a>
`InputProcessingConfiguration` パラメータで指定されたプロセッサによって変更されたストリームデータ。  
型: 文字列の配列

 ** [RawInputRecords](#API_DiscoverInputSchema_ResponseSyntax) **   <a name="APIReference-DiscoverInputSchema-response-RawInputRecords"></a>
スキーマを推測するためにサンプリングされた生のストリームデータ。  
型: 文字列の配列

## エラー
<a name="API_DiscoverInputSchema_Errors"></a>

 ** InvalidArgumentException **   
指定された入力パラメータ値が無効です。  
HTTP ステータスコード: 400

 ** InvalidRequestException **   
要求された JSON はオペレーションに対して無効です。  
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 **   
データ形式が無効です。Kinesis Data Analytics は、指定されたストリーミングソースのスキーマを検出できません。    
 ** ProcessedInputRecords **   
`InputProcessingConfiguration` パラメータで指定されたプロセッサによって変更されたストリームデータ。  
 ** RawInputRecords **   
スキーマを推測するためにサンプリングされた生のストリームデータ。
HTTP ステータスコード: 400

 ** UnsupportedOperationException **   
指定されたパラメータがサポートされていないか、指定されたリソースがこのオペレーションに対して有効でないため、リクエストは拒否されました。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_DiscoverInputSchema_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema)