тип OBJECT

Область применения: Databricks Runtime 15.3 и выше

Представляет значения в VARIANT со структурой, описанной набором полей.

См. инструкции STRUCT по хранению и обработке структурированных типов, описанных последовательностью полей.

Синтаксис

OBJECT < [fieldName [:] fieldType [, ...] ] >

• fieldName: идентификатор, именующий поле. Имена должны быть уникальными.
• fieldType: любой тип данных.

Ограничения

Этот тип поддерживает любое число полей, от 0 и более.

Литералы

Нельзя создать значения OBJECT за пределами VARIANT. Они являются результатом анализа строки JSON в VARIANT с использованием функции parse_json().

Примечания.

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

Примеры

> SELECT schema_of_variant(parse_json('{"key": 123, "data": 5.1 }'));
  OBJECT<data: DECIMAL(2,1), key: BIGINT>

-- Casting from a an OBJECT to a STRUCT is by name, because OBJECT fields are not ordered.
> SELECT CAST(parse_json('{"key": 123, "data": 5.1 }') AS STRUCT<data: DECIMAL(2,1), key: BIGINT>);
  {"data":5.1,"key":123}

> SELECT CAST(parse_json('{"key": 123, "data": 5.1 }') AS STRUCT<key: BIGINT, data: DECIMAL(2,1)>);
  {"key":123, "data":5.1}

> SELECT CAST(parse_json('{"key": 123, "data": 5.1 }') AS MAP<STRING, DECIMAL(20, 1)>);
  {"data":"5.1","key":"123.0"}

Связанные элементы

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