Relation Writing

Relation writes are explicit through db.Relation(...).

err := db.Relation(article.Tags()).Attach(ctx, tag)
err = db.Relation(article.Tags()).Detach(ctx, tag)

Attach with pivot values

err := db.Relation(article.Tags()).Attach(ctx, tag, oro.Map{
    "position": 10,
})

For table queries, pivot values use database column names. For pivot models, use model fields.

Sync

err := db.Relation(article.Tags()).Sync(ctx, []*Tag{tagA, tagB})

Sync makes the join table match the provided set.

Update pivot row

err := db.Relation(article.Tags()).UpdateThrough(ctx, tag, oro.Map{
    "position": 20,
})

Boundaries

Relation writes do not hide ordinary model writes. Create related models first, then attach them through the relation operator.