Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
AddApplicationReferenceDataSource
Menambahkan sumber data referensi ke aplikasi Kinesis Data Analytics berbasis SQL yang ada.
Kinesis Data Analytics membaca data referensi (yaitu objek Amazon S3) dan membuat tabel dalam aplikasi dalam aplikasi Anda. Dalam permintaan, Anda memberikan sumber (nama bucket S3 dan nama kunci objek), nama tabel dalam aplikasi yang dibuat, dan informasi pemetaan yang diperlukan yang menjelaskan cara memetakan data di objek Amazon S3 ke kolom di tabel dalam aplikasi yang dihasilkan.
Sintaksis Permintaan
{
"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"
}
}Parameter Permintaan
Permintaan menerima data berikut dalam format JSON.
- ApplicationName
-
Nama aplikasi yang ada.
Jenis: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.
Pola:
[a-zA-Z0-9_.-]+Wajib: Ya
- CurrentApplicationVersionId
-
Versi aplikasi yang Anda tambahkan sumber data referensi. Anda dapat menggunakan DescribeApplication operasi untuk mendapatkan versi aplikasi saat ini. Jika versi yang ditentukan bukan versi saat ini,
ConcurrentModificationExceptiondikembalikan.Tipe: Long
Rentang yang Valid: Nilai minimum 1. Nilai maksimum 999999999.
Wajib: Ya
- ReferenceDataSource
-
Sumber data referensi dapat berupa objek dalam bucket Amazon S3 Anda. Kinesis Data Analytics membaca objek dan menyalin data ke dalam tabel dalam aplikasi yang dibuat. Anda menyediakan bucket S3, objek kunci nama, dan tabel dalam aplikasi yang dihasilkan yang dibuat.
Tipe: Objek ReferenceDataSource
Wajib: Ya
Sintaksis Respons
{
"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"
}
]
}Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
- ApplicationARN
-
Aplikasi Amazon Resource Name (ARN).
Jenis: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 2048.
Pola:
arn:.* - ApplicationVersionId
-
ID versi aplikasi yang diperbarui. Kinesis Data Analytics menambah ID ini saat aplikasi diperbarui.
Tipe: Long
Rentang yang Valid: Nilai minimum 1. Nilai maksimum 999999999.
- ReferenceDataSourceDescriptions
-
Menjelaskan sumber data referensi yang dikonfigurasi untuk aplikasi.
Tipe: Array objek ReferenceDataSourceDescription
Kesalahan
- ConcurrentModificationException
-
Pengecualian dilemparkan sebagai hasil dari modifikasi bersamaan ke aplikasi. Kesalahan ini dapat disebabkan oleh upaya memodifikasi aplikasi tanpa menggunakan ID aplikasi saat ini.
Kode Status HTTP: 400
- InvalidArgumentException
-
Nilai parameter input yang ditentukan tidak valid.
Kode Status HTTP: 400
- InvalidRequestException
-
Permintaan JSON tidak valid untuk operasi.
Kode Status HTTP: 400
- ResourceInUseException
-
Aplikasi ini tidak tersedia untuk operasi ini.
Kode Status HTTP: 400
- ResourceNotFoundException
-
Aplikasi yang ditentukan tidak dapat ditemukan.
Kode Status HTTP: 400
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini:
