Dokumen QLDB B B B B B B B B B

Amazon QLDB menyimpan catatan data sebagai dokumen, yang hanyastruct objek Amazon Ion yang dimasukkan ke dalam tabel. Untuk spesifikasi Ion, lihat GitHub situs Amazon Ion.

Struktur dokumen ion

Seperti JSON, dokumen QLDB terdiri dari pasangan nama-nilai dalam struktur berikut.

{
  name1: value1,
  name2: value2,
  name3: value3,
  ...
  nameN: valueN
}

Nama-nama adalah token simbol, dan nilainya tidak dibatasi. Setiap pasangan nama-nilai disebut bidang. Nilai bidang dapat berupa salah satu IonJenis Data, termasuk tipe kontainer: struktur bersarang, daftar, dan daftar struktur.

Juga seperti JSON, astruct dilambangkan dengan kurung kurawal ({...}), danlist dilambangkan dengan tanda kurung persegi ([...]). Contoh berikut adalah dokumen dari data sampel diMemulai dengan konsol Amazon QLDB yang berisi nilai-nilai dari berbagai jenis.

{
    VIN: "1N4AL11D75C109151",
    LicensePlateNumber: "LEWISR261LL",
    State: "WA",
    City: "Seattle",
    PendingPenaltyTicketAmount: 90.25,
    ValidFrom: 2017-08-21T,
    ValidTo: 2020-05-11T,
    Owners: {
        PrimaryOwner: { PersonId: "294jJ3YUoH1IEEm8GSabOs" },
        SecondaryOwners: [{ PersonId: "5Ufgdlnj06gF5CWcOIu64s" }]
    }
}

penting

Di Ion, tanda kutip ganda menunjukkan nilai string, dan simbol yang tidak dikutip mewakili nama bidang. Tapi di PartiQL, tanda kutip tunggal menunjukkan string dan nama bidang.

Perbedaan sintaks ini memungkinkan bahasa kueri PartiQL mempertahankan kompatibilitas SQL, dan format data Amazon Ion untuk mempertahankan kompatibilitas JSON. Untuk rincian tentang sintaks dan semantik PartiQL di QLDB, lihatKueri Ion dengan PartiQL.

Pemetaan tipe partiQL-ion

Di QLDB, PartiQL memperluas sistem tipe SQL untuk menutupi model data Ion. Pemetaan ini dijelaskan sebagai berikut:

• Jenis skalar SQL ditutupi oleh rekan-rekan Ion mereka. Misalnya:

  • CHARdanVARCHAR merupakan urutan Unicode yang memetakan kestring tipe Ion.

  • NUMBERpeta kedecimal tipe Ion.

• structTipe ion setara dengan tupel SQL, yang secara tradisional mewakili baris tabel.

  • Namun, dengan konten terbuka dan tanpa skema, kueri yang bergantung pada sifat yang diurutkan dari tupel SQL tidak didukung (seperti urutan keluaranSELECT *).

• Selain ituNULL, PartiQL memilikiMISSING tipe. Ini adalah spesialisasiNULL dan menunjukkan kurangnya lapangan. Jenis ini diperlukan karenastruct bidang Ion mungkin jarang.

ID Dokumen

QLDB memberikan ID dokumen untuk setiap dokumen yang Anda masukkan ke dalam tabel. Semua ID yang ditetapkan sistem adalah pengidentifikasi unik universal (UUID) yang masing-masing diwakili dalam string yang dikodekan Base62 (misalnya,3Qv67yjXEwB9SjmvkuG6Cp). Untuk informasi selengkapnya, lihat ID unik di Amazon QLDB.

Setiap revisi dokumen diidentifikasi secara unik dengan kombinasi ID dokumen dan nomor versi berbasis nol.

Bidang ID dokumen dan versi disertakan dalam metadata dokumen, yang dapat Anda kueri dalam tampilan berkomitmen (tampilan tabel yang ditentukan sistem). Untuk informasi lebih lanjut tentang tampilan di QLDB, lihatKonsep inti. Untuk mempelajari tentang metadata, lihatMelakukan Kueri Metadata Dokumen.