Meminta Ion dengan PartiQL di Amazon QLDB

Saat Anda menanyakan data di AmazonQLDB, Anda menulis pernyataan dalam format PartiQL, QLDB tetapi mengembalikan hasil dalam format Amazon Ion. PartiQL dimaksudkan untuk SQL menjadi -kompatibel, sedangkan Ion adalah perpanjangan dari. JSON Hal ini menyebabkan perbedaan sintaksis antara cara Anda mencatat data dalam pernyataan kueri Anda dibandingkan dengan bagaimana hasil kueri Anda ditampilkan.

Bagian ini menjelaskan sintaks dasar dan semantik untuk menjalankan pernyataan PartiQL secara manual dengan menggunakan konsol atau shell. QLDB QLDB

Sintaks dan semantik

Saat menggunakan QLDB konsol atau QLDB shell untuk menanyakan data Ion, berikut ini adalah sintaks dasar dan semantik PartiQL:

Literal

Literal bahasa kueri PartiQL sesuai dengan tipe data Ion, sebagai berikut:

Contoh

Berikut ini adalah contoh sintaks untuk INSERT pernyataan dengan berbagai jenis Ion.

INSERT INTO VehicleRegistration VALUE
{
    'VIN' : 'KM8SRDHF6EU074761', --string
    'RegNum' : 1722, --integer
    'State' : 'WA',
    'City' : 'Kent',
    'PendingPenaltyTicketAmount' : 130.75, --decimal
    'Owners' : { --nested struct
        'PrimaryOwner' : { 'PersonId': '294jJ3YUoH1IEEm8GSabOs' },
        'SecondaryOwners' : [ --list of structs
            { 'PersonId' : '1nmeDdLo3AhGswBtyM1eYh' },
            { 'PersonId': 'IN7MvYtUjkp1GMZu0F6CG9' }
        ]
    },
    'ValidFromDate' : `2017-09-14T`, --Ion timestamp literal with day precision
    'ValidToDate' : `2020-06-25T`
}

Notasi backtick

PartiQL sepenuhnya mencakup semua tipe data Ion, sehingga Anda dapat menulis pernyataan apa pun tanpa menggunakan backticks. Tetapi ada kasus di mana sintaks literal Ion ini dapat membuat pernyataan Anda lebih jelas dan lebih ringkas.

Misalnya, untuk menyisipkan dokumen dengan cap waktu Ion dan nilai simbol, Anda dapat menulis pernyataan berikut menggunakan sintaks PartiQL murni saja.

INSERT INTO myTable VALUE
{
    'myTimestamp': to_timestamp('2019-09-04T'),
    'mySymbol': cast('foo' as symbol)
}

Ini cukup bertele-tele, jadi sebagai gantinya, Anda dapat menggunakan backticks untuk menyederhanakan pernyataan Anda.

INSERT INTO myTable VALUE
{
    'myTimestamp': `2019-09-04T`,
    'mySymbol': `foo`
}

Anda juga dapat melampirkan seluruh struktur dalam backticks untuk menyimpan beberapa penekanan tombol lagi.

INSERT INTO myTable VALUE
`{
    myTimestamp: 2019-09-04T,
    mySymbol: foo
}`

'foo'

`foo`

Navigasi jalur

Saat menulis bahasa manipulasi data (DML) atau pernyataan kueri, Anda dapat mengakses bidang dalam struktur bersarang menggunakan langkah jalur. PartiQL mendukung notasi titik untuk mengakses nama bidang struktur induk. Contoh berikut mengakses Model bidang indukVehicle.

Vehicle.Model

Untuk mengakses elemen tertentu dari daftar, Anda dapat menggunakan operator kurung siku untuk menunjukkan nomor urut berbasis nol. Contoh berikut mengakses elemen SecondaryOwners dengan nomor urut. 2 Dengan kata lain, ini adalah elemen ketiga dari daftar.

SecondaryOwners[2]

Aliasing

QLDBmendukung konten terbuka dan skema. Jadi, ketika Anda mengakses bidang tertentu dalam sebuah pernyataan, cara terbaik untuk memastikan bahwa Anda mendapatkan hasil yang Anda harapkan adalah dengan menggunakan alias. Misalnya, jika Anda tidak menentukan alias eksplisit, sistem akan menghasilkan alias implisit untuk sumber Anda. FROM

SELECT VIN FROM Vehicle
--is rewritten to
SELECT Vehicle.VIN FROM Vehicle AS Vehicle

Tetapi hasilnya tidak dapat diprediksi untuk konflik nama bidang. Jika bidang lain bernama VIN ada dalam struktur bersarang di dalam dokumen, VIN nilai yang dikembalikan oleh kueri ini mungkin akan mengejutkan Anda. Sebagai praktik terbaik, tulis pernyataan berikut sebagai gantinya. Query ini mendeklarasikan v sebagai alias yang berkisar di atas tabel. Vehicle ASKata kunci adalah opsional.

SELECT v.VIN FROM Vehicle [ AS ] v

Aliasing sangat berguna saat memasukkan koleksi bersarang di dalam dokumen. Misalnya, pernyataan berikut menyatakan o sebagai alias yang berkisar di atas koleksi. VehicleRegistration.Owners

SELECT o.SecondaryOwners
FROM VehicleRegistration AS r, @r.Owners AS o

@Karakter secara teknis opsional di sini. Tetapi secara eksplisit menunjukkan bahwa Anda menginginkan Owners struktur di dalamnyaVehicleRegistration, bukan koleksi berbeda bernama Owners (jika ada).

Spesifikasi PartiQL

Untuk informasi selengkapnya tentang bahasa kueri PartiQL, lihat Spesifikasi PartiQL.