EXPLODE_JSON_ARRAY_INT_OUTER

Описание

Табличная функция explode_json_array_int_outer принимает массив JSON. При выполнении функции массив JSON преобразуется в тип массива, после чего для обработки вызывается функция explode_outer. Поведение эквивалентно: explode_outer(cast(<json_array> as Array<BIGINT>)). Её следует использовать совместно с LATERAL VIEW.

Синтаксис

EXPLODE_JSON_ARRAY_INT_OUTER(<json>)

Параметры

• <json> имеет тип JSON и должен содержать массив.

Возвращаемое значение

• Возвращает все элементы из <json> в виде результата с одним столбцом и несколькими строками. Тип столбца: Nullable<BIGINT>.
• Если <json> имеет значение NULL или является пустым массивом (число элементов равно 0), возвращается одна строка со значением NULL.
• Если элементы массива JSON имеют тип, отличный от INT, функция пытается преобразовать их в INT. Элементы, которые невозможно преобразовать в INT, преобразуются в NULL. Правила преобразования типов описаны в разделе Преобразование типа JSON.

Примеры

0. Подготовка данных

   create table example(
       k1 int
   ) properties(
       "replication_num" = "1"
   );
   
   insert into example values(1);
1. Обычные параметры

   select * from example lateral view explode_json_array_int_outer('[4, 5, 5.23, null]') t2 as c;

   +------+------+
   | k1   | c    |
   +------+------+
   |    1 |    4 |
   |    1 |    5 |
   |    1 |    5 |
   |    1 | NULL |
   +------+------+
2. Тип, отличный от INT

   select * from example 
       lateral view 
       explode_json_array_int_outer('["abc", "123.4", 9223372036854775808.0, 9223372036854775295.999999]') t2 as c;

   +------+---------------------+
   | k1   | c                   |
   +------+---------------------+
   |    1 |                NULL |
   |    1 |                 123 |
   |    1 |                NULL |
   |    1 | 9223372036854774784 |
   +------+---------------------+

   9223372036854775808.0 выходит за допустимый диапазон BIGINT, поэтому преобразуется в NULL. Строка "123.4" преобразуется в 123. Строку "abc" невозможно преобразовать в INT, поэтому результатом будет NULL.

3. Пустой массив

   select * from example lateral view explode_json_array_int_outer('[]') t2 as c;

   +------+------+
   | k1   | c    |
   +------+------+
   |    1 | NULL |
   +------+------+
4. Параметр NULL

   select * from example lateral view explode_json_array_int_outer(NULL) t2 as c;

   +------+------+
   | k1   | c    |
   +------+------+
   |    1 | NULL |
   +------+------+
5. Параметр, не являющийся массивом

   select * from example lateral view explode_json_array_int_outer('{}') t2 as c;

   +------+------+
   | k1   | c    |
   +------+------+
   |    1 | NULL |
   +------+------+