共用方式為

JSON 資料類型 (預覽版)

  • 發行項

適用於：Azure SQL 資料庫

以原生二進位格式儲存 JSON 文件的全新原生 json 資料類型。

json 類型提供 JSON 文件的高逼真度儲存體，已針對簡易查詢和操作最佳化，而且提供儲存於 varchar 或 nvarchar 之 JSON 資料沒有的下列優點：

  • 更有效率的讀取，因為已將文件剖析
  • 更有效率的寫入，因為查詢可以更新個別值，而不需要存取整份文件
  • 更有效率的儲存體，已針對壓縮進行最佳化
  • 與現有程式碼的相容性沒有變更

json 類型使用 UTF-8 編碼在內部儲存資料，Latin1_General_100_BIN2_UTF8。 此行為符合 JSON 規格。

如需查詢 JSON 資料的詳細資訊，請參閱在 SQL Server 中使用 JSON 資料。

範例語法

json 類型的使用語法類似於資料表中所有其他 SQL Server 資料類型。

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

json 類型可用於 CREATE TABLE 陳述式中包含的資料欄定義，例如：

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

條件約束可指定為資料行定義的一部分，例如：

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

功能可用性

JSON 支援最初是在 SQL Server 2016 (13.x) 中引進的，其中大部分是以 JSON 函數的形式。 新的原生 json 類型於 2024 年引進，最早出現於 Azure SQL 平台。

json 適用於所有資料庫相容性層級。

注意

目前，json 類型可在 Azure SQL 資料庫預覽。

函數支援

所有 JSON 函數都支援 json 類型，且無需變更程式碼，使用方式也沒有差異。

如需 JSON 函數的完整清單，請參閱 JSON 函數。

索引數

JSON 資料沒有特殊的索引類型。

json 類型不能當做 CREATE INDEX 陳述式中的索引鍵資料行使用。 不過，json 資料行可指定為索引定義中的內含資料行。 此外，json 資料行可以出現在已篩選索引的 WHERE 子句中。

轉換

使用 CAST 或 CONVERT，實現從 json 類型明確轉換為 char、nchar、varchar 與 nvarchar 類型。 不允許所有隱含轉換，類似於 xml 的行為。 同樣地，只有 char、nchar、varchar 與 nvarchar 可以明確轉換為 json 類型。

json 類型不能搭配 sql_variant 使用，或指派至 sql_variant 變數或資料行。 這項限制類似於 varchar(max)、varbinary(max)、nvarchar(max)、xml 和 CLR 基底資料型別。

如需詳細資訊，請參閱資料類型轉換。

相容性

json 類型可當做使用者定義函數中的參數或傳回型別，或預存程序的參數。 json 類型與觸發程序和檢視相容。

目前，bcp 工具的原生格式包含 varchar 或 nvarchar 格式的 json 文件。 您必須指定格式檔案，才能指定 json 資料類型資料行。

不允許針對 json 類型使用 CREATE TYPE 建立別名資料型別。 這與 xml 類型相同。

搭配 JSON 類型使用 SELECT ... INTO，會建立 JSON 類型的資料表。

限制

  • CAST ( ... AS JSON) 的行為會傳回 json 類型，但 sp_describe_first_result_set 系統預存程序未正確傳回 json 資料類型。 因此，許多資料存取用戶端和驅動程式都可查看 varchar 或 nvarchar 資料類型。

    • 目前，TDS >= 7.4 (使用 UTF-8) 支援可查看 varchar(max) (使用 Latin_General_100_bin2_utf8)。
    • 目前，TDS < 7.4 支援可查看 nvarchar(max) (使用資料庫定序)。

  • 目前，OPENJSON() 函數不接受 json 類型，目前為隱含轉換。 首先，明確轉換為 nvarchar(max)。

相關內容