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
Ajoute une source de données de référence à une application SQL Kinesis Data Analytics existante.
Amazon Kinesis Data 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'un objet Amazon S3 sont mappées aux colonnes de la table obtenue intégrée à l'application.
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"
},
"TableName": "string"
}
}Paramètres de demande
Cette demande accepte les données suivantes au format JSON.
- ApplicationName
-
Le 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
-
Version de l'application pour laquelle vous ajoutez la source de données de référence. Vous pouvez utiliser cette DescribeApplication opération pour obtenir la version actuelle de l'application. Si la version spécifiée n’est pas la version actuelle,
ConcurrentModificationExceptionest renvoyé.Type : long
Plage valide : valeur minimum de 1. Valeur maximale de 999999999.
Obligatoire : oui
- ReferenceDataSource
-
Source des données de référence pouvant être un objet dans votre compartiment Amazon S3. Kinesis Data Analytics lit l'objet et copie les données dans le tableau intégré à l'application qui est créé. 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.
Type : objet ReferenceDataSource
Obligatoire : oui
Syntaxe de la réponse
{
"ApplicationARN": "string",
"ApplicationVersionId": number,
"ReferenceDataSourceDescriptions": [
{
"ReferenceId": "string",
"ReferenceSchema": {
"RecordColumns": [
{
"Mapping": "string",
"Name": "string",
"SqlType": "string"
}
],
"RecordEncoding": "string",
"RecordFormat": {
"MappingParameters": {
"CSVMappingParameters": {
"RecordColumnDelimiter": "string",
"RecordRowDelimiter": "string"
},
"JSONMappingParameters": {
"RecordRowPath": "string"
}
},
"RecordFormatType": "string"
}
},
"S3ReferenceDataSourceDescription": {
"BucketARN": "string",
"FileKey": "string",
"ReferenceRoleARN": "string"
},
"TableName": "string"
}
]
}Eléments de réponse
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.
- ApplicationARN
-
Amazon Resource Name (ARN) de l'application .
Type : chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.
Modèle :
arn:.* - ApplicationVersionId
-
L'ID de version de l'application mis à jour. Kinesis Data Analytics incrémente cet identifiant lors de la mise à jour de l'application.
Type : long
Plage valide : valeur minimum de 1. Valeur maximale de 999999999.
- ReferenceDataSourceDescriptions
-
Décrit les sources de données de référence configurées pour l’application.
Type : tableau d’objets ReferenceDataSourceDescription
Erreurs
- ConcurrentModificationException
-
Exception déclenchée à la suite de modifications simultanées apportées à une application. Cette erreur peut être le résultat d'une tentative de modification d'une application sans utiliser l'ID d'application actuel.
Code d’état HTTP : 400
- 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
- ResourceInUseException
-
L'application n'est pas disponible pour cette opération.
Code d’état HTTP : 400
- ResourceNotFoundException
-
L’application spécifiée est introuvable.
Code d’état HTTP : 400
consultez aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS SDK spécifiques au langage, consultez les pages suivantes :
