Find Nodes

Overview

The clause find().nodes() retrieves nodes from the graphset that meet specified conditions.

Syntax

Clause alias: NODE type; default alias is nodes

Examples

Example Graph

Run these UQLs row by row in an empty graphset to create this graph:

UQL
create().node_schema("professor").node_schema("student").edge_schema("mentor").edge_schema("assist")
create().node_property(@*, "age", int32).node_property(@*, "email", string).edge_property(@*, "year", int32)
Click to expand

Find All Nodes

UQL
find().nodes() as n
return n{*}

Result:

Find Nodes by ID

UQL
find().nodes({_id == "S001"}) as n
return n{*}

Result:

UQL
find().nodes({_id in ["P001", "P002"]}) as n
return n{*}

Result:

Find Nodes by UUID

UQL
find().nodes(1) as n
return n{*}

NOTE

The filter {_uuid == 1} can be simplified to 1.

Result:

UQL
find().nodes([1,3]) as n
return n{*}

NOTE

The filter {_uuid in [1,3]} can be simplified to [1,3].

Result:

Find Nodes by Schema

UQL
find().nodes({@student}) as n
return n{*}

Result:

UQL
find().nodes({@student || @professor}) as n
return n{*}

Result:

Find Nodes by Property

UQL
find().nodes({age > 30}) as n
return n{*}

Result:

Find Nodes by Schema and Property

UQL
find().nodes({@student.age > 25}) as n
return n{*}

Result:

Use Default Clause Alias

UQL
find().nodes().limit(1)
return nodes{*}

Result:

Use limit()

UQL
find().nodes().limit(3) as n
return n{*}

Result:

Use OPTIONAL

UQL
uncollect [53, 55, 57] as value
optional find().nodes({age == value}) as n
return n{*}

Result:

If the prefix OPTIONAL is not used, null results will not be returned.