apoc.create.vNode

This is both a function and a procedure.

Function Details

Details
Syntax	`apoc.create.vNode(labels [, props ])`
Description	Returns a virtual `NODE`.
Arguments	Name	Type	Description
	`labels`	`LIST<STRING>`	The list of labels to assign to the virtual node.
	`props`	`MAP`	The map of properties to assign to the virtual node. The default is: `{}`.
Returns	`NODE`

Procedure Details

Details
Syntax	`apoc.create.vNode(labels, props) :: (node)`
Description	Returns a virtual `NODE`.
Input arguments	Name	Type	Description
	`labels`	`LIST<STRING>`	The labels to assign to the new virtual node.
	`props`	`MAP`	The properties to assign to the new virtual node.
Return arguments	Name	Type	Description
Return arguments	`node`	`NODE`	The created virtual node.

Usage Examples

The examples in this section are based on the following graph:

CREATE (s:Student {name: 'Alice', score: 71});
CREATE (s:Student {name: 'Mark', score: 95});
CREATE (s:Student {name: 'Andrea', score: 86});
CREATE (s:Student {name: 'Rajesh', score: 89});
CREATE (s:Student {name: 'Jennifer', score: 96});
CREATE (s:Student {name: 'Katarina', score: 80});

The apoc.create.vNode offers both a procedure and function version, so that we can create the virtual nodes independently or return them based on results of a query.

For instance, we might want to create virtual nodes for just the scores, so that researchers could retrieve the score, but not student data:

apoc.create.vNode Procedure

MATCH (s:Student)
CALL apoc.create.vNode(['Score'],{value: s.score}) YIELD node
RETURN node;

Results
node
{"value":71}
{"value":95}
{"value":86}
{"value":89}
{"value":96}
{"value":80}

We could also create a virtual graph adhoc that separates students from their scores. This allows testing or querying the data in an alternate data model than what physically exists in the database.

apoc.create.vNode Function

MATCH (s:Student)
RETURN apoc.create.vNode(['Student'],{name: s.name}) as student,
       apoc.create.vNode(['Score'],{value: s.score}) as score;

Results
student	score
{"name":"Alice"}	{"value":71}
{"name":"Mark"}	{"value":95}
{"name":"Andrea"}	{"value":86}
{"name":"Rajesh"}	{"value":89}
{"name":"Jennifer"}	{"value":96}
{"name":"Katarina"}	{"value":80}