Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
penting
Pemberitahuan akhir dukungan: Pelanggan yang ada akan dapat menggunakan Amazon QLDB hingga akhir dukungan pada 07/31/2025. Untuk detail selengkapnya, lihat Memigrasi Buku Besar QLDB Amazon ke Amazon
Amazon QLDB menggunakan model notasi data yang menyatukan Amazon
Meminta Ion dengan PartiQL di Amazon QLDB
Untuk sintaks dan semantik kueri data Ion dengan PartiQL di QLDB, lihat di referensi PartiQL Amazon QLDB. Meminta Ion dengan PartiQL
Untuk contoh kode yang menanyakan dan memproses data Ion dalam buku besar QLDB, lihat dan. Contoh kode Amazon Ion Bekerja dengan Amazon Ion
Topik
Apa itu Amazon Ion?
Ion adalah format serialisasi data hierarkis open-source, diketik dengan kaya, mendeskripsikan sendiri, yang awalnya dikembangkan secara internal di Amazon. Ini didasarkan pada model data abstrak yang memungkinkan Anda menyimpan data terstruktur dan tidak terstruktur. Ini adalah superset dari JSON, yang berarti bahwa dokumen JSON yang valid juga merupakan dokumen Ion yang valid. Panduan ini mengasumsikan pengetahuan kerja dasar JSON. Jika Anda belum terbiasa dengan JSON, lihat Memperkenalkan JSON
Anda dapat mencatat dokumen Ion secara bergantian baik dalam bentuk teks yang dapat dibaca manusia atau bentuk yang disandikan biner. Seperti JSON, bentuk teks mudah dibaca dan ditulis, mendukung pembuatan prototipe cepat. Pengkodean biner lebih kompak dan efisien untuk bertahan, mengirimkan, dan mengurai. Prosesor Ion dapat mentranskode antara kedua format untuk mewakili kumpulan struktur data yang sama persis tanpa kehilangan data. Fitur ini memungkinkan aplikasi mengoptimalkan cara mereka memproses data untuk kasus penggunaan yang berbeda.
catatan
Model data Ion benar-benar berbasis nilai dan tidak mendukung referensi. Dengan demikian, model data dapat mewakili hierarki data yang dapat disarangkan ke kedalaman arbitrer, tetapi tidak grafik yang diarahkan.
Spesifikasi ion
Untuk daftar lengkap tipe data inti Ion dengan deskripsi lengkap dan detail pemformatan nilai, lihat dokumen spesifikasi Ion
Untuk merampingkan pengembangan aplikasi, Amazon Ion menyediakan pustaka klien yang memproses data Ion untuk Anda. Untuk contoh kode kasus penggunaan umum untuk memproses data Ion, lihat Buku Masak Amazon Ion
Kompatibel dengan JSON
Mirip dengan JSON, Anda membuat dokumen Amazon Ion dengan sekumpulan tipe data primitif dan sekumpulan tipe kontainer yang ditentukan secara rekursif. Ion mencakup tipe data JSON tradisional berikut:
-
null: Nilai null (kosong) generik yang tidak diketik. Selain itu, seperti yang dijelaskan di bagian berikut, Ion mendukung tipe nol yang berbeda untuk setiap tipe primitif. -
bool: Nilai Boolean. -
string: Literal teks Unicode. -
list: Mengurutkan koleksi nilai heterogen. -
struct: Koleksi pasangan nama-nilai yang tidak berurutan. Seperti JSON,structmemungkinkan beberapa nilai per nama, tetapi ini umumnya tidak dianjurkan.
Ekstensi dari JSON
Jenis nomor
Alih-alih number tipe JSON yang ambigu, Amazon Ion secara ketat mendefinisikan angka sebagai salah satu dari jenis berikut:
-
int: Bilangan bulat yang ditandatangani dengan ukuran arbitrer. -
decimal: Bilangan real desimal yang dikodekan dengan presisi arbitrer. -
float: Nomor floating point yang dikodekan biner (IEEE 64-bit).
Saat mengurai dokumen, prosesor Ion menetapkan jenis nomor sebagai berikut:
-
int: Angka tanpa titik eksponen atau desimal (misalnya,).100200 -
decimal: Angka dengan titik desimal dan tidak ada eksponen (misalnya,,).0.00001200.0 -
float: Bilangan dengan eksponen, seperti notasi ilmiah atau notasi E (misalnya,,).2e03.1e-4
Tipe data baru
Amazon Ion menambahkan tipe data berikut:
-
timestamp: Date/time/timezone momen presisi sewenang-wenang. -
symbol: Atom simbolik unicode (seperti pengidentifikasi). -
blob: Data biner dari pengkodean yang ditentukan pengguna. -
clob: Data teks pengkodean yang ditentukan pengguna. -
sexp: Mengurutkan koleksi nilai dengan semantik yang ditentukan aplikasi.
Jenis nol
Selain tipe null generik yang ditentukan oleh JSON, Amazon Ion mendukung tipe null yang berbeda untuk setiap tipe primitif. Ini menunjukkan kurangnya nilai sambil mempertahankan tipe data yang ketat.
null null.null // Identical to untyped null null.bool null.int null.float null.decimal null.timestamp null.string null.symbol null.blob null.clob null.struct null.list null.sexp
Contoh teks ion
// Here is a struct, which is similar to a JSON object. { // Field names don't always have to be quoted. name: "fido", // This is an integer. age: 7, // This is a timestamp with day precision. birthday: 2012-03-01T, // Here is a list, which is like a JSON array. toys: [ // These are symbol values, which are like strings, // but get encoded as integers in binary. ball, rope ], }
Referensi API
