Setelah mempertimbangkan dengan cermat, kami memutuskan untuk menghentikan Amazon Kinesis Data Analytics SQL untuk aplikasi dalam dua langkah:
1. Mulai 15 Oktober 2025, Anda tidak akan dapat membuat Kinesis Data Analytics SQL baru untuk aplikasi.
2. Kami akan menghapus aplikasi Anda mulai 27 Januari 2026. Anda tidak akan dapat memulai atau mengoperasikan Amazon Kinesis Data Analytics Anda SQL untuk aplikasi. Support tidak akan lagi tersedia untuk Amazon Kinesis Data Analytics SQL sejak saat itu. Untuk informasi selengkapnya, lihat Amazon Kinesis Data Analytics SQL untuk penghentian Aplikasi.
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
DiscoverInputSchema
catatan
Dokumentasi ini ditujukan untuk API Amazon Kinesis Data Analytics versi 1, yang hanya mendukung aplikasi SQL. API versi 2 mendukung aplikasi SQL dan Java. Untuk informasi selengkapnya tentang versi 2, lihat Dokumentasi V2 API Amazon Kinesis Data Analytics.
Menyimpulkan skema dengan mengevaluasi catatan sampel pada sumber streaming yang ditentukan (Amazon Kinesis stream atau aliran pengiriman Amazon Kinesis Firehose) atau objek S3. Dalam respons, operasi mengembalikan skema disimpulkan dan juga catatan sampel yang digunakan operasi untuk menyimpulkan skema.
Anda dapat menggunakan skema yang disimpulkan ketika mengonfigurasi sumber streaming untuk aplikasi Anda. Untuk informasi konseptual, lihat Mengonfigurasi Input Aplikasi. Perhatikan bahwa ketika Anda membuat aplikasi menggunakan konsol Amazon Kinesis Analytics, konsol menggunakan operasi ini untuk menyimpulkan skema dan menunjukkannya di antarmuka pengguna konsol.
Operasi ini memerlukan izin untuk menjalankan tindakan kinesisanalytics:DiscoverInputSchema.
Sintaksis Permintaan
{
"InputProcessingConfiguration": {
"InputLambdaProcessor": {
"ResourceARN": "string",
"RoleARN": "string"
}
},
"InputStartingPositionConfiguration": {
"InputStartingPosition": "string"
},
"ResourceARN": "string",
"RoleARN": "string",
"S3Configuration": {
"BucketARN": "string",
"FileKey": "string",
"RoleARN": "string"
}
}Parameter Permintaan
Permintaan menerima data berikut dalam format JSON.
- InputProcessingConfiguration
-
Yang digunakan InputProcessingConfigurationuntuk memproses catatan sebelum menemukan skema catatan.
Tipe: Objek InputProcessingConfiguration
Wajib: Tidak
- InputStartingPositionConfiguration
-
Tunjuk tempat Anda ingin Amazon Kinesis Analytics mulai membaca catatan dari tujuan penemuan sumber streaming yang ditentukan.
Tipe: Objek InputStartingPositionConfiguration
Wajib: Tidak
- ResourceARN
-
Amazon Resource Name (ARN) sumber streaming.
Jenis: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 2048.
Pola:
arn:.*Wajib: Tidak
- RoleARN
-
ARN IAM role yang dapat diasumsikan Amazon Kinesis Analytics untuk mengakses pengaliran atas nama Anda.
Jenis: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 2048.
Pola:
arn:.*Wajib: Tidak
- S3Configuration
-
Tentukan parameter ini untuk menemukan skema dari data dalam objek Amazon S3.
Tipe: Objek S3Configuration
Wajib: Tidak
Sintaksis Respons
{
"InputSchema": {
"RecordColumns": [
{
"Mapping": "string",
"Name": "string",
"SqlType": "string"
}
],
"RecordEncoding": "string",
"RecordFormat": {
"MappingParameters": {
"CSVMappingParameters": {
"RecordColumnDelimiter": "string",
"RecordRowDelimiter": "string"
},
"JSONMappingParameters": {
"RecordRowPath": "string"
}
},
"RecordFormatType": "string"
}
},
"ParsedInputRecords": [
[ "string" ]
],
"ProcessedInputRecords": [ "string" ],
"RawInputRecords": [ "string" ]
}Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
- InputSchema
-
Skema yang disimpulkan dari sumber streaming. Ini mengidentifikasi format data dalam sumber streaming, dan cara setiap elemen data dipetakan ke kolom yang sesuai di aliran dalam aplikasi yang dapat Anda buat.
Tipe: Objek SourceSchema
- ParsedInputRecords
-
Array elemen, tempat setiap elemen sesuai dengan baris dalam catatan aliran (catatan aliran dapat memiliki lebih dari satu baris).
Tipe: Array dari array string.
- ProcessedInputRecords
-
Data aliran yang dimodifikasi oleh prosesor yang ditentukan dalam parameter
InputProcessingConfiguration.Tipe: Array string
- RawInputRecords
-
Data aliran mentah yang diambil sampel untuk menyimpulkan skema.
Tipe: Array string
Kesalahan
- InvalidArgumentException
-
Nilai parameter input yang ditentukan tidak valid.
Kode Status HTTP: 400
- ResourceProvisionedThroughputExceededException
-
Discovery gagal mendapatkan rekaman dari sumber streaming karena Amazon ProvisionedThroughputExceededException Kinesis Streams. Untuk informasi selengkapnya, lihat GetRecordsdi Referensi API Amazon Kinesis Streams.
Kode Status HTTP: 400
- ServiceUnavailableException
-
Layanan tidak tersedia. Kembali dan coba lagi operasi.
Kode Status HTTP: 500
- UnableToDetectSchemaException
-
Format data tidak valid. Amazon Kinesis Analytics tidak dapat mendeteksi skema untuk sumber streaming yang diberikan.
Kode Status HTTP: 400
- UnsupportedOperationException
-
Permintaan ditolak karena parameter tertentu tidak didukung atau sumber daya tertentu tidak valid untuk operasi ini.
Kode Status HTTP: 400
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini:
