
本教程详细介绍了如何使用go语言与google cloud datastore(现为firestore in datastore模式)进行数据建模和实体操作。我们将学习如何将go结构体映射为datastore实体,通过`datastore.newkey`创建唯一的实体键,并演示如何使用`datastore.put`保存数据以及`datastore.get`加载数据,澄清了不同数据类型应使用独立结构体而非嵌套数组的建模方式。
Go语言Datastore数据模型设计与实体操作教程
在Go语言中,使用Google Cloud Datastore(现在通常指Firestore in Datastore模式)进行数据存储时,数据模型的设计与关系型数据库有所不同,但其核心思想是将Go结构体(struct)直接映射为Datastore的实体(Entity)。本教程将指导您如何定义数据模型、创建实体键以及执行基本的保存和加载操作。
1. Datastore数据模型基础
Datastore是一个NoSQL文档数据库,它以“实体”的形式存储数据,每个实体都属于一个特定的“种类”(Kind),类似于关系型数据库中的表。在Go语言中,一个Go结构体通常对应Datastore中的一个“种类”。
最初,开发者可能会误认为需要创建一个包含多个子实体数组的单一结构体来表示复杂关系。然而,Datastore的推荐做法是为每种独立的数据类型定义一个单独的Go结构体。例如,User、Device和DeviceInfo应各自作为独立的实体“种类”存在,并通过实体键(Key)或属性中的ID进行关联,而不是将它们层层嵌套在一个大的结构体中。
以下是定义Datastore数据模型的Go结构体示例:
立即学习“go语言免费学习笔记(深入)”;
import "time"// User 结构体定义了一个用户实体type User struct { UserID int Email string Password string DateCreated time.Time}// Device 结构体定义了一个设备实体type Device struct { DeviceID int Udid string DateCreated time.Time DateUpdated time.Time IntLoginTotal int}// DeviceInfo 结构体定义了设备的详细信息实体type DeviceInfo struct { DeviceID int DeviceName string Model string LocalizedModel string SystemName string SystemVersion string Locale string Language string DateCreated time.Time}
在Datastore中,这些结构体的名称(如User、Device、DeviceInfo)将直接用作其对应的实体“种类”(Kind)。结构体中的字段(如UserID、Email)则成为实体的属性。
2. 创建实体键(Key)
在Datastore中,每个实体都由一个唯一的键(Key)来标识。键是实体在Datastore中身份的唯一表示,它包含了实体的“种类”和ID(可以是字符串ID或整数ID),以及可选的父实体信息。
datastore.NewKey函数用于创建实体键,其签名如下:
初阶PHP Apache MySQL网站设计
初阶PHP Apache MySQL网站设计来自作者多年学习、应用和讲授PHP的经验与体会,是专为学习PHP+MySQL数据库编程人员编与的入门教材。在最后二章设计了2个贴近实际应用的典型案例:留言本系统和论坛系统,每个案例先介绍开发思路、步骤,再给出全部源代码,使所学内容与实际应用紧密结合,特别是论坛系统将全书的案例串讲起来,力求使读者学到最贴近应用前沿的知识和技能。
377 查看详情
func NewKey(c appengine.Context, kind, stringID string, intID int64, parent *Key) *Key
c appengine.Context: 应用上下文,用于Datastore操作。kind string: 实体的种类名称,通常是Go结构体的名称,例如”User”。stringID string: 可选的字符串ID。如果使用,intID应为零。intID int64: 可选的整数ID。如果使用,stringID应为空字符串。parent *Key: 可选的父实体键,用于创建具有祖先路径的实体(实体组)。如果实体没有父级,则为nil。
重要提示: kind不能为空。stringID和intID不能同时非零,但可以同时为零(此时创建的键是“不完整键”,Datastore会在保存时自动分配一个ID)。parent必须是一个完整的键或nil。
以下是为User实体创建键的示例:
import ( "google.golang.org/appengine" "google.golang.org/appengine/datastore" "net/http" // 假设在HTTP请求处理中获取Context "time")// 假设在一个HTTP请求处理函数中func saveUserHandler(w http.ResponseWriter, r *http.Request) { c := appengine.NewContext(r) // 获取App Engine上下文 // 假设 userid, email, password, datecreated 已从请求中获取 userid := 123 email := "test@example.com" password := "hashedpassword" datecreated := time.Now() // 为User实体创建一个键 // "User" 是 Kind,"" 表示不使用 stringID,int64(userid) 是 intID,nil 表示没有父实体 k := datastore.NewKey(c, "User", "", int64(userid), nil) // ... 后续保存操作}
3. 保存实体(Put Operation)
将Go结构体实例保存到Datastore中,需要使用datastore.Put函数。
func Put(c appengine.Context, key *Key, src interface{}) (*Key, error)
c appengine.Context: 应用上下文。key *Key: 要保存实体的键。如果键是不完整的(即stringID和intID都为零),Datastore会在保存时自动生成一个整数ID,并返回一个完整的键。src interface{}: 要保存的Go结构体实例的指针。
以下是保存User实体的示例:
// 假设在一个HTTP请求处理函数中func saveUserHandler(w http.ResponseWriter, r *http.Request) { c := appengine.NewContext(r) userid := 123 email := "test@example.com" password := "hashedpassword" datecreated := time.Now() u := &User{ UserID: userid, Email: email, Password: password, DateCreated: datecreated, } // 创建键 k := datastore.NewKey(c, "User", "", int64(u.UserID), nil) // 保存实体 // Put函数返回一个完整的键(如果原始键不完整,则包含Datastore生成的ID)和错误 _, err := datastore.Put(c, k, u) if err != nil { // 处理错误 http.Error(w, err.Error(), http.StatusInternalServerError) return } // 实体保存成功 w.WriteHeader(http.StatusOK) w.Write([]byte("User saved successfully!"))}
对于其他结构体类型,如Device或DeviceInfo,也遵循相同的逻辑:创建对应的结构体实例,生成其键,然后调用datastore.Put进行保存。
4. 加载实体(Get Operation)
从Datastore中加载实体,需要使用datastore.Get函数。
func Get(c appengine.Context, key *Key, dst interface{}) error
c appengine.Context: 应用上下文。key *Key: 要加载实体的键。这个键必须是完整的(即包含一个非零的stringID或intID)。dst interface{}: 一个指向Go结构体实例的指针,Datastore会将加载
以上就是Go语言Datastore数据模型设计与实体操作教程的详细内容,更多请关注创想鸟其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1028986.html
微信扫一扫
支付宝扫一扫