OBJECT_ID_FROM_NODE_ID (Transact-SQL)

Применимо к: SQL Server 2017 (14.x) и более поздних версий базы данных SQLAzure Для Управляемого экземпляра SQL Azureв Microsoft Fabric

Возвращает идентификатор объекта для заданного идентификатора узла графа.

Синтаксис

OBJECT_ID_FROM_NODE_ID ( node_id )

Аргументы

node_id

Символьное представление (JSON) для одного из следующих элементов:

• Псевдостолбец $node_id для таблицы узлов.
• Псевдостолбец $from_id для граничной таблицы.
• Столбец $to_id для граничной таблицы.

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

Возвращает графовую таблицу object_id, соответствующую предоставленному node_id. object_id представляет собой значение int. Если указано недопустимое значение node_id, возвращается значение NULL.

Замечания

• Из-за затрат на обеспечение производительности при анализе и проверке предоставленного символьного представления (JSON) узлов следует использовать OBJECT_ID_FROM_NODE_ID только в случае необходимости. В большинстве случаев команды MATCH должно быть достаточно для запросов к таблицам графов.
• Чтобы OBJECT_ID_FROM_NODE_ID возвращала значение, предоставленное символьное представление (JSON) идентификатора узла должно быть допустимым, а именованный schema.table в файле JSON должен быть допустимой таблицей узлов. Идентификатор графа в символьном представлении (JSON) не должен существовать в таблице узлов. Это может быть любое допустимое целое число.
• OBJECT_ID_FROM_NODE_ID — единственный поддерживаемый способ анализа символьного представления (JSON) идентификатора узла.

Примеры

В следующем примере возвращаются object_id для всех узлов $from_id в граничной графовой таблице likes. В примере графовой базы данных SQL мы используем только значения $node_id из таблицы Person в качестве соответствующих значений $from_id в likes. Поэтому возвращаемые значения являются постоянными и равными object_id таблицы Person (в этом примере — 1525580473).

SELECT OBJECT_ID_FROM_NODE_ID($from_id)
FROM likes;

Результаты приведены ниже.

...
1525580473
1525580473
1525580473
...

См. также

• Архитектура SQL Graph
• Пример базы данных SQL Graph
• GRAPH_ID_FROM_NODE_ID
• NODE_ID_FROM_PARTS