edgeLabel
How to create an edge label.
Synopsis
schema.edgeLabel('edgeLabel').
[ single() | multiple() ].
[ properties(property[, property]).[ add() | drop() ] ].
[ connection( outVertex, inVertex) ].
[ ttl ].
[ ifNotExists() ].
[ create() | add() | drop() | describe() | exists() ]
Description
An edge label specifies a type of edge that can be stored in DSE Graph. An edge label can have cardinality specified (default is multiple), properties that an edge has defined, the connections that are defined between two types of vertices, and a time-to-live (TTL) to determine the lifecycle of an edge. The order that the options are added to the schema statement matter: cardinality, properties associated with the edge label, then connection.
Examples
Create an edgeLabel
created
:schema.edgeLabel('created').create()
Create an edgeLabel
includedIn
if the edge label doesn't already
exist:schema.edgeLabel('includedIn').ifNotExists().create()
Create an edgeLabel with multiple
cardinality:
schema.edgeLabel('rated').multiple().create()
Add properties to an
edgeLabel:
schema.edgeLabel('rated').properties('rating','last_date').add()
Create an edgeLabel with both properties and a
connection:
schema.edgeLabel('rated').multiple().ifNotExists().create()
schema.edgeLabel('rated').properties('rating','last_date').add()
schema.edgeLabel('rated').connection('recipe','reviewer').add()
Create a time-to-live (TTL) for an edgeLabel of 60 seconds. Setting a TTL will expire all
edges inserted with the edgeLabel at the set TTL
value.
schema.edgeLabel('createDate').ttl(60).create()
refNote: DSE Graph sets TTL differently from the DSE database. The DSE database sets TTL per
mutation (insertion or update) or can inherit a default value from the table schema. DSE
Graph sets TTL per vertex label or edge label, and all vertices or edges will be affected
by the TTL setting. DSE Graph cannot set TTL for an individual vertex or edge.
Check if an edgeLabel exists:
schema.edgeLabel('rated').exists()
Get the schema creation command for an edgeLabel using the
describe()
command:schema.edgeLabel('createDate').describe()