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
Añade un origen de datos de referencia a una aplicación de Kinesis Data Analytics basada en SQL.
Kinesis Data 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 asignación necesaria que describe cómo los datos en un objeto de Amazon S3 se correlacionan con las columnas de la tabla en la aplicación resultante.
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"
},
"TableName": "string"
}
}Parámetros de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
- ApplicationName
-
El 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
-
La 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 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
-
El origen de datos de referencia puede ser un objeto en el bucket de Amazon S3. Kinesis Data Analytics lee el objeto y copia los datos en la tabla de 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.
Tipo: objeto ReferenceDataSource
Obligatorio: sí
Sintaxis de la respuesta
{
"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"
}
]
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
- ApplicationARN
-
El nombre de recurso de Amazon (ARN) de la aplicación.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.
Patrón:
arn:.* - ApplicationVersionId
-
El ID de la versión actualizada de la aplicación. Kinesis Data Analytics incrementa este ID cuando se actualiza la aplicación.
Tipo: largo
Rango válido: valor mínimo de 1. Valor máximo de 999 999 999.
- ReferenceDataSourceDescriptions
-
Describe los orígenes de datos de referencia configurados para la aplicación.
Tipo: matriz de objetos ReferenceDataSourceDescription
Errores
- ConcurrentModificationException
-
Excepción que se produce como resultado de modificaciones simultáneas en una aplicación. El error puede deberse a un intento de modificar una aplicación sin utilizar el ID de la aplicación actual.
Código de estado HTTP: 400
- InvalidArgumentException
-
El valor del parámetro de entrada especificado no es válido.
Código de estado HTTP: 400
- InvalidRequestException
-
El JSON de la solicitud no es válido para la operación.
Código de estado HTTP: 400
- ResourceInUseException
-
La aplicación no está disponible para esta operación.
Código de estado HTTP: 400
- ResourceNotFoundException
-
No se encuentra la aplicación especificada.
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, consulte lo siguiente:
