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. SQL

Amazon QLDB menggunakan model notasi data yang menyatukan Amazon Ion dengan subset tipe PartiQL. Bagian ini memberikan gambaran referensi format data dokumen Ion, terpisah dari integrasinya dengan PartiQL.

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?
• Spesifikasi ion
• JSONkompatibel
• Ekstensi dari JSON
• Contoh teks ion
• APIreferensi
• Contoh kode Amazon Ion di QLDB

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 untuk informasi selengkapnya.

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 di situs Amazon GitHub .

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. GitHub

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
    ],
}

APIreferensi

• ion-go

• ion-java

• ion-js

• ion-python