Ecto入门指南：Elixir数据库操作基础

Ecto入门指南：Elixir数据库操作基础

ecto A toolkit for data mapping and language integrated query. 项目地址: https://gitcode.com/gh_mirrors/ec/ecto

前言

Ecto是Elixir生态系统中功能强大的数据库包装器和查询生成器，它为开发者提供了与各种数据库交互的标准API和抽象层。本文将带你从零开始学习Ecto的基础知识，包括如何配置Ecto、创建数据库表、定义数据模型以及执行基本的CRUD操作。

环境准备

在开始之前，请确保你已经：

1. 安装了Elixir开发环境
2. 安装了PostgreSQL数据库服务
3. 配置了PostgreSQL的访问权限

创建新项目

首先，我们创建一个新的Elixir应用：

mix new friends --sup

--sup选项会生成一个带有监督树的应用结构，这对于Ecto的正常运行是必要的。

添加Ecto依赖

在项目的mix.exs文件中添加Ecto和Postgrex（PostgreSQL驱动）依赖：

defp deps do
  [
    {:ecto_sql, "~> 3.0"},
    {:postgrex, ">= 0.0.0"}
  ]
end

然后运行以下命令获取依赖：

mix deps.get

配置Ecto

接下来，我们需要生成Ecto的配置文件：

mix ecto.gen.repo -r Friends.Repo

这会在config/config.exs中生成数据库连接配置：

config :friends, Friends.Repo,
  database: "friends",
  username: "user",
  password: "pass",
  hostname: "localhost"

注意：根据你的PostgreSQL配置，可能需要调整用户名、密码或端口设置。

创建数据库

运行以下命令创建数据库：

mix ecto.create

成功后会看到提示信息："The database for Friends.Repo has been created."

创建数据表

使用迁移来创建数据表：

mix ecto.gen.migration create_people

在生成的迁移文件中定义表结构：

defmodule Friends.Repo.Migrations.CreatePeople do
  use Ecto.Migration

  def change do
    create table(:people) do
      add :first_name, :string
      add :last_name, :string
      add :age, :integer
    end
  end
end

运行迁移：

mix ecto.migrate

定义数据模型

在lib/friends/person.ex中定义Person模型：

defmodule Friends.Person do
  use Ecto.Schema

  schema "people" do
    field :first_name, :string
    field :last_name, :string
    field :age, :integer
  end
end

数据验证

Ecto使用Changeset来处理数据验证和转换：

def changeset(person, params \\ %{}) do
  person
  |> Ecto.Changeset.cast(params, [:first_name, :last_name, :age])
  |> Ecto.Changeset.validate_required([:first_name, :last_name])
end

CRUD操作

创建记录

person = %Friends.Person{}
changeset = Friends.Person.changeset(person, %{first_name: "Ryan", last_name: "Bigg"})
Friends.Repo.insert(changeset)

查询记录

Ecto提供了强大的查询DSL：

import Ecto.Query
query = from p in Friends.Person, where: p.age > 25
Friends.Repo.all(query)

更新记录

person = Friends.Repo.get(Friends.Person, 1)
changeset = Friends.Person.changeset(person, %{age: 29})
Friends.Repo.update(changeset)

删除记录

person = Friends.Repo.get(Friends.Person, 1)
Friends.Repo.delete(person)

错误处理

Ecto操作通常会返回元组：

case Friends.Repo.insert(changeset) do
  {:ok, person} -> 
    # 处理成功情况
  {:error, changeset} -> 
    # 处理错误情况
end

总结

通过本文，你已经学习了：

1. 如何设置Ecto项目
2. 数据库迁移的创建和执行
3. 数据模型的定义
4. 使用Changeset进行数据验证
5. 基本的CRUD操作

Ecto的强大之处不仅在于这些基础功能，还在于它提供的复杂查询能力、事务支持、多数据库适配等高级特性。建议在掌握这些基础知识后，继续探索Ecto更高级的功能。

记住，良好的数据库设计是应用成功的关键，Ecto提供的工具能帮助你构建健壮、可维护的数据访问层。

ecto A toolkit for data mapping and language integrated query. 项目地址: https://gitcode.com/gh_mirrors/ec/ecto