relation

Назначение

Находит документы, которые содержат отношения между сущностями. Для корректной работы функции необходимо наличие родительского узла «Извлечение отношений».

Данная функция является аналогом функции fact().

Синтаксис

relation([type],[attribute],…​)

Аргументы

Первый опциональный аргумент type позволяет указать требуемый тип отношений (Partnership (Партнерство), Merger (Слияния), Investing (Инвестирование) и т.д.). Последующие опциональные аргументы позволяют указать ограничения на атрибуты отношения в формате «атрибут оператор значение». При указании ограничения на значение атрибута можно использовать следующие операторы:

  • =

  • <

  • >

  • !=

  • <=

  • >=

Если необходимо указать несколько допустимых значений, их следует перечислить через вертикальную черту: «Country=Germany|Italy».

Чтобы найти определенный атрибут отношения, а не отношение целиком, необходимо добавить в запрос именованный параметр field. Например, запрос relation(Ownership, field:=owner) возвращает атрибут Owner (Владелец) в найденных отношениях типа Ownership (Владение).

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

Документы, соответствующие запросу.

Примеры

relation() находит все отношения между сущностями

relation("Standard/Companies/Ownership") находит все отношения типа «Ownership».

relation(Investing, "amount>1000000") находит все отношения типа «Investing», для которых атрибут «Amount» больше 1000000.

relation(Investing, "Investor=Accel Partners", "Investee=Facebook Inc.") находит все отношения типа «Investing», для которых атрибут «Investor" равен «Accel Partners», а атрибут «Investee» равен «Facebook Inc.».