Facebook|Facebook 开源 Golang 实体框架 Ent 现已支持 TiDB
对于后端开发者来说,一款好用的框架能够大大提升应用的开发效率。为了降低开发者使用 TiDB 的门槛,方便开发者快速连接到 TiDB,我们也在和合作伙伴一起,逐步完善面向主流开发语言和框架的连接支持。
近日,Facebook 开源的 Golang 实体框架 Ent 完成了对 TiDB 数据库的支持。
Ent 是一款易于构建和维护应用程序与大数据模型的框架。具有以下特点:
- Schema 即代码:能将任何数据库表建模为 Go 对象;
- 轻松地遍历任何图形 :可以轻松地运行查询、聚合和遍历任何图形结构;
- 静态类型和显式 API:使用代码生成静态类型和显式 API,查询数据更加便捷;
- 多存储驱动程序:支持 MySQL、PostgreSQL、SQLite、Gremlin,现在也已经支持了 TiDB;
- 可扩展:易于扩展和使用 Go 模板自定义。
Hello World 应用示例 1.用 Docker 在本地启动一个 TiDB Server
docker run -p 4000:4000 pingcap/tidb
现在你应该有一个运行的 TiDB 实例,开放了 4000 端口监听。
【Facebook|Facebook 开源 Golang 实体框架 Ent 现已支持 TiDB】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,TiDB 此前已经添加了对 GORM 和 go-sql-driver/mysql 的支持,详情可查看文档: https://docs.pingcap.com/appdev/dev
推荐阅读
- 数据库|TiFlash 开源了
- Golang关键字用法详细指南
- Golang指向指针的指针(双指针)介绍
- 前端开发必备!推荐Github最新热门表单开源框架HTML+CSS+JavaScript
- Github 6大热门开源富文本编辑器介绍,Web开发必备!
- 开源项目|Vue项目实战 —— 哔哩哔哩移动端开发—— 第二篇
- Hilo|Hilo - 阿里巴巴出品的免费开源 H5 游戏引擎,轻巧无依赖,适合用来开发营销互动小游戏
- [Golang]力扣Leetcode - 278. 第一个错误的版本(二分查找)
- [Golang]力扣Leetcode|[Golang]力扣Leetcode - 69. x 的平方根 (二分查找)
- 搭建一个开源项目|搭建一个开源项目12-Kubernetes集群部署(下)以及elasticsearch部署