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. # AddApplicationReferenceDataSource **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). Añade un origen de datos de referencia a la aplicación existente. Amazon Kinesis Analytics lee los datos de referencia (es decir, un objeto de Amazon S3) y crea una tabla en la aplicación dentro de la aplicación. En la solicitud, debe proporcionar el origen (el nombre de la clave de objeto y el nombre del bucket de S3), el nombre de la tabla en la aplicación que se va a crear y la información de mapeo necesaria que describe cómo los datos en el objeto de Amazon S3 se correlacionan con las columnas de la tabla en la aplicación resultante. 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). Para conocer los límites respecto a los orígenes de datos que puede añadir a su aplicación, consulte [Límites](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/limits.html). Esto operación requiere permisos para realizar la acción `kinesisanalytics:AddApplicationOutput`. ## Sintaxis de la solicitud ``` { "ApplicationName": "string", "CurrentApplicationVersionId": number, "ReferenceDataSource": { "ReferenceSchema": { "RecordColumns": [ { "Mapping": "string", "Name": "string", "SqlType": "string" } ], "RecordEncoding": "string", "RecordFormat": { "MappingParameters": { "CSVMappingParameters": { "RecordColumnDelimiter": "string", "RecordRowDelimiter": "string" }, "JSONMappingParameters": { "RecordRowPath": "string" } }, "RecordFormatType": "string" } }, "S3ReferenceDataSource": { "BucketARN": "string", "FileKey": "string", "ReferenceRoleARN": "string" }, "TableName": "string" } } ``` ## Parámetros de la solicitud La solicitud acepta los siguientes datos en formato JSON. ** [ApplicationName](#API_AddApplicationReferenceDataSource_RequestSyntax) ** Nombre de una aplicación existente. Tipo: cadena Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128. Patrón: `[a-zA-Z0-9_.-]+` Obligatorio: sí ** [CurrentApplicationVersionId](#API_AddApplicationReferenceDataSource_RequestSyntax) ** Versión de la aplicación para la que va a añadir el origen de datos de referencia. Puede utilizar la operación [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html) para obtener la versión actual de la aplicación. Si la versión especificada no es la actual, se devuelve la `ConcurrentModificationException`. Tipo: largo Rango válido: valor mínimo de 1. Valor máximo de 999999999. Obligatorio: sí ** [ReferenceDataSource](#API_AddApplicationReferenceDataSource_RequestSyntax) ** El origen de datos de referencia puede ser un objeto en el bucket de Amazon S3. Amazon Kinesis Analytics lee el objeto y copia los datos en la tabla en la aplicación que se crea. Debe proporcionar el nombre de la clave de objeto, bucket de S3 y la tabla en la aplicación resultante que se crea. Asimismo, debe proporcionar un rol de IAM con los permisos necesarios que Amazon Kinesis Analytics puede adoptar para leer el objeto del bucket de S3 en su nombre. Tipo: objeto [ReferenceDataSource](API_ReferenceDataSource.md) Obligatorio: sí ## Elementos de respuesta Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío. ## Errores ** ConcurrentModificationException ** Se produce una excepción como resultado de una modificación simultánea de una aplicación. Por ejemplo, dos personas que intentan editar la misma aplicación al mismo tiempo. ** message ** Código de estado HTTP: 400 ** InvalidArgumentException ** El valor del parámetro de entrada especificado no es válido. ** message ** Código de estado HTTP: 400 ** ResourceInUseException ** La aplicación no está disponible para esta operación. ** message ** Código de estado HTTP: 400 ** ResourceNotFoundException ** No se encuentra la aplicación especificada. ** message ** 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 Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente: + [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource)