Halaman ini menjelaskan cara menggunakan jenis data JSONB
saat menggunakan Spanner.
JSONB
adalah jenis data PostgreSQL yang digunakan untuk menyimpan data semi-terstruktur dalam dialek PostgreSQL Spanner. JSONB
menyimpan data
dalam format JavaScript Object Notation (JSON), yang mengikuti spesifikasi
yang dijelaskan dalam RFC 7159.
Spesifikasi
Jenis data Spanner JSONB
menyimpan representasi dokumen input yang dinormalisasi. Hal ini menyiratkan hal berikut:
- Tanda kutip dan karakter spasi kosong tidak dipertahankan.
- Komentar tidak didukung. Transaksi atau kueri dengan komentar gagal.
- Kunci objek diurutkan terlebih dahulu berdasarkan panjang kunci, lalu secara leksikografis berdasarkan panjang kunci objek yang setara. Jika ada kunci objek duplikat, hanya kunci terakhir yang dipertahankan.
- Jenis primitif (
string
,boolean
,number
, dannull
) memiliki jenis dan nilai yang dipertahankan.- Nilai jenis
string
dipertahankan persis seperti aslinya. - Angka nol di akhir dipertahankan. Format output untuk nilai jenis
number
tidak menggunakan notasi ilmiah.
- Nilai jenis
Nilai
JSONB
null
diperlakukan sebagai non-NULL
SQL. Misalnya:SELECT null::jsonb IS NULL; -- Returns true SELECT 'null'::jsonb IS NULL; -- Returns false SELECT '{"a":null}'::jsonb -> 'a' IS NULL; -- Returns false SELECT '{"a":null}'::jsonb -> 'b' IS NULL; -- Returns true SELECT '{"a":null}'::jsonb -> 'a'; -- Returns a JSONB 'null' SELECT '{"a":null}'::jsonb -> 'b'; -- Returns a SQL NULL
Urutan elemen array JSONB dipertahankan.
Pembatasan
Batasan berikut berlaku dengan Spanner JSONB
:
- Argumen untuk fungsi
to_jsonb
hanya dapat berasal dari jenis data PostgreSQL yang didukung Spanner. - Nilai jenis angka dapat memiliki 4.932 digit sebelum koma desimal dan 16.383 digit setelah koma desimal.
- Ukuran maksimum yang diizinkan untuk format penyimpanan yang dinormalisasi adalah 10 MB.
- Dokumen
JSONB
harus dienkode dalam UTF-8. Transaksi atau kueri denganJSONB
dokumen yang dienkode dalam format lain akan menampilkan error.
Membuat tabel dengan kolom JSONB
Anda dapat menambahkan kolom JSONB
ke tabel saat membuat tabel.
CREATE TABLE Venues (
VenueId BIGINT PRIMARY KEY,
VenueName VARCHAR(1024),
VenueAddress VARCHAR(1024),
VenueFeatures JSONB,
DateOpened TIMESTAMPTZ
);
Berikut contoh objek VenueFeatures
JSONB
:
{
"rating": 4.5,
"capacity":"1500",
"construction":"brick",
"tags": [
"multi-cuisine",
"open-seating",
"stage",
"public address system"
]
}
Menambahkan dan menghapus kolom JSONB dari tabel yang ada
Anda dapat menambahkan kolom JSONB
dan menghapusnya menggunakan pernyataan ALTER
sebagai berikut:
ALTER TABLE Venues ADD COLUMN VenueDetails JSONB;
ALTER TABLE Venues DROP COLUMN VenueDetails;
Contoh berikut menunjukkan cara menambahkan kolom JSONB
bernama VenueDetails
ke
tabel Venues
menggunakan library klien Spanner.
C++
C#
Go
Java
Node.js
PHP
Python
Ruby
Mengubah data JSONB
Anda dapat mengubah kolom JSONB
seperti kolom lainnya.
Berikut contohnya:
UPDATE Venues SET VenueFeatures = '{"rating": 4.5, "tags":["multi-cuisine", "open-seating"] }'
WHERE VenueId = 1;
Contoh berikut menunjukkan cara mengupdate data JSONB
menggunakan
library klien Spanner.
C++
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Untuk melakukan autentikasi ke Spanner, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
C#
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Untuk melakukan autentikasi ke Spanner, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Go
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Untuk melakukan autentikasi ke Spanner, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Untuk melakukan autentikasi ke Spanner, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Untuk melakukan autentikasi ke Spanner, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
PHP
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Untuk melakukan autentikasi ke Spanner, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Untuk melakukan autentikasi ke Spanner, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Ruby
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Untuk melakukan autentikasi ke Spanner, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Mengindeks data JSON
Anda dapat mempercepat kueri data JSONB dengan menggunakan indeks sekunder dan indeks penelusuran dengan data JSONB. Spanner tidak mendukung penggunaan kolom jenis JSONB sebagai kunci dalam indeks sekunder.
Menggunakan indeks sekunder
Indeks sekunder berguna saat memfilter nilai skalar dalam dokumen JSONB. Untuk menggunakan indeks sekunder dengan JSONB, buat kolom yang dihasilkan yang mengekstrak data skalar yang relevan dan mentransmisikannya ke jenis data SQL yang sesuai. Kemudian, Anda dapat membuat indeks sekunder pada kolom yang dihasilkan ini. Indeks mempercepat kueri yang memenuhi syarat yang dijalankan terhadap kolom yang dihasilkan.
Dalam contoh berikut, Anda membuat indeks VenuesByCapacity
yang digunakan database untuk menemukan tempat dengan kapasitas lebih dari 1.000. Daripada
memeriksa setiap baris, Spanner menggunakan indeks untuk menemukan baris yang relevan, yang meningkatkan performa kueri, terutama untuk tabel besar.
ALTER TABLE Venues (
ADD COLUMN VenueCapacity BIGINT GENERATED ALWAYS AS ((VenueFeatures->>'capacity')::BIGINT) VIRTUAL,
DateOpened TIMESTAMPTZ
);
CREATE INDEX VenuesByCapacity ON Venues(VenueCapacity);
SELECT VenueName
FROM Venues
WHERE VenueCapacity > 1000;
Menggunakan indeks penelusuran
Indeks penelusuran berguna saat Anda membuat kueri terhadap dokumen JSONB yang bersifat dinamis atau bervariasi. Tidak seperti indeks sekunder, Anda dapat membuat indeks penelusuran pada dokumen JSONB apa pun yang disimpan dalam kolom JSONB. Indeks penelusuran otomatis beradaptasi dengan variasi di seluruh dokumen JSON, di antara baris yang berbeda, dan dari waktu ke waktu.
Dalam contoh berikut, Anda membuat indeks penelusuran VenuesByVenueDetails
yang
digunakan database untuk menemukan tempat dengan detail tertentu seperti ukuran dan
jadwal operasional. Daripada memeriksa setiap baris, Spanner menggunakan
indeks untuk menemukan baris yang relevan, yang meningkatkan performa kueri,
terutama untuk tabel besar.
ALTER TABLE Venues
ADD COLUMN VenueDetails_Tokens spanner.tokenlist
GENERATED ALWAYS AS (spanner.tokenize_jsonb(VenueDetails)) VIRTUAL HIDDEN;
CREATE SEARCH INDEX VenuesByVenueDetails
ON Venues (VenueDetails_Tokens);
SELECT VenueName
FROM Venues
WHERE VenueDetails @> '{"labels": ["large"], "open": {"Friday": true}}'::jsonb;
Untuk mengetahui informasi selengkapnya, lihat Indeks penelusuran JSON.
Membuat kueri data JSONB
Anda dapat membuat kueri kolom JSONB
berdasarkan nilai kolom pokok. Contoh
berikut mengekstrak VenueId
dan VenueName
dari Venues
dengan
VenueFeatures
memiliki nilai rating
yang lebih besar dari 3.5
.
SELECT VenueId, VenueName
FROM Venues
WHERE (VenueFeatures->>'rating')::FLOAT8 > 3.5;
Contoh berikut menunjukkan cara membuat kueri data JSONB
menggunakan
library klien Spanner.
C++
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Untuk melakukan autentikasi ke Spanner, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
C#
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Untuk melakukan autentikasi ke Spanner, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Go
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Untuk melakukan autentikasi ke Spanner, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Untuk melakukan autentikasi ke Spanner, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Untuk melakukan autentikasi ke Spanner, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
PHP
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Untuk melakukan autentikasi ke Spanner, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Untuk melakukan autentikasi ke Spanner, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Ruby
Untuk mempelajari cara menginstal dan menggunakan library klien untuk Spanner, lihat library klien Spanner.
Untuk melakukan autentikasi ke Spanner, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Fitur JSONB PostgreSQL yang tidak didukung
Fitur PostgreSQL JSONB
open source berikut tidak didukung di
Spanner JSONB
:
- Pengurutan, perbandingan, dan agregasi
- PrimaryKey dan ForeignKey
- Pengindeksan, termasuk indeks GIN. Sebagai gantinya, Anda dapat menggunakan indeks penelusuran Spanner, yang mempercepat operasi JSONB yang sama seperti indeks GIN. Untuk mengetahui informasi selengkapnya, lihat Mengindeks data JSON.
- Mengubah kolom
JSONB
ke atau dari jenis data lainnya - Menggunakan kueri berparameter dengan parameter JSONB yang tidak diketik dalam alat yang menggunakan protokol wire PostgreSQL
Menggunakan paksaan dalam mesin kueri. Tidak seperti PostgreSQL open source, konversi implisit dari
JSONB
ke teks tidak didukung. Anda harus menggunakan casting eksplisit dari jenisJSONB
agar sesuai dengan tanda tangan fungsi. Contoh:SELECT concat('abc'::text, '{"key1":1}'::jsonb); -- Returns error SELECT concat('abc'::text, CAST('{"key1":1}'::jsonb AS TEXT)); -- This works SELECT 3 + CAST('5'::jsonb AS INTEGER); -- This works