AddApplicationReferenceDataSource - Servizio gestito da Amazon per Apache Flink

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 una delle lingue specifiche AWS SDKs, consulta quanto segue: