Tras considerarlo detenidamente, hemos decidido dejar de utilizar Amazon Kinesis Data Analytics para aplicaciones SQL:

1. A partir del **1 de septiembre de 2025,** no proporcionaremos ninguna corrección de errores para las aplicaciones de Amazon Kinesis Data Analytics for SQL porque tendremos un soporte limitado debido a la próxima discontinuación.

2. A partir del **15 de octubre de 2025,** no podrá crear nuevas aplicaciones de Kinesis Data Analytics for SQL.

3. Eliminaremos sus aplicaciones a partir del **27 de enero de 2026**. No podrá iniciar ni utilizar sus aplicaciones de Amazon Kinesis Data Analytics para SQL. A partir de ese momento, el servicio de soporte de Amazon Kinesis Data Analytics para SQL dejará de estar disponible. Para obtener más información, consulte [Retirada de las aplicaciones de Amazon Kinesis Data Analytics para SQL](discontinuation.md).

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>

**nota**  
Esta documentación es para la versión 1 de la API de Amazon Kinesis Data Analytics, que solo admite aplicaciones SQL. La versión 2 de la API admite aplicaciones SQL y Java. Para obtener más información acerca de la versión 2, consulte la [documentación de la API V2 de Amazon Kinesis Data Analytics](/kinesisanalytics/latest/apiv2/Welcome.html).

Infiere un esquema mediante la evaluación de registros de muestra en el origen de flujo especificado (flujo de Amazon Kinesis o flujo de entrega de Amazon Kinesis Firehose) o en el objeto de S3 especificado. 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. Para obtener información conceptual, consulte [Configuración de entrada de la aplicación](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-input.html). Tenga en cuenta que cuando crea una aplicación mediante la consola de Amazon Kinesis Analytics, la consola utiliza esta operación para deducir un esquema y mostrarlo en la interfaz de usuario de la consola. 

 Esto operación requiere permisos para realizar la acción `kinesisanalytics:DiscoverInputSchema`. 

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

```
{
   "InputProcessingConfiguration": { 
      "InputLambdaProcessor": { 
         "ResourceARN": "string",
         "RoleARN": "string"
      }
   },
   "InputStartingPositionConfiguration": { 
      "InputStartingPosition": "string"
   },
   "ResourceARN": "string",
   "RoleARN": "string",
   "S3Configuration": { 
      "BucketARN": "string",
      "FileKey": "string",
      "RoleARN": "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="analytics-DiscoverInputSchema-request-InputProcessingConfiguration"></a>
Utilice [InputProcessingConfiguration](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_InputProcessingConfiguration.html) 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="analytics-DiscoverInputSchema-request-InputStartingPositionConfiguration"></a>
Punto en el que desea que Amazon Kinesis Analytics comience a leer los registros con los fines de descubrimiento de orígenes de flujo especificados.  
Tipo: objeto [InputStartingPositionConfiguration](API_InputStartingPositionConfiguration.md)  
Obligatorio: no

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

 ** [RoleARN](#API_DiscoverInputSchema_RequestSyntax) **   <a name="analytics-DiscoverInputSchema-request-RoleARN"></a>
El ARN del rol de IAM que Amazon Kinesis Analytics puede asumir para acceder al flujo en su nombre.  
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="analytics-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

## 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="analytics-DiscoverInputSchema-response-InputSchema"></a>
Esquema deducido del origen de streaming. Describe el formato de los datos del origen de streaming y cómo se asigna cada elemento de datos a las columnas correspondientes que se crean en la secuencia en la aplicación que puede crear.  
Tipo: objeto [SourceSchema](API_SourceSchema.md)

 ** [ParsedInputRecords](#API_DiscoverInputSchema_ResponseSyntax) **   <a name="analytics-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: Matriz de matrices de cadenas

 ** [ProcessedInputRecords](#API_DiscoverInputSchema_ResponseSyntax) **   <a name="analytics-DiscoverInputSchema-response-ProcessedInputRecords"></a>
Transmita datos modificados por el procesador especificado en el parámetro `InputProcessingConfiguration`.  
Tipo: matriz de cadenas

 ** [RawInputRecords](#API_DiscoverInputSchema_ResponseSyntax) **   <a name="analytics-DiscoverInputSchema-response-RawInputRecords"></a>
Datos de flujo sin procesar que se asignaron 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.    
 ** message **   

Código de estado HTTP: 400

 ** ResourceProvisionedThroughputExceededException **   
Discovery no pudo obtener un registro de la fuente de streaming debido a Amazon Kinesis ProvisionedThroughputExceededException 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 está disponible. Retroceda y vuelva a ejecutar la operación.   
Código de estado HTTP: 500

 ** UnableToDetectSchemaException **   
El formato de la fecha no es válido. Amazon Kinesis Analytics no puede detectar el esquema del origen de flujo determinado.  
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/kinesisanalytics-2015-08-14/DiscoverInputSchema) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/DiscoverInputSchema) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/DiscoverInputSchema) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/DiscoverInputSchema) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/DiscoverInputSchema) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/DiscoverInputSchema) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/DiscoverInputSchema) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/DiscoverInputSchema) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/DiscoverInputSchema) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/DiscoverInputSchema)