Ecto的associations和embeds

这篇文章以 Ecto 2.0 为例，讲述了怎么 read, insert, update and delete associations 和 embeds。这篇文章需要你对 Ecto 的 repositories, schema and the query syntax
有基本了解。不太了解可以参考文档 Ecto docs。

Associations

Ecto中的Associations是两张数据表通过外键连接 foreign keys。

这里以 Post 和 Comments 为例，首先创建两张表的migrations：

create table(:posts) do
  add :title, :string
  add :body, :text
  timestamps
end

create table(:comments) do
  add :post_id, references(:posts)
  add :body, :text
  timestamps
end

每个 comment 包含一个 post_id 默认指向了 post 表的 id 。

然后定义 schema

defmodule MyApp.Post do
  use Ecto.Schema

  schema "posts" do
    field :title
    field :body
    has_many :comments, MyApp.Comment
    timestamps
  end
end

defmodule MyApp.Comment do
  use Ecto.Schema

  schema "comments" do
    field :body
    belongs_to :post, MyApp.Post
    timestamps
  end
end

所有 schema definitions 像 field, has_many 和其他都在 Ecto.Schema
中定义

与 has_many/3 相类似， has_one/3 定义了父表至多有一个子条目。可以用metadata举例 Post has one metadata 并且 Metadata belongs to post

has_one/3 和 belongs_to/3 的区别就是 foreign key 一直定义在 belongs_to/3 的 schema 中。你可以认为 has_* 是父表，而 belongs_to 是子表。

查询关联关系

Repo.all from p in Post,
            preload: [:comments]

定义关联的一个好处就是你可以在查询中使用。
现在所有的posts都会伴随着相应的comments被提取出数据库。
它包含两个查询，一个提取posts，一个提取comments
这通常是关联数据的最简单查询方法，即使只有两个。
我们只需要接受和处理 POSTS + COMMENTS

同样，我们也可以使用join来查询关联数据

Repo.all from p in Post,
            join: c in assoc(p, :comments),
            where: c.votes > p.votes
            preload: [comments: c]

上述例子执行一个查询，找到所有的posts和对应的满足条件的comments。由于查询有个JOIN，所以返回的数据量是POSTS * COMMENTS，Ecto之后再处理和关联评论到相应的post。

最后，Ecto允许你将数据预加载到结构体中
Repo.preload posts, :comments

操作关联

你可以使用一条命令插入多个comment

Repo.insert!(%Post{
  title: "Hello",
  body: "world",
  comments: [
    %Comment{body: "Excellent!"}
  ]
})

你也可以使用changeset

post = Ecto.Changeset.change(%Post{}, title: "Hello", body: "world")
comment = Ecto.Changeset.change(%Comment{}, body: "Excellent!")
post_with_comments = Ecto.Changeset.put_assoc(post, :comments, [comment])
Repo.insert!(post_with_comments)

或者使用transaction

Repo.transaction fn ->
  post = Repo.insert!(%Post{title: "Hello", body: "world"})

  # Build a comment from the post struct
  comment = Ecto.build_assoc(post, :comments, body: "Excellent!")

  Repo.insert!(comment)
end

Embed

Embed 与 Assoc 不同的是，child被存储在parent中，而不是被存在另一个单独表里。

像PostgreSQL这种数据库使用JSONB(embeds_one/3) 和数组列来提供这种功能，JSONB和ARRAY都是Ecto默认支持的一等公民。

defmodule MyApp.Permalink do
  use Ecto.Schema

  embedded_schema do
    field :url
    timestamps
  end
end

defmodule MyApp.Post do
  use Ecto.Schema

  schema "posts" do
    field :title
    field :body
    has_many :comments, MyApp.Comment
    embeds_many :permalinks, MyApp.Permalink
    timestamps
  end
end

Repo.insert!(%Post{
  title: "Hello",
  permalinks: [
    %Permalink{url: "example.com/thebest"},
    %Permalink{url: "another.com/mostaccessed"}
  ]
})

你也可以用changesets来

# Generate a changeset for the post
changeset = Ecto.Changeset.change(post)

# Let's track the new permalinks
changeset = Ecto.Changeset.put_embed(changeset, :permalinks,
  [%Permalink{url: "example.com/thebest"},
   %Permalink{url: "another.com/mostaccessed"}]
)

# Now insert the post with permalinks at once
post = Repo.insert!(changeset)

# Remove all permalinks from example.com
permalinks = Enum.reject post.permalinks, fn permalink ->
  permalink.url =~ "example.com"
end

# Let's create a new changeset
changeset =
  post
  |> Ecto.Changeset.change
  |> Ecto.Changeset.put_embed(:permalinks, permalinks)

# And update the entry
post = Repo.update!(changeset)

http://blog.plataformatec.com.br/2015/08/working-with-ecto-associations-and-embeds/