Bagikan melalui

Jenis data JSON

Berlaku untuk: Pratinjau SQL Server 2025 (17.x) Azure SQL DatabaseAzure SQL Managed InstanceSQL database di Microsoft Fabric

Jenis data json asli yang menyimpan dokumen JSON dalam format biner asli.

Jenis json menyediakan penyimpanan keakuratan tinggi dokumen JSON yang dioptimalkan untuk kueri dan manipulasi yang mudah, dan memberikan manfaat berikut daripada menyimpan data JSON dalam varchar atau nvarchar:

  • Bacaan yang lebih efisien, karena dokumen sudah diurai
  • Penulisan yang lebih efisien, karena kueri dapat memperbarui nilai individual tanpa mengakses seluruh dokumen
  • Penyimpanan yang lebih efisien, dioptimalkan untuk pemadatan
  • Tidak ada perubahan kompatibilitas dengan kode yang ada

Jenis json secara internal menyimpan data menggunakan pengodean UTF-8, Latin1_General_100_BIN2_UTF8. Perilaku ini cocok dengan spesifikasi JSON.

Untuk informasi selengkapnya tentang mengkueri data JSON, lihat data JSON di SQL Server.

Sintaksis sampel

Sintaks penggunaan untuk jenis json mirip dengan semua jenis data SQL Server lainnya dalam tabel.

column_name JSON [NOT NULL | NULL] [CHECK(constraint_expression)] [DEFAULT(default_expression)]

Jenis json dapat digunakan dalam definisi kolom yang CREATE TABLE terkandung dalam pernyataan, misalnya:

CREATE TABLE Orders (order_id int, order_details JSON NOT NULL);

Batasan dapat ditentukan sebagai bagian dari definisi kolom, misalnya:

CREATE TABLE Orders (order_id int, order_details JSON NOT NULL
   CHECK (JSON_PATH_EXISTS(order_details, '$.basket') = 1)
);

Ketersediaan fitur

Dukungan fungsi JSON pertama kali diperkenalkan di SQL Server 2016 (13.x). Jenis json asli diperkenalkan pada tahun 2024 di Azure SQL Database dan Azure SQL Managed Instance.

json tersedia di bawah semua tingkat kompatibilitas database.

Catatan

Jenis data JSON:

  • umumnya tersedia untuk Azure SQL Database dan Azure SQL Managed Instance yang dikonfigurasi dengan kebijakan pembaruan always-up-to-date.
  • sedang dalam pratinjau untuk Pratinjau SQL Server 2025 (17.x).

ubah metode

Catatan

modify metode saat ini dalam pratinjau dan hanya tersedia di Pratinjau SQL Server 2025 (17.x).

Jenis json asli mendukung modify metode . Gunakan modify untuk mengubah dokumen JSON yang disimpan dalam kolom. Metode ini modify memiliki pengoptimalan untuk melakukan modifikasi di tempat pada data jika memungkinkan, dan merupakan cara yang lebih disukai untuk memodifikasi dokumen JSON dalam kolom jenis json .

Untuk string JSON, jika nilai baru kurang dari atau sama dengan nilai yang ada, modifikasi di tempat dimungkinkan.

Untuk angka JSON, jika nilai baru memiliki jenis yang sama, atau dalam rentang nilai yang ada, modifikasi di tempat dimungkinkan.

DROP TABLE IF EXISTS JsonTable;
CREATE TABLE JsonTable ( id int PRIMARY KEY, d JSON );
INSERT INTO JsonTable (id, d) VALUES(1, '{"a":1, "b":"abc", "c":true}');
UPDATE JsonTable
SET d.modify('$.a', 14859)
WHERE id = 1;
UPDATE JsonTable
SET d.modify('$.b', 'def')
WHERE id = 1;

Dukungan fungsi

Semua fungsi JSON mendukung jenis json tanpa perubahan kode atau perbedaan penggunaan yang diperlukan.

  • OPENJSON saat ini tidak mendukung jenis data json di beberapa platform. Untuk informasi selengkapnya, lihat Batasan.

Untuk daftar lengkap fungsi JSON, lihat Fungsi JSON.

Indeks

Tidak ada jenis indeks khusus untuk data JSON.

Jenis json tidak dapat digunakan sebagai kolom kunci dalam CREATE INDEX pernyataan. Namun, kolom json dapat ditentukan sebagai kolom yang disertakan dalam definisi indeks. Selain itu, kolom json dapat muncul dalam klausa indeks yang difilter WHERE .

Konversi

Konversi eksplisit menggunakan CAST atau CONVERT dari jenis json dapat dilakukan ke jenis char, nchar, varchar, dan nvarchar . Semua konversi implisit tidak diizinkan, mirip dengan perilaku xml. Demikian pula, hanya char, nchar, varchar, dan nvarchar yang dapat dikonversi secara eksplisit ke jenis json .

Jenis json tidak dapat digunakan dengan jenis sql_variant atau ditetapkan ke variabel atau kolom sql_variant . Pembatasan ini mirip dengan varchar(max), varbinary(max), nvarchar(max), xml, dan jenis data berbasis CLR.

Anda dapat mengonversi kolom yang ada, seperti kolom varchar(maks) menjadi json menggunakan . Mirip dengan jenis data xml , Anda tidak dapat mengonversi kolom json ke salah satu string atau jenis biner menggunakan .

Untuk informasi selengkapnya, lihat Konversi jenis data.

Kompatibilitas

Jenis json dapat digunakan sebagai parameter atau jenis pengembalian dalam fungsi yang ditentukan pengguna, atau parameter prosedur tersimpan. Jenis json kompatibel dengan pemicu dan tampilan.

Saat ini, format asli alat bcp berisi dokumen json sebagai varchar atau nvarchar. Anda harus menentukan file format untuk menunjuk kolom tipe data json .

Pembuatan jenis alias yang menggunakan CREATE TYPE untuk jenis json tidak diizinkan. Ini adalah perilaku yang sama dengan jenis xml .

Menggunakan SELECT ... INTO dengan jenis JSON membuat tabel dengan jenis JSON.

Batasan

  • Perilaku mengembalikan jenis CAST ( ... AS JSON), tetapi prosedur tersimpan sistem sp_describe_first_result_set tidak mengembalikan jenis data json dengan benar. Oleh karena itu, banyak klien dan driver akses data akan melihat jenis data varchar atau nvarchar .
    • Saat ini, TDS = 7,4 (dengan UTF-8) melihat varchar(maks) dengan .
    • Saat ini, TDS < 7.4 melihat nvarchar(max) dengan kolate database.
  • Saat ini, OPENJSON() fungsi tidak menerima jenis json di beberapa platform. Saat ini, ini adalah konversi implisit. Konversikan secara eksplisit ke nvarchar(maks) terlebih dahulu.

Konten terkait