Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

Déduit un schéma pour une application Kinesis Data Analytics basée sur SQL en évaluant des exemples d'enregistrements sur la source de streaming spécifiée (flux de données Kinesis ou flux de diffusion Kinesis Data Firehose) ou sur l'objet Amazon S3. Dans la réponse, l’opération renvoie le schéma déduit ainsi que les exemples d’enregistrements utilisés par l’opération pour déduire le schéma.

 Vous pouvez utiliser le schéma déduit lors de la configuration d’une source de streaming pour votre application. Lorsque vous créez une application à l'aide de la console Kinesis Data Analytics, celle-ci utilise cette opération pour déduire un schéma et l'afficher dans l'interface utilisateur de la console. 

## Syntaxe de la requête
<a name="API_DiscoverInputSchema_RequestSyntax"></a>

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

## Paramètres de demande
<a name="API_DiscoverInputSchema_RequestParameters"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [InputProcessingConfiguration](#API_DiscoverInputSchema_RequestSyntax) **   <a name="APIReference-DiscoverInputSchema-request-InputProcessingConfiguration"></a>
[InputProcessingConfiguration](API_InputProcessingConfiguration.md)À utiliser pour prétraiter les enregistrements avant de découvrir le schéma des enregistrements.  
Type : objet [InputProcessingConfiguration](API_InputProcessingConfiguration.md)  
Obligatoire : non

 ** [InputStartingPositionConfiguration](#API_DiscoverInputSchema_RequestSyntax) **   <a name="APIReference-DiscoverInputSchema-request-InputStartingPositionConfiguration"></a>
Point auquel vous souhaitez que Kinesis Data Analytics commence à lire les enregistrements provenant de la source de streaming spécifiée à des fins de découverte.  
Type : objet [InputStartingPositionConfiguration](API_InputStartingPositionConfiguration.md)  
Obligatoire : non

 ** [ResourceARN](#API_DiscoverInputSchema_RequestSyntax) **   <a name="APIReference-DiscoverInputSchema-request-ResourceARN"></a>
Le nom de ressource Amazon (ARN) de la source de streaming.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.  
Modèle : `arn:.*`   
Obligatoire : non

 ** [S3Configuration](#API_DiscoverInputSchema_RequestSyntax) **   <a name="APIReference-DiscoverInputSchema-request-S3Configuration"></a>
Spécifiez ce paramètre pour découvrir un schéma à partir des données d’un objet Amazon S3.  
Type : objet [S3Configuration](API_S3Configuration.md)  
Obligatoire : non

 ** [ServiceExecutionRole](#API_DiscoverInputSchema_RequestSyntax) **   <a name="APIReference-DiscoverInputSchema-request-ServiceExecutionRole"></a>
L'ARN du rôle utilisé pour accéder à la source de streaming.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.  
Modèle : `arn:.*`   
Obligatoire : oui

## Syntaxe de la réponse
<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" ]
}
```

## Eléments de réponse
<a name="API_DiscoverInputSchema_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [InputSchema](#API_DiscoverInputSchema_ResponseSyntax) **   <a name="APIReference-DiscoverInputSchema-response-InputSchema"></a>
Le schéma déduit de la source de diffusion. Il identifie le format des données de la source de streaming et la façon dont chaque élément de données est mappé aux colonnes correspondantes que vous pouvez créer dans le flux intégré à l’application.  
Type : objet [SourceSchema](API_SourceSchema.md)

 ** [ParsedInputRecords](#API_DiscoverInputSchema_ResponseSyntax) **   <a name="APIReference-DiscoverInputSchema-response-ParsedInputRecords"></a>
Tableau d’éléments, où chaque élément correspond à une ligne d’un enregistrement de flux (un enregistrement de flux peut comporter plusieurs lignes).  
Type : Tableau de tableaux de chaînes

 ** [ProcessedInputRecords](#API_DiscoverInputSchema_ResponseSyntax) **   <a name="APIReference-DiscoverInputSchema-response-ProcessedInputRecords"></a>
Les données de flux modifiées par le processeur spécifié dans le `InputProcessingConfiguration` paramètre.  
Type : tableau de chaînes

 ** [RawInputRecords](#API_DiscoverInputSchema_ResponseSyntax) **   <a name="APIReference-DiscoverInputSchema-response-RawInputRecords"></a>
Les données de flux brutes qui ont été échantillonnées pour déduire le schéma.  
Type : tableau de chaînes

## Erreurs
<a name="API_DiscoverInputSchema_Errors"></a>

 ** InvalidArgumentException **   
La valeur du paramètre d'entrée spécifiée n'est pas valide.  
Code d’état HTTP : 400

 ** InvalidRequestException **   
Le JSON de la requête n'est pas valide pour l'opération.  
Code d’état HTTP : 400

 ** ResourceProvisionedThroughputExceededException **   
Discovery n'a pas réussi à obtenir d'enregistrement depuis la source de streaming à cause des Kinesis Streams. `ProvisionedThroughputExceededException` Pour plus d'informations, consultez [GetRecords](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_GetRecords.html)le manuel Amazon Kinesis Streams API Reference.  
Code d’état HTTP : 400

 ** ServiceUnavailableException **   
Le service ne peut pas traiter la demande.  
Code d’état HTTP : 500

 ** UnableToDetectSchemaException **   
Le format des données n'est pas valide. Kinesis Data Analytics ne peut pas détecter le schéma de la source de streaming donnée.    
 ** ProcessedInputRecords **   
Données de flux modifiées par le processeur spécifié dans le paramètre `InputProcessingConfiguration`.   
 ** RawInputRecords **   
Données de flux brutes qui ont été échantillonnées pour déduire le schéma.
Code d’état HTTP : 400

 ** UnsupportedOperationException **   
La requête a été rejetée car un paramètre spécifié n’est pas pris en charge ou parce qu’une ressource spécifiée n’est pas valide pour cette opération.   
Code d’état HTTP : 400

## Voir aussi
<a name="API_DiscoverInputSchema_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema)