тип VARIANT

Применяется для: Databricks SQL Databricks Runtime 15.3 и выше

Представляет полуструктурированные данные.

Синтаксис

VARIANT

Ограничения

Тип поддерживает хранение любых полуструктурированных данных, включая скалярные STRUCTARRAYтипы, а также MAPскалярные типы. VARIANT может хранить MAP только типы с ключами типа STRING.

Литералы

Дополнительные сведения о создании VARIANT значения смparse_json. в функции-функции. Вы также можете использовать функцию CAST для преобразования литерала определенного типа VARIANTв .

Примечания.

• Извлечение значения из VARIANT можно использовать
  • variant_get функция с помощью выражения пути JSON для перехода к сложному типу.
  • : Оператор (знак двоеточия) для синтаксического анализа VARIANT с помощью выражения пути JSON.
  • try_variant_get функция с помощью пути JSON для перехода к сложному типу с допуском ошибок.
  • cast оператор функции или :: (знак двоеточия) для приведения VARIANT объекта к конкретному типу.
  • try_cast функция для приведения VARIANT типа к определенному типу с допуском ошибок.
• Чтобы проверить тип VARIANT значения, используйте
  • schema_of_variant функция для отдельного значения.
  • schema_of_variant_agg агрегатная функция для коллекции значений.

Примеры

> SELECT parse_json('{"key": 123, "data": [4, 5, "str"]}');
  {"data":[4,5,"str"],"key":123}

> SELECT parse_json(null);
  null

> SELECT parse_json('123');
  123

> SELECT CAST(123.456 AS VARIANT);
  123.456

Связанные

• Оператор :: (знак двойного двоеточия)
• cast функция
• parse_json функция
• schema_of_variant функция
• schema_of_variant_agg агрегатная функция
• try_cast функция
• try_variant_get функция
• variant_get функция