DiscoverInputSchema - Amazon Managed Service untuk Apache Flink (sebelumnya Amazon Kinesis Data Analytics untuk Apache Flink)
Sintaksis PermintaanParameter PermintaanSintaksis ResponsElemen ResponsKesalahanLihat Juga

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

DiscoverInputSchema

Menyimpulkan skema untuk aplikasi Kinesis Data Analytics berbasis SQL dengan mengevaluasi rekaman sampel pada sumber streaming yang ditentukan (aliran data Kinesis atau aliran pengiriman Firehose Data Kinesis) atau objek Amazon 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. Saat Anda membuat aplikasi menggunakan konsol Kinesis Data Analytics, konsol menggunakan operasi ini untuk menyimpulkan skema dan menampilkannya di antarmuka pengguna konsol.

Sintaksis Permintaan

{
   "InputProcessingConfiguration": { 
      "InputLambdaProcessor": { 
         "ResourceARN": "string"
      }
   },
   "InputStartingPositionConfiguration": { 
      "InputStartingPosition": "string"
   },
   "ResourceARN": "string",
   "S3Configuration": { 
      "BucketARN": "string",
      "FileKey": "string"
   },
   "ServiceExecutionRole": "string"
}

Parameter Permintaan

Permintaan menerima data berikut dalam format JSON.

InputProcessingConfiguration

Yang digunakan InputProcessingConfiguration untuk memproses catatan sebelum menemukan skema catatan.

Tipe: Objek InputProcessingConfiguration

Wajib: Tidak

InputStartingPositionConfiguration

Titik di mana Anda ingin Kinesis Data Analytics mulai membaca catatan dari sumber streaming yang ditentukan untuk tujuan penemuan.

Tipe: Objek InputStartingPositionConfiguration

Wajib: Tidak

ResourceARN

Nama Sumber Daya Amazon (ARN) dari sumber streaming.

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

ServiceExecutionRole

ARN dari peran yang digunakan untuk mengakses sumber streaming.

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 2048.

Pola: arn:.*

Diperlukan: Ya

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 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 InputProcessingConfiguration parameter.

Tipe: Array string

RawInputRecords

Data aliran mentah yang diambil sampelnya untuk menyimpulkan skema.

Tipe: Array string

Kesalahan

InvalidArgumentException

Nilai parameter input yang ditentukan tidak valid.

Kode Status HTTP: 400

InvalidRequestException

Permintaan JSON tidak valid untuk operasi.

Kode Status HTTP: 400

ResourceProvisionedThroughputExceededException

Discovery gagal mendapatkan rekaman dari sumber streaming karena Kinesis Streams. ProvisionedThroughputExceededException Untuk informasi selengkapnya, lihat GetRecordsdi Referensi API Amazon Kinesis Streams.

Kode Status HTTP: 400

ServiceUnavailableException

Layanan tidak dapat menyelesaikan permintaan.

Kode Status HTTP: 500

UnableToDetectSchemaException

Format data tidak valid. Kinesis Data 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: