Поиск в другом наборе данных

Преобразование lookup дополняет основной набор данных значениями из другого источника. Для каждой основной записи оно ищет совпадение по ключу во втором наборе — по принципу одностороннего соединения таблиц.

// Любая спецификация представления
{
  ...,
  "transform": [
    {"lookup": ..., "from": ..., "as": ..., "default": ...},
    ...
  ],
  ...
}

Свойства преобразования

Значение поля lookup в основной записи сравнивается со значением from.key во вторичном источнике.

Свойство Тип Описание
lookup string Обязательный ключ в основном источнике данных.
from LookupData или LookupSelection Обязательный вторичный источник данных или выделение.
as FieldName или FieldName[] Выходные поля для найденных значений. При поиске в данных можно не задавать, если указан from.fields: используются эти имена. Если from.fields отсутствует, as должен быть строкой. При поиске по выделению свойство необязательно: без него значения записываются в поле с именем выделения; если задано, должно соответствовать from.fields.
default Any Значение, используемое, если совпадение не найдено. По умолчанию: null.

Поиск в наборе данных

В from задаются источник данных, его ключ и нужные поля:

Свойство from Тип Описание
data Data Обязательный вторичный источник данных для поиска.
key FieldName Обязательный ключ во вторичном источнике данных.
fields FieldName[] Поля вторичных данных или выделения для поиска. Если не заданы, извлекается весь объект.

Пример

В примере из второго набора добавляются поля age и height. Поле person основного набора сопоставляется с полем name вторичного.

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

Вместо набора данных from может ссылаться на параметр выделения:

Свойство from Тип Описание
param ParameterName Обязательное имя параметра выделения для поиска.

Интерактивный индексный график