Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Referensi format data Amazon Ion di Amazon QLDB
penting
Pemberitahuan akhir dukungan: Pelanggan yang ada akan dapat menggunakan Amazon QLDB hingga akhir dukungan pada 07/31/2025. Untuk detail selengkapnya, lihat Memigrasi QLDB Buku Besar Amazon ke Amazon Aurora Postgre
Amazon QLDB menggunakan model notasi data yang menyatukan Amazon Ion
Meminta Ion dengan PartiQL di Amazon QLDB
Untuk sintaks dan semantik kueri data Ion dengan PartiQL di, QLDB lihat di referensi Amazon PartiQL. Meminta Ion dengan PartiQL QLDB
Untuk contoh kode yang menanyakan dan memproses data Ion dalam QLDB buku besar, lihat Contoh kode Amazon Ion danBekerja 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 dariJSON, yang berarti bahwa setiap dokumen yang valid juga merupakan JSON dokumen Ion yang valid. Panduan ini mengasumsikan pengetahuan kerja dasar. JSON Jika Anda belum terbiasaJSON, lihat Memperkenalkan JSON
Anda dapat mencatat dokumen Ion secara bergantian baik dalam bentuk teks yang dapat dibaca manusia atau bentuk yang disandikan biner. SepertiJSON, bentuk teks mudah dibaca dan ditulis, mendukung pembuatan prototipe cepat. Pengkodean biner lebih kompak dan efisien untuk bertahan, mentransmisikan, 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
JSONkompatibel
Mirip denganJSON, Anda membuat dokumen Amazon Ion dengan sekumpulan tipe data primitif dan sekumpulan tipe kontainer yang ditentukan secara rekursif. Ion mencakup tipe JSON data 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. SepertiJSON,struct
memungkinkan beberapa nilai per nama, tetapi ini umumnya tidak disarankan.
Ekstensi dari JSON
Jenis nomor
Alih-alih JSON number
tipe 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 (64-bit). IEEE
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.00001
200.0
-
float
: Bilangan dengan eksponen, seperti notasi ilmiah atau notasi E (misalnya,,).2e0
3.1e-4
Tipe data baru
Amazon Ion menambahkan tipe data berikut:
-
timestamp
: Tanggal/waktu/momen zona waktu dengan 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 ], }