

Setelah mempertimbangkan dengan cermat, kami memutuskan untuk menghentikan Amazon Kinesis Data Analytics untuk aplikasi SQL:

1. Mulai **1 September 2025,** kami tidak akan memberikan perbaikan bug untuk Amazon Kinesis Data Analytics untuk aplikasi SQL karena kami akan memiliki dukungan terbatas untuk itu, mengingat penghentian yang akan datang.

2. Mulai **15 Oktober 2025,** Anda tidak akan dapat membuat Kinesis Data Analytics baru untuk aplikasi SQL.

3. Kami akan menghapus aplikasi Anda mulai **27 Januari 2026**. Anda tidak akan dapat memulai atau mengoperasikan Amazon Kinesis Data Analytics untuk aplikasi SQL. Support tidak akan lagi tersedia untuk Amazon Kinesis Data Analytics untuk SQL sejak saat itu. Untuk informasi selengkapnya, lihat [Amazon Kinesis Data Analytics untuk penghentian Aplikasi SQL](discontinuation.md).

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

# Menggunakan Editor Skema
<a name="console-summary-edit-schema"></a>

Skema untuk aliran input aplikasi Amazon Kinesis Data Analytics mendefinisikan bagaimana data dari aliran disediakan untuk kueri SQL dalam aplikasi. 

![Diagram yang menunjukkan hubungan antara input streaming, konfigurasi skema sumber, dan aliran input dalam aplikasi](http://docs.aws.amazon.com/id_id/kinesisanalytics/latest/dev/images/edit-schema-diagram.png)


Skema berisi kriteria pilihan untuk menentukan bagian dari input streaming yang diubah menjadi kolom data di aliran input dalam aplikasi. Ini dapat menjadi salah satu dari yang berikut: 
+  JSONPath Ekspresi untuk aliran input JSON. JSONPath adalah alat untuk menanyakan data JSON.
+ Jumlah kolom untuk aliran input dalam format nilai yang dipisahkan koma (CSV).
+ Nama kolom dan tipe data SQL untuk menyajikan data di aliran data dalam aplikasi. Tipe data juga berisi panjang untuk karakter atau data biner.

Konsol mencoba membuat skema menggunakan [DiscoverInputSchema](API_DiscoverInputSchema.md). Jika penemuan skema gagal atau mengembalikan skema yang salah atau tidak lengkap, Anda harus mengedit skema secara manual menggunakan editor skema.

## Layar Utama Editor Skema
<a name="schema_editor"></a>

Tangkapan layar berikut menunjukkan layar utama untuk Editor Skema.

![Tangkapan layar halaman edit skema.](http://docs.aws.amazon.com/id_id/kinesisanalytics/latest/dev/images/edit-schema-overview.png)


Anda dapat menerapkan pengeditan berikut ke skema:
+ Tambahkan kolom (1): Anda mungkin perlu menambahkan kolom data jika item data tidak terdeteksi secara otomatis.
+ Hapus kolom (2): Anda dapat mengecualikan data dari aliran sumber jika aplikasi Anda tidak memerlukannya. Pengecualian ini tidak memengaruhi data dalam aliran sumber. Jika data dikecualikan, data tersebut tidak disediakan untuk aplikasi.
+ Ubah nama kolom (3). Nama kolom tidak boleh kosong, harus lebih panjang dari satu karakter, dan tidak boleh berisi kata kunci SQL tersimpan. Nama juga harus memenuhi kriteria penamaan untuk pengidentifikasi biasa SQL: Nama harus dimulai dengan huruf dan hanya berisi huruf, karakter garis bawah, dan angka.
+ Ubah tipe data (4) atau panjang (5) kolom: Anda dapat menentukan tipe data yang kompatibel untuk kolom. Jika Anda menentukan tipe data yang tidak kompatibel, kolom diisi dengan NULL atau aliran dalam aplikasi tidak diisi sama sekali. Dalam kasus terakhir, kesalahan ditulis ke aliran kesalahan. Jika Anda menentukan panjang untuk kolom yang terlalu kecil, data yang masuk akan dipotong.
+ Mengubah kriteria pemilihan kolom (6): Anda dapat mengedit JSONPath ekspresi atau urutan kolom CSV yang digunakan untuk menentukan sumber data dalam kolom. Untuk mengubah kriteria pemilihan untuk skema JSON, masukkan nilai baru untuk ekspresi jalur baris. Skema CSV menggunakan urutan kolom sebagai kriteria pilihan. Untuk mengubah kriteria pemilihan skema CSV, ubah urutan kolom.

## Mengedit Skema untuk Sumber Streaming
<a name="editing_schema"></a>

Jika Anda perlu mengedit skema untuk sumber streaming, ikuti langkah-langkah berikut.

**Untuk mengedit skema sumber streaming**

1. Di halaman **Sumber**, pilih **Edit schema** (Edit skema).  
![Tangkapan layar tab sampel aliran yang diformat yang berisi data stok, dengan tombol edit skema disorot.](http://docs.aws.amazon.com/id_id/kinesisanalytics/latest/dev/images/edit-schema-1.png)

1. Di halaman **Edit skema**, edit skema sumber.  
![Tangkapan layar halaman edit skema.](http://docs.aws.amazon.com/id_id/kinesisanalytics/latest/dev/images/edit-schema-0.png)

1. Untuk **Format**, pilih **JSON** atau **CSV**. Untuk format JSON atau CSV, pengkodean yang didukung adalah ISO 8859-1.

Untuk informasi selengkapnya tentang mengedit skema untuk format JSON atau CSV, lihat prosedur di bagian berikutnya.

### Mengedit Skema JSON
<a name="edit_json_schema"></a>

Anda dapat mengedit skema JSON menggunakan langkah-langkah berikut.

**Untuk mengedit skema JSON**

1. Di editor skema, pilih **Add column** (Tambahkan kolom) untuk menambahkan kolom. 

   Kolom baru muncul di posisi kolom pertama. Untuk mengubah urutan kolom, pilih panah atas dan bawah di samping nama kolom. 

   Untuk kolom baru, masukkan informasi berikut:
   + Untuk **Column name** (Nama kolom), masukkan nama. 

     Nama kolom tidak boleh kosong, harus lebih panjang dari satu karakter, dan tidak boleh berisi kata kunci SQL tersimpan. Nama juga harus memenuhi kriteria penamaan untuk pengidentifikasi biasa SQL: Nama harus dimulai dengan huruf dan hanya berisi huruf, karakter garis bawah, serta angka.
   + Untuk **Column type** (Tipe kolom), masukkan tipe data SQL. 

     Tipe kolom dapat berupa tipe data SQL yang didukung. Jika tipe data baru adalah CHAR, VARBINARY, atau VARCHAR, tentukan panjang data untuk **Length** (Panjang). Untuk informasi selengkapnya, lihat [Tipe Data](https://docs.aws.amazon.com/kinesisanalytics/latest/sqlref/sql-reference-data-types.html).
   + Untuk **Row path** (Jalur baris), masukkan jalur baris. Jalur baris adalah JSONPath ekspresi valid yang memetakan ke elemen JSON. 
**catatan**  
Nilai **Row path** (Jalur baris) dasar adalah jalur ke induk tingkat atas yang berisi data yang akan diimpor. Nilainya adalah **$** secara default. Untuk informasi selengkapnya, lihat `RecordRowPath` di `[JSONMappingParameters](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/API_JSONMappingParameters.html)`.

1. Untuk menghapus kolom, pilih ikon **x** di sebelah nomor kolom.  
![Tangkapan layar editor skema yang menampilkan ikon x di sebelah nomor kolom.](http://docs.aws.amazon.com/id_id/kinesisanalytics/latest/dev/images/edit-schema-delete.png)

1. Untuk mengubah nama kolom, masukkan nama baru untuk **Column name** (Nama kolom). Nama kolom baru tidak boleh kosong, harus lebih panjang dari satu karakter, dan tidak boleh berisi kata kunci SQL tersimpan. Nama juga harus memenuhi kriteria penamaan untuk pengidentifikasi biasa SQL: Nama harus dimulai dengan huruf dan hanya berisi huruf, karakter garis bawah, serta angka.

1. Untuk mengubah tipe data kolom, pilih tipe data baru untuk **Column type** (Tipe kolom). Jika tipe data baru adalah `CHAR`, `VARBINARY`, atau `VARCHAR`, tentukan panjang data untuk **Length** (Panjang). Untuk informasi selengkapnya, lihat [Tipe Data](https://docs.aws.amazon.com/kinesisanalytics/latest/sqlref/sql-reference-data-types.html).

1. Pilih **Save schema and update stream** (Simpan skema dan perbarui aliran) untuk menyimpan perubahan Anda.

Skema yang dimodifikasi muncul di editor dan terlihat seperti berikut ini.

![Tangkapan layar skema editor yang menunjukkan skema yang dimodifikasi.](http://docs.aws.amazon.com/id_id/kinesisanalytics/latest/dev/images/edit-schema-2.png)


Jika skema Anda memiliki banyak baris, Anda dapat memfilter baris menggunakan **Filter by column name** (Filter berdasarkan nama kolom). Misalnya, untuk mengedit nama kolom yang dimulai dengan `P`, seperti kolom `Price`, masukkan `P` di kotak **Filter by column name** (Filter berdasarkan nama kolom).

### Mengedit Skema CSV
<a name="edit_csv_schema"></a>

Anda dapat mengedit skema CSV menggunakan langkah-langkah berikut.

**Untuk mengedit skema CSV**

1. Di editor skema, untuk **Row delimiter** (Pembatas baris), pilih pembatas yang digunakan oleh aliran data masuk Anda. Ini adalah pembatas antara catatan data dalam aliran Anda, seperti karakter baris baru.

1. Untuk **Column delimiter** (Pembatas kolom), pilih pembatas yang digunakan oleh aliran data masuk Anda. Ini adalah pembatas di antara bidang data dalam aliran Anda, seperti koma.

1. Untuk menambahkan kolom, pilih **Add column** (Tambahkan kolom). 

   Kolom baru muncul di posisi kolom pertama. Untuk mengubah urutan kolom, pilih panah atas dan bawah di samping nama kolom. 

   Untuk kolom baru, masukkan informasi berikut:
   + Untuk **Column name** (Nama kolom), masukkan nama. 

     Nama kolom tidak boleh kosong, harus lebih panjang dari satu karakter, dan tidak boleh berisi kata kunci SQL tersimpan. Nama juga harus memenuhi kriteria penamaan untuk pengidentifikasi biasa SQL: Nama harus dimulai dengan huruf dan hanya berisi huruf, karakter garis bawah, serta angka.
   + Untuk **Column type** (Tipe kolom), masukkan tipe data SQL. 

     Tipe kolom dapat berupa tipe data SQL yang didukung. Jika tipe data baru adalah CHAR, VARBINARY, atau VARCHAR, tentukan panjang data untuk **Length** (Panjang). Untuk informasi selengkapnya, lihat [Tipe Data](https://docs.aws.amazon.com/kinesisanalytics/latest/sqlref/sql-reference-data-types.html).

1. Untuk menghapus kolom, pilih ikon **x** di sebelah nomor kolom.  
![Tangkapan layar editor skema yang menampilkan ikon x di sebelah nomor kolom.](http://docs.aws.amazon.com/id_id/kinesisanalytics/latest/dev/images/edit-schema-delete.png)

1. Untuk mengubah nama kolom, masukkan nama baru di **Column name** (Nama kolom). Nama kolom baru tidak boleh kosong, harus lebih panjang dari satu karakter, dan tidak boleh berisi kata kunci SQL tersimpan. Nama juga harus memenuhi kriteria penamaan untuk pengidentifikasi biasa SQL: Nama harus dimulai dengan huruf dan hanya berisi huruf, karakter garis bawah, serta angka.

1. Untuk mengubah tipe data kolom, pilih tipe data baru untuk **Column type** (Tipe kolom). Jika tipe data baru adalah CHAR, VARBINARY, atau VARCHAR, tentukan panjang data untuk **Length** (Panjang). Untuk informasi selengkapnya, lihat [Tipe Data](https://docs.aws.amazon.com/kinesisanalytics/latest/sqlref/sql-reference-data-types.html).

1. Pilih **Save schema and update stream** (Simpan skema dan perbarui aliran) untuk menyimpan perubahan Anda.

Skema yang dimodifikasi muncul di editor dan terlihat seperti berikut ini.

![Tangkapan layar skema editor yang menunjukkan skema yang dimodifikasi.](http://docs.aws.amazon.com/id_id/kinesisanalytics/latest/dev/images/edit-schema-3.png)


Jika skema Anda memiliki banyak baris, Anda dapat memfilter baris menggunakan **Filter by column name** (Filter berdasarkan nama kolom). Misalnya, untuk mengedit nama kolom yang dimulai dengan `P`, seperti kolom `Price`, masukkan `P` di kotak **Filter by column name** (Filter berdasarkan nama kolom).