Après mûre réflexion, nous avons décidé de mettre fin à Amazon Kinesis Data Analytics pour les applications SQL : 1. À compter du **1er septembre 2025,** nous ne fournirons aucune correction de bogue pour les applications Amazon Kinesis Data Analytics for SQL, car leur support sera limité, compte tenu de l'arrêt prochain. 2. À compter du **15 octobre 2025,** vous ne pourrez plus créer de nouvelles applications Kinesis Data Analytics for SQL. 3. Nous supprimerons vos candidatures à compter **du 27 janvier 2026**. Vous ne serez pas en mesure de démarrer ou d'utiliser vos applications Amazon Kinesis Data Analytics for SQL. Support ne sera plus disponible pour Amazon Kinesis Data Analytics for SQL à partir de cette date. Pour de plus amples informations, veuillez consulter [Arrêt d'Amazon Kinesis Data Analytics pour les applications SQL](discontinuation.md). 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. # AddApplicationReferenceDataSource **Note** Cette documentation est destinée à la version 1 de l’API Amazon Kinesis Data Analytics, qui est compatible uniquement avec les applications SQL. La version 2 de l’API est compatible avec les applications SQL et Java. Pour plus d’informations sur la version 2, consultez la [documentation de l’API Amazon Kinesis Data Analytics V2](/kinesisanalytics/latest/apiv2/Welcome.html). Ajoute une source de données de référence à une application existante. Amazon Kinesis Analytics lit les données de référence (un objet Amazon S3) et crée une table intégrée à l'application dans votre application. Dans la demande, vous fournissez la source (le nom du compartiment S3 et le nom de la clé d'objet), le nom de la table intégrée à l'application à créer et les informations de mappage nécessaires qui décrivent la façon dont les données d'objet Amazon S3 sont mappées aux colonnes de la table obtenue intégrée à l'application. Pour obtenir des informations conceptuelles, veuillez consulter [Configuration de l'entrée de l'application](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-input.html). Pour connaître les restrictions sur les sources de données que vous pouvez configurer, veuillez consulter [Restrictions](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/limits.html). Cette opération exige des autorisations pour exécuter l'action `kinesisanalytics:AddApplicationOutput`. ## Syntaxe de la requête ``` { "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" } } ``` ## Paramètres de demande Cette demande accepte les données suivantes au format JSON. ** [ApplicationName](#API_AddApplicationReferenceDataSource_RequestSyntax) ** Nom d'une application existante. Type : Chaîne Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 128. Modèle : `[a-zA-Z0-9_.-]+` Obligatoire : oui ** [CurrentApplicationVersionId](#API_AddApplicationReferenceDataSource_RequestSyntax) ** Version de l’application pour laquelle vous ajoutez la source de données de référence. Vous pouvez utiliser cette [DescribeApplication](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_DescribeApplication.html)opération pour obtenir la version actuelle de l'application. Si la version spécifiée n’est pas la version actuelle, `ConcurrentModificationException` est renvoyé. Type : Long Plage valide : valeur minimum de 1. Valeur maximale de 999999999. Obligatoire : oui ** [ReferenceDataSource](#API_AddApplicationReferenceDataSource_RequestSyntax) ** Source des données de référence pouvant être un objet dans votre compartiment Amazon S3. Amazon Kinesis Analytics lit l'objet et copie les données dans la table intégrée à l'application qui est créée. Vous fournissez un compartiment S3, une clé d'objet et le nom de la table obtenue intégrée à l'application qui est créée. Vous devez également fournir un rôle IAM disposant des autorisations requises qu'Amazon Kinesis Analytics peut endosser pour lire l'objet de votre compartiment S3 en votre nom. Type : objet [ReferenceDataSource](API_ReferenceDataSource.md) Obligatoire : oui ## Éléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide. ## Erreurs ** ConcurrentModificationException ** Exception envoyée suite à la modification simultanée d’une application. Par exemple, deux personnes tentent de modifier la même application en même temps. ** message ** Code d’état HTTP : 400 ** InvalidArgumentException ** La valeur du paramètre d’entrée spécifiée n’est pas valide. ** message ** Code d’état HTTP : 400 ** ResourceInUseException ** L’application n’est pas disponible pour cette opération. ** message ** Code d’état HTTP : 400 ** ResourceNotFoundException ** L’application spécifiée est introuvable. ** message ** 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 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/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalytics-2015-08-14/AddApplicationReferenceDataSource)