Инструмент Развернуть поле возвращает значения, хранящиеся в поле массива, карты, или структуры, как новые поля или строки.
Примеры
Инструмент Развернуть поле можно использовать в таких следующих сценариях:
- Разбить массивы значений на новые строки
- Вернуть вложенные свойства из поля структуры или карты в виде новых полей
Параметры
В следующей таблице приведены параметры, используемые в инструменте Развернуть поле:
| Параметр | Описание |
|---|---|
Входной набор данных | Набор данных, содержащий массив, структуру или поле карты, которые необходимо развернуть. |
Развернуть поле | Массив, структура или поле карты, которые будут развернуты. |
Выходное имя поля | Имя поля, в котором будут содержаться значения развернутого массива. Этот параметр является дополнительным и доступен только в том случае, если разворачиваемое поле имеет тип массив. |
Имя выходного ключевого поля | Имя поля, в котором будут содержаться ключи развернутой карты. Этот параметр является дополнительным и доступен только в том случае, если разворачиваемое поле имеет тип карта. |
Имя поля выходных значений | Имя поля, в котором будут содержаться значения развернутой карты. Этот параметр является дополнительным и доступен только в том случае, если разворачиваемое поле имеет тип карта. |
Примечания по использованию
Используйте параметр Входной набор данных, чтобы выбрать набор данных, содержащий поле, которые вы хотите развернуть.
Используйте параметр Развернуть поле, чтобы указать поле массива, карты или структуры, которое необходимо развернуть. В результате будут созданы новые строки и поля, содержащие значения из указанного поля.
Имя выходного поля является дополнительным и доступно только в том случае, если разворачиваемое поле имеет тип массив. Используйте этот параметр для переименования итогового поля, содержащего развернутые значения. По умолчанию выходное поле будет называться так же, как и входное поле, которое нужно развернуть.
Имя выходного ключевого поля и Имя поля выходных значений доступны дополнительно, если поле, которое нужно развернуть, имеет тип карта. Используйте этот параметр для переименования итогового поля, содержащего развернутые ключи и значения. По умолчанию выходные поля будут называться так же, как и входное поле с присоединенным "_KEY" или "_VALUE".
Поля структуры будут развернуты в новые поля с именами, основанными на свойствах структуры.
Выходные данные
Выходными данными инструмента является входной набор данных, содержащий новые строки или поля из развернутого поля. Ниже описано, как каждый поддерживаемый тип поля может быть развернут:
- Массив — значения полей массива будут возвращены в поле, содержащее строку для каждого значения в массиве. Ниже приведен пример того, как входное поле массива будет развернуто:
- Карта — значения полей карты будут возвращены в двух новых полях, представляющих ключи и значения на карте. Поля будут содержать ключи и значения, соответственно. Ниже приведен пример того, как входное поле карты будет развернуто:
- Структура — поля структуры будут возвращены в виде новых полей для каждого свойства в структуре. Поля будут содержать значения для каждого свойства. Ниже приведен пример того, как входное поле структуры будет развернуто:
Ограничения
Инструмент разрешает только один уровень вложения. Например, если входным полем является массив структур, то на выходе будут новые строки, содержащие структуры. Чтобы развернуть структуры, необходимо настроить другой инструмент разворачивания.
Лицензионные требования
Требуется следующее лицензии и конфигурации:
- Тип пользователя Creator или Professional
- Роль Издатель, Посредник или Администратор, или эквивалентная пользовательская роль
Подробнее о системных требованиях Data Pipelines см. раздел Требования