Find Edges

Overview

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

Syntax

Clause alias: EDGE type; default alias is edges

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 Edges

UQL
find().edges() as e
return e{*}

Result:

Find Edges by UUID

UQL
find().edges(1) as e
return e{*}

NOTE

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

Result:

UQL
find().edges([1,3]) as e
return e{*}

NOTE

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

Result:

Find Edges by Start Nodes

UQL
find().edges({_from == "P001"}) as e
return e{*}

Result:

Find Edges by End Nodes

UQL
find().edges({_to == "P001"}) as e
return e{*}

Result:

Find Edges by Schema

UQL
find().edges({@assist}) as e
return e{*}

Result:

UQL
find().edges({@assist || @mentor}) as e
return e{*}

Result:

Find Edges by Property

UQL
find().edges({year == 2020}) as e
return e{*}

Result:

Find Edges by Schema and Property

UQL
find().edges({@assist.year == 2020}) as e
return e{*}

Result:

Use Default Clause Alias

UQL
find().edges().limit(3)
return edges{*}

Result:

Use limit()

UQL
find().edges().limit(3) as e
return e{*}

Result:

Use OPTIONAL

UQL
uncollect [2022, 2023, 2024] as value
optional find().edges({year == value}) as e
return e{*}

Result:

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