Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

Infiere un esquema para una aplicación de Kinesis Data Analytics basada en SQL mediante la evaluación de registros de muestra en la fuente de streaming especificada (transmisión de datos de Kinesis o transmisión de entrega de Kinesis Data Firehose) o en el objeto de Amazon S3. En la respuesta, la operación devuelve el esquema inferido y también los registros de muestra que la operación utilizó para deducir el esquema.

 Puede usar el esquema inferido al configurar un origen de flujo para su aplicación. Al crear una aplicación mediante la consola de Kinesis Data Analytics, la consola utiliza esta operación para deducir un esquema y mostrarlo en la interfaz de usuario de la consola. 

## Sintaxis de la solicitud
<a name="API_DiscoverInputSchema_RequestSyntax"></a>

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

## Parámetros de la solicitud
<a name="API_DiscoverInputSchema_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [InputProcessingConfiguration](#API_DiscoverInputSchema_RequestSyntax) **   <a name="APIReference-DiscoverInputSchema-request-InputProcessingConfiguration"></a>
Utilice [InputProcessingConfiguration](API_InputProcessingConfiguration.md) para preprocesar los registros antes de detectar el esquema de los registros.  
Tipo: objeto [InputProcessingConfiguration](API_InputProcessingConfiguration.md)  
Obligatorio: no

 ** [InputStartingPositionConfiguration](#API_DiscoverInputSchema_RequestSyntax) **   <a name="APIReference-DiscoverInputSchema-request-InputStartingPositionConfiguration"></a>
El punto en el que desea que Kinesis Data Analytics comience a leer los registros de la fuente de streaming especificada con fines de descubrimiento.  
Tipo: objeto [InputStartingPositionConfiguration](API_InputStartingPositionConfiguration.md)  
Obligatorio: no

 ** [ResourceARN](#API_DiscoverInputSchema_RequestSyntax) **   <a name="APIReference-DiscoverInputSchema-request-ResourceARN"></a>
El nombre de recurso de Amazon (ARN) del origen de transmisión.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Patrón: `arn:.*`   
Obligatorio: no

 ** [S3Configuration](#API_DiscoverInputSchema_RequestSyntax) **   <a name="APIReference-DiscoverInputSchema-request-S3Configuration"></a>
Especifique este parámetro para descubrir un esquema a partir de datos en un objeto de Amazon S3.  
Tipo: objeto [S3Configuration](API_S3Configuration.md)  
Obligatorio: no

 ** [ServiceExecutionRole](#API_DiscoverInputSchema_RequestSyntax) **   <a name="APIReference-DiscoverInputSchema-request-ServiceExecutionRole"></a>
El ARN del rol que concede acceso al origen de transmisión.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Patrón: `arn:.*`   
Obligatorio: sí

## Sintaxis de la respuesta
<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" ]
}
```

## Elementos de respuesta
<a name="API_DiscoverInputSchema_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [InputSchema](#API_DiscoverInputSchema_ResponseSyntax) **   <a name="APIReference-DiscoverInputSchema-response-InputSchema"></a>
El esquema deducido del origen de transmisión. Identifica el formato de los datos del origen de transmisión y cómo se asigna cada elemento de datos a las columnas correspondientes en el flujo dentro de la aplicación que puede crear.  
Tipo: objeto [SourceSchema](API_SourceSchema.md)

 ** [ParsedInputRecords](#API_DiscoverInputSchema_ResponseSyntax) **   <a name="APIReference-DiscoverInputSchema-response-ParsedInputRecords"></a>
Conjunto de elementos, donde cada elemento corresponde a una fila de un registro de flujo (un registro de flujo puede tener más de una fila).  
Tipo: matrices de cadenas

 ** [ProcessedInputRecords](#API_DiscoverInputSchema_ResponseSyntax) **   <a name="APIReference-DiscoverInputSchema-response-ProcessedInputRecords"></a>
El flujo de datos que el procesador especificado modificó en el parámetro `InputProcessingConfiguration`.  
Tipo: matriz de cadenas

 ** [RawInputRecords](#API_DiscoverInputSchema_ResponseSyntax) **   <a name="APIReference-DiscoverInputSchema-response-RawInputRecords"></a>
El flujo de datos sin procesar que se mostraron para deducir el esquema.  
Tipo: matriz de cadenas

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

 ** InvalidArgumentException **   
El valor del parámetro de entrada especificado no es válido.  
Código de estado HTTP: 400

 ** InvalidRequestException **   
El JSON de la solicitud no es válido para la operación.  
Código de estado HTTP: 400

 ** ResourceProvisionedThroughputExceededException **   
El servicio de detección no pudo obtener un registro del origen de transmisión debido a una `ProvisionedThroughputExceededException` de Kinesis Streams. Para obtener más información, consulte la referencia [GetRecords](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_GetRecords.html)de la API de Amazon Kinesis Streams.  
Código de estado HTTP: 400

 ** ServiceUnavailableException **   
El servicio no puede completar la solicitud.  
Código de estado HTTP: 500

 ** UnableToDetectSchemaException **   
El formato de los datos no es válido. Kinesis Data Analytics no puede detectar el esquema de la fuente de transmisión determinada.    
 ** ProcessedInputRecords **   
Transmita datos modificados por el procesador especificado en el parámetro `InputProcessingConfiguration`.   
 ** RawInputRecords **   
Datos de flujo sin procesar que se asignaron para deducir el esquema.
Código de estado HTTP: 400

 ** UnsupportedOperationException **   
La solicitud se rechazó porque no se admite un parámetro especificado o porque un recurso especificado no es válido para esta operación.   
Código de estado HTTP: 400

## Véase también
<a name="API_DiscoverInputSchema_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalyticsv2-2018-05-23/DiscoverInputSchema)