Referensi format data Amazon Ion di Amazon QLDB - Amazon Quantum Ledger Database (Amazon QLDB)
Apa itu Amazon Ion?Spesifikasi ionKompatibel dengan JSONEkstensi dari JSONContoh teks ionReferensi API

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

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

Menanyakan Ion dengan PartiQL di Amazon QLDB

Untuk sintaks dan semantik kueri data Ion dengan PartiQL di QLDB, lihatKueri Ion dengan PartiQL di referensi Amazon QLDB PartiQL.

Untuk contoh kode yang query dan proses data Ion dalam buku besar QLDB, lihatContoh kode Amazon Ion danBekerja dengan Amazon Ion.

Topik

Apa itu Amazon Ion?

Ion adalah open-source, kaya diketik, self-describing, format serialisasi data hirarkis 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 dasar tentang JSON. Jika Anda belum terbiasa dengan JSON, lihat Memperkenalkan JSON untuk informasi selengkapnya.

Anda dapat mencatat dokumen Ion secara bergantian dalam bentuk teks yang dapat dibaca manusia atau formulir yang dikodekan 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 persis sama tanpa kehilangan data. Fitur ini memungkinkan aplikasi mengoptimalkan cara mereka memproses data untuk kasus penggunaan yang berbeda.

catatan

Model data Ion secara ketat berbasis nilai dan tidak mendukung referensi. Dengan demikian, model data dapat mewakili hirarki data yang dapat bersarang ke kedalaman sewenang-wenang, tetapi tidak diarahkan grafik.

Spesifikasi ion

Untuk daftar lengkap tipe data inti Ion dengan deskripsi lengkap dan detail pemformatan nilai, lihat dokumen spesifikasi Ion di GitHub situs Amazon.

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 Masakan Amazon Ion aktif GitHub.

Kompatibel dengan JSON

Mirip dengan JSON, Anda menyusun dokumen Amazon Ion dengan sekumpulan tipe data primitif dan sekumpulan tipe kontainer yang ditentukan secara rekursif. Ion mencakup tipe data JSON tradisional berikut:

  • null: Sebuah generik, untyped null (kosong) nilai. Selain itu, seperti yang dijelaskan di bagian berikut, Ion mendukung tipe null yang berbeda untuk setiap tipe primitif.

  • bool: Nilai Boolean.

  • string: Literal teks Unicode.

  • list: Memerintahkan koleksi nilai heterogen.

  • struct: Koleksi pasangan nama-nilai. Seperti JSON,struct memungkinkan beberapa nilai per nama, tetapi ini umumnya tidak dianjurkan.

Ekstensi dari JSON

Jenis Angka

Alih-alihnumber tipe JSON yang ambigu, Amazon Ion secara ketat mendefinisikan angka sebagai salah satu jenis berikut:

  • int: Bilangan bulat yang ditandatangani dengan ukuran sewenang-wenang.

  • decimal: Bilangan real yang dikodekan desimal dengan presisi sewenang-wenang.

  • 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.00001,200.0).

  • float: Angka dengan eksponen, seperti notasi ilmiah atau e-notasi (misalnya,2e0,3.1e-4).

Tipe data baru

Amazon Ion menambahkan tipe data berikut:

  • timestamp: Tanggal/waktu/zona waktu momen presisi sewenang-wenang.

  • symbol: Atom simbolis Unicode (seperti pengidentifikasi).

  • blob: Data biner pengkodean yang ditentukan pengguna.

  • clob: Data teks pengkodean yang ditentukan pengguna.

  • sexp: Koleksi nilai yang dipesan dengan semantik yang ditentukan aplikasi.

Jenis Null

Selain tipe null generik yang ditentukan oleh JSON, Amazon Ion mendukung tipe null yang berbeda untuk setiap tipe primitif. Hal 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