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 JSONB
Spanner menyimpan representasi normal dari dokumen input. 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 secara persis. - 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 ke fungsi
to_jsonb
hanya dapat berasal dari jenis data PostgreSQL yang didukung Spanner. - Nilai jenis angka dapat memiliki 4.932 digit sebelum titik desimal dan 16.383 digit setelah titik desimal.
- Ukuran maksimum yang diizinkan untuk format penyimpanan yang dinormalisasi adalah 10 MB.
- Dokumen
JSONB
harus dienkode dalam UTF-8. Transaksi atau kueri dengan dokumenJSONB
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
);
Contoh objek VenueFeatures
JSONB
berikut:
{
"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 meletakkannya 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 adalah contohnya:
UPDATE Venues SET VenueFeatures = '{"rating": 4.5, "tags":["multi-cuisine", "open-seating"] }'
WHERE VenueId = 1;
Contoh berikut menunjukkan cara memperbarui 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 Anda. Spanner tidak mendukung penggunaan kolom jenis JSONB sebagai kunci dalam indeks sekunder.
Menggunakan indeks sekunder
Indeks sekunder berguna saat memfilter berdasarkan 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 berjalan pada kolom yang dihasilkan.
Dalam contoh berikut, Anda membuat indeks VenuesByCapacity
yang digunakan database untuk menemukan tempat dengan kapasitas lebih dari 1.000. Sebagai gantinya, 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(TotalCapacity);
SELECT VenueName
FROM Venues
WHERE VenueCapacity > 1000;
Menggunakan indeks penelusuran
Indeks penelusuran berguna saat Anda membuat kueri terhadap dokumen JSONB yang bersifat dinamis atau beragam. Tidak seperti indeks sekunder, Anda dapat membuat indeks penelusuran di dokumen JSONB apa pun yang disimpan di kolom JSONB. Indeks penelusuran secara otomatis menyesuaikan 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 operasi. Sebagai ganti 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 JSONB
PostgreSQL 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 tanpa jenis di alat yang menggunakan protokol wire PostgreSQL
Menggunakan pemaksaan di mesin kueri. Tidak seperti PostgreSQL open source, pemaksaan implisit dari
JSONB
ke teks tidak didukung. Anda harus menggunakan transmisi eksplisit dari jenisJSONB
untuk mencocokkan 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