对于后端开发者来说,一款好用的框架可能大大晋升利用的开发效率。为了升高开发者应用 TiDB 的门槛,不便开发者疾速连贯到 TiDB,咱们也在和合作伙伴一起,逐步完善面向支流开发语言和框架的连贯反对。
近日,Facebook 开源的 Golang 实体框架 Ent 实现了对 TiDB 数据库的反对。
Ent 是一款易于构建和保护应用程序与大数据模型的框架。具备以下特点:
- Schema 即代码:能将任何数据库表建模为 Go 对象;
- 轻松地遍历任何图形:能够轻松地运行查问、聚合和遍历任何图形构造;
- 动态类型和显式 API:应用代码生成动态类型和显式 API,查问数据更加便捷;
- 多存储驱动程序:反对 MySQL、PostgreSQL、SQLite、Gremlin,当初也曾经反对了 TiDB;
- 可扩大:易于扩大和应用 Go 模板自定义。
上面通过一个 Hello World 的利用示例,来看下如何疾速实现一个基于 Ent + TiDB 的利用。
Hello World 利用示例
1. 用 Docker 在本地启动一个 TiDB Server
docker run -p 4000:4000 pingcap/tidb
当初你应该有一个运行的 TiDB 实例,凋谢了 4000 端口监听。
2. 在本地拷贝 hello world 的示例 repo
git clone https://github.com/hedwigz/tidb-hello-world.git
在这个示例 repo 中咱们定义了一个简略的 User schema
go title="ent/schema/user.go"
func (User) Fields() []ent.Field {return []ent.Field{field.Time("created_at").
Default(time.Now),
field.String("name"),
field.Int("age"),
}
}
而后,连贯 Ent 和 TiDB:
go title="main.go"
client, err := ent.Open("mysql", "root@tcp(localhost:4000)/test?parseTime=true")
if err != nil {log.Fatalf("failed opening connection to TiDB: %v", err)
}
defer client.Close()
// Run the auto migration tool, with Atlas.
if err := client.Schema.Create(context.Background(), schema.WithAtlas(true)); err != nil {log.Fatalf("failed printing schema changes: %v", err)
}
能够看到,在第一行咱们通过一个 MySQL 语句去连贯 TiDB Server,因为 TiDB 是兼容 MySQL 的,所以不须要其余非凡的 driver。
话虽如此,TiDB 和 MySQL 还是有很多不同,尤其是与 Schema 迁徙相干的操作,比方 SQL 诊断和迁徙布局。所以,Atlas 能够主动监测出是连贯到 TiDB,做相应的迁徙解决。
此外,第七行咱们应用 schema.WithAtlas(true)
,示意 Ent 是应用“Atlas”作为迁徙引擎。Atlas 是 Ent 刚刚公布的迁徙引擎,得益于 Atlas 的最新设计,对新数据库的反对也变得前所未有的简略。
最初,咱们新建一条 user 数据,并保留到 TiDB 中,以用于后需的数据读取和输入。
go title="main.go"
client.User.Create().
SetAge(30).
SetName("hedwigz").
SaveX(context.Background())
user := client.User.Query().FirstX(context.Background())
fmt.Printf("the user: %s is %d years old\n", user.Name, user.Age)
3. 运行这个示例程序:
$ go run main.go
the user: hedwigz is 30 years old
在这次疾速演练中,咱们胜利实现了:
- 启动一个本地的 TiDB 实例;
- 连贯 Ent 和 TiDB 数据库;
- 应用 Atlas 迁徙 Ent Schema;
- 应用 Ent 从 TiDB 中插入和读取数据。
版本阐明
目前,这个示例利用在 Ent v0.10 和 TiDB v5.4.0 中能够失常运行,Ent 也打算在将来持续拓展对 TiDB 的反对。如果你应用其余版本的 TiDB 或者须要帮忙,欢送退出 asktug.com 来交换。如果你也有我的项目心愿与 TiDB 适配,欢送来 GitHub 提交 issue。
除了 Ent,TiDB 此前曾经增加了对 GORM 和 go-sql-driver/mysql 的反对,详情可查看文档:https://docs.pingcap.com/appd…