Introduction

Quick Summary

Schema describes the definition of one entity type in the graph, like User or Group, and can contain the following configurations:

  • Entity fields (or properties), like: name or age of a User.
  • Entity edges (or relations), like: User‘s groups, or User‘s friends.
  • Database specific options, like: indexes or unique indexes.

Here’s an example of a schema:

  1. package schema
  4. import (
  5.     "entgo.io/ent"
  6.     "entgo.io/ent/schema/field"
  7.     "entgo.io/ent/schema/edge"
  8.     "entgo.io/ent/schema/index"
  9. )
  12. type User struct {
  13.     ent.Schema
  14. }
  17. func (User) Fields() []ent.Field {
  18.     return []ent.Field{
  19.         field.Int("age"),
  20.         field.String("name"),
  21.         field.String("nickname").
  22.             Unique(),
  23.     }
  24. }
  27. func (User) Edges() []ent.Edge {
  28.     return []ent.Edge{
  29.         edge.To("groups", Group.Type),
  30.         edge.To("friends", User.Type),
  31.     }
  32. }
  35. func (User) Index() []ent.Index {
  36.     return []ent.Index{
  37.         index.Fields("age", "name").
  38.             Unique(),
  39.     }
  40. }

Entity schemas are usually stored inside ent/schema directory under the root directory of your project, and can be generated by entc as follows:

  1. go run entgo.io/ent/cmd/ent init User Group

It’s Just Another ORM

If you are used to the definition of relations over edges, that’s fine. The modeling is the same. You can model with ent whatever you can model with other traditional ORMs. There are many examples in this website that can help you get started in the Edges section.