Object types are the primary components of an EdgeDB schema. They are analogous to SQL tables or ORM models, and consist of properties and links.
Properties are used to attach primitive data to an object type. They are
declared with the property
keyword. For the full documentation on
properties, see Properties.
type Person {
property email -> str;
}
Links are used to define relationships between object types. Prior to EdgeDB
3.0, they must be declared with the link
keyword, but the keyword is not
required in 3.0+ unless the link is computed (e.g., backlinks). For the full
documentation on links, see Links.
type Person {
link best_friend -> Person;
}
There’s no need to manually declare a primary key on your object types. All
object types automatically contain a property id
of type UUID
that’s
required, globally unique, and readonly. This id
is assigned upon
creation and never changes.
Object types can either be abstract or non-abstract. By default all object types are non-abstract. You can’t create or store instances of abstract types, but they’re a useful way to share functionality and structure among other object types.
abstract type HasName {
property first_name -> str;
property last_name -> str;
}
Abstract types are commonly used in tandem with inheritance.
Object types can extend other object types. The extending type (AKA the subtype) inherits all links, properties, indexes, constraints, etc. from its supertypes.
abstract type Animal {
property species -> str;
}
type Dog extending Animal {
property breed -> str;
}
Object types can extend more than one type — that’s called multiple inheritance. This mechanism allows building complex object types out of combinations of more basic types.
abstract type HasName {
property first_name -> str;
property last_name -> str;
}
abstract type HasEmail {
property email -> str;
}
type Person extending HasName, HasEmail {
property profession -> str;
}
If multiple supertypes share links or properties, those properties must be of the same type and cardinality.
Refer to the dedicated pages on Indexes, Constraints, Object-Level Security, and Annotations for documentation on these concepts.