本教程详细介绍了如何使用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函数用于创建实体键，其签名如下：
- 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函数。
- 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会将加载