Поделиться через

Тип данных JSON (предварительная версия)

  • Статья

Применимо к: База данных SQL Azure Управляемый экземпляр SQL Azure

Новый собственный тип данных JSON , в который хранятся документы JSON в собственном двоичном формате.

Тип json предоставляет высокодокументное хранилище документов JSON, оптимизированных для простых запросов и манипуляций, и обеспечивает следующие преимущества при хранении данных JSON в varchar или nvarchar:

  • Более эффективные операции чтения, так как документ уже анализируется
  • Более эффективные операции записи, так как запрос может обновлять отдельные значения без доступа ко всему документу
  • Более эффективное хранилище, оптимизированное для сжатия
  • Отсутствие изменений в совместимости с существующим кодом

Тип json внутренне сохраняет данные с помощью кодировки UTF-8. Latin1_General_100_BIN2_UTF8 Это поведение соответствует спецификации JSON.

Дополнительные сведения о запросе данных JSON см. в статье JSON data in SQL Server.

Пример синтаксиса

Синтаксис использования для типа 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 году на платформах SQL Azure.

json доступен на всех уровнях совместимости базы данных.

Примечание.

Тип данных JSON в настоящее время находится в предварительной версии для База данных SQL Azure и Управляемый экземпляр SQL Azure (настроен с помощью политики обновления always-up-up).

Поддержка функций

Все функции JSON поддерживают тип JSON без изменений кода или разницы в использовании.

Полный список функций JSON см. в разделе "Функции JSON".

Индексы

Для данных JSON нет специальных типов индексов.

Тип json нельзя использовать в качестве ключевого столбца в инструкции CREATE INDEX . Однако столбец json можно указать как включенный столбец в определении индекса. Кроме того, столбец JSON может отображаться в WHERE предложении отфильтрованного индекса.

Преобразование

Явное преобразование с помощью или из типа JSON можно выполнить для типов char, nchar, varchar и nvarchar.CONVERT CAST Все неявные преобразования не допускаются, аналогично поведению xml. Аналогичным образом можно явно преобразовать только char, nchar, varchar и nvarchar в тип json.

Тип json нельзя использовать с типом sql_variant или назначить sql_variant переменной или столбцу. Это ограничение похоже на varchar(max), varbinary(max), nvarchar(max), xml и типы данных на основе СРЕДЫ CLR.

Дополнительные сведения см. в разделе "Преобразование типов данных".

Совместимость

Тип json можно использовать в качестве параметра или возвращаемого типа в определяемой пользователем функции или параметр хранимой процедуры. Тип json совместим с триггерами и представлениями.

В настоящее время собственный формат средства bcp содержит документ JSON в виде varchar или nvarchar. Необходимо указать файл формата, чтобы назначить столбец типа данных JSON .

Создание типа псевдонима, используемого CREATE TYPE для типа JSON , запрещено. Это то же поведение, что и тип XML .

Использование SELECT ... INTO с типом JSON создаст таблицу с типом JSON.

Ограничения

  • Поведение возвращает тип json, но sp_describe_first_result_set системная хранимая процедура не возвращает тип данных JSON.CAST ( ... AS JSON) Таким образом, многие клиенты и драйвер доступа к данным увидят тип данных varchar или nvarchar .

    • В настоящее время TDS >= 7.4 (с поддержкой UTF-8) будет видеть varchar(max) с Latin_General_100_bin2_utf8.
    • В настоящее время поддержка TDS < 7.4 будет видеть nvarchar(max) с параметрами сортировки базы данных.

  • OPENJSON() В настоящее время функция не принимает тип JSON, который в настоящее время является неявным преобразованием. Сначала явно преобразуйте в nvarchar(max).

Связанный контент