Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
AddApplicationReferenceDataSource
Aggiunge un'origine dati di riferimento a un'applicazione Kinesis Data Analytics esistente basata su SQL.
Kinesis Data Analytics legge i dati di riferimento (ossia, un oggetto Amazon S3) e crea una tabella all'interno dell'applicazione. Nella richiesta, puoi fornire l'origine (nome del bucket S3 e nome della chiave dell'oggetto), il nome della tabella nell'applicazione da creare e le informazioni di mappatura necessarie che descrivono il modo in cui i dati in un oggetto Amazon S3 vengono mappati alle colonne nella tabella nell'applicazione risultante.
Sintassi della richiesta
{
"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"
}
}Parametri della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- ApplicationName
-
Nome di un'applicazione esistente.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello:
[a-zA-Z0-9_.-]+Campo obbligatorio: sì
- CurrentApplicationVersionId
-
La versione dell'applicazione per la quale state aggiungendo l'origine dati di riferimento. È possibile utilizzare l'DescribeApplicationoperazione per ottenere la versione corrente dell'applicazione. Se la versione specificata non è la versione corrente, viene restituito
ConcurrentModificationException.Tipo: long
Intervallo valido: valore minimo di 1. Valore massimo di 999.999.999.
Campo obbligatorio: sì
- ReferenceDataSource
-
L'origine dati di riferimento può essere un oggetto nel bucket Amazon S3. Kinesis Data Analytics legge l'oggetto e copia i dati nella tabella all'interno dell'applicazione che viene creata. Puoi fornire un bucket S3, il nome della chiave dell'oggetto e la tabella nell'applicazione risultante che viene creata.
Tipo: oggetto ReferenceDataSource
Campo obbligatorio: sì
Sintassi della risposta
{
"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"
}
]
}Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- ApplicationARN
-
L'applicazione Amazon Resource Name (ARN).
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.
Modello:
arn:.* - ApplicationVersionId
-
L'ID della versione aggiornata dell'applicazione. Kinesis Data Analytics incrementa questo ID quando l'applicazione viene aggiornata.
Tipo: long
Intervallo valido: valore minimo di 1. Valore massimo di 999.999.999.
- ReferenceDataSourceDescriptions
-
Descrive le origini dati di riferimento configurate per l'applicazione.
Tipo: matrice di oggetti ReferenceDataSourceDescription
Errori
- ConcurrentModificationException
-
Eccezione generata a seguito di modifiche simultanee a un'applicazione. Questo errore può essere il risultato del tentativo di modificare un'applicazione senza utilizzare l'ID dell'applicazione corrente.
Codice di stato HTTP: 400
- InvalidArgumentException
-
Il valore del parametro di input specificato non è valido.
Codice di stato HTTP: 400
- InvalidRequestException
-
La richiesta JSON non è valida per l'operazione.
Codice di stato HTTP: 400
- ResourceInUseException
-
L'applicazione non è disponibile per questa operazione.
Codice di stato HTTP: 400
- ResourceNotFoundException
-
L'applicazione specificata non è stata trovata.
Codice di stato HTTP: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue:
