目录
MongoDB简介
mongodb是一种高性能、开源、文档型的nosql数据库，被广泛应用于web应用、大数据以及云计算领域。
在使用MongoDB之前，需要先在您的系统中安装MongoDB。在Linux系统下，可以通过如下命令安装：
bash
sudo apt-get install mongodbMongoDB的优势
1. 强大的灵活性
MongoDB是一个面向文档的数据库，它使用BSON（二进制JSON）格式来存储数据。相比之下，MySQL是一个关系型数据库，使用表格来存储数据。这使得MongoDB更加灵活，可以存储不同结构的文档。例如，我们可以在同一个集合中存储不同类型的文档，而MySQL需要创建多个表来存储不同类型的数据。
2. 高性能的读写操作
由于MongoDB使用BSON格式存储数据，并且数据存储在文档中，它可以更快地读写数据。此外，MongoDB还支持内置的复制和分片机制，可用于处理高并发的读写操作。相比之下，MySQL需要通过SQL查询语句来读写数据，这通常比MongoDB的操作要慢一些。
3. 分布式扩展性
MongoDB可以轻松地进行水平扩展，即通过添加更多的节点来增加存储容量和处理能力。这种分布式架构使得MongoDB能够处理大量数据和高并发请求。与之相比，MySQL在处理大规模数据和高并发情况下的扩展性有限。
4. 灵活的数据模型
MongoDB的数据模型允许我们使用嵌套文档和数组来表示复杂的数据结构。这使得数据的存储和查询更加方便，无需进行多个表之间的连接操作。例如，我们可以在一个文档中存储一个订单及其相关的所有产品，并且可以轻松地查询和更新这个文档。相比之下，MySQL需要通过多个表和连接操作来实现类似的功能。
对比mysql的操作
在数据库的操作上与mysql有很大不同。毕竟一个是非关系型，一个是关系型数据库。接下来从python代码上先来直观感受下二者的不同。
python操作mogodb示例
python
# MongoDB示例
# 连接到MongoDB数据库
from pymongo import MongoClient
client = MongoClient('mongodb://localhost:27017/')
# 获取数据库和集合对象
db = client['mydb']
collection = db['mycollection']
# 插入一条文档
data = {'name': 'John', 'age': 25}
collection.insert_one(data)
# 查询文档
result = collection.find_one({'name': 'John'})
print(result)
# 关闭连接
client.close()mysql的python 示例
python
-- MySQL示例
-- 连接到MySQL数据库
import mysql.connector
cnx = mysql.connector.connect(user='root', password='password', host='localhost', database='mydb')
-- 获取游标
cursor = cnx.cursor()
-- 插入一条记录
sql = "INSERT INTO mytable (name, age) VALUES (%s, %s)"
values = ('John', 25)
cursor.execute(sql, values)
cnx.commit()
-- 查询记录
sql = "SELECT * FROM mytable WHERE name = 'John'"
cursor.execute(sql)
result = cursor.fetchone()
print(result)
-- 关闭连接
cursor.close()
cnx.close()通过以上示例，可以看到MongoDB使用了面向文档的操作方式，数据以JSON格式存储在集合中，并且不需要事先定义表结构。而MySQL需要使用SQL语句来进行数据的插入和查询，需要提前定义表结构。
总的来说，MongoDB在灵活性、高性能读写、分布式扩展性和灵活的数据模型方面相对于MySQL有许多优势。当处理需要存储和查询复杂数据结构、大规模数据和高并发请求时，MongoDB是一个更好的选择。
goctl的mongodb代码生成
goctl model 为 goctl 提供的数据库模型代码生成指令，目前支持 MySQL、PostgreSQL、Mongo 的代码生成，MySQL 支持从 sql 文件和数据库连接两种方式生成，PostgreSQL 仅支持从数据库连接生成。
goctl model 为go-zero下的工具模块中的组件之一，目前支持MongoDB进行model层代码生成。官网有对MySQL的使用方法，但是没有对MongoDB的使用进行讲解，那么我下面介绍goctl model对MongoDB的使用方法。
Mongo 模型层代码的生成不同于 MySQL，MySQL 可以从 scheme_information 库中读取到一张表的信息（字段名称，数据类型，索引等）， 而 Mongo 是文档型数据库，我们暂时无法从 db 中读取某一条记录来实现字段信息获取。
bash
Usage:
goctl model mongo [flags]
Flags:
--branch string The branch of the remote repo, it does work with --remote
-c, --cache Generate code with cache [optional]
-d, --dir string The target dir
-e, --easy Generate code with auto generated CollectionName for easy declare [optional]
-h, --help help for mongo
--home string The goctl home path of the template, --home and --remote cannot be set at the same time, if they are, --remote has higher priority
--remote string The remote git repo of the template, --home and --remote cannot be set at the same time, if they are, --remote has higher priority
The git repo directory must be consistent with the https://github.com/zeromicro/go-zero-template directory structure
--style string The file naming format, see [https://github.com/zeromicro/go-zero/tree/master/tools/goctl/config/readme.md]
-t, --type strings Specified model type name各个参数的含义，主要用的是 -e -dir -t
-e表示的是生成一个简单的增删改查接口，-dir是生成文档放在的目录
-t是生成文件的前缀名称
-c是带缓存的
如何使用
bash
goctl model mongo -t User -dir model/user如何生成model层代码？执行以上命令即可，很简单，不需要提前编写什么模型文件，以上命令将自动在model/user目录下生成模型框架代码，如果需要扩展其他字段类型，直接修改生成的usertypes.go文件。
过程如下：
bash
# enter user home
$ cd ~
# make dir named demo
$ mkdir demo && cd demo
# generate mongo code by goctl
$ goctl model mongo --type User --dir cache --cache
# view layout
$ tree
.
└── cache
├── error.go
├── usermodel.go
├── usermodelgen.go
└── usertypes.go
1 directory, 4 filesgo-zero中mogodb使用
go-zero中mogodb的基础使用：
Go
package main
import (
"context"
"time"
"github.com/globalsign/mgo/bson"
"github.com/zeromicro/go-zero/core/stores/mon"
"go.mongodb.org/mongo-driver/bson/primitive"
)
type Roster struct {
Id primitive.ObjectID `bson:"_id"`
CreateTime time.Time `bson:"createTime"`
DisplayName string `bson:"displayName"`
}
func main() {
model := mon.MustNewModel("mongodb://root:example@127.0.0.1:27017", "db", "user")
r := &Roster{
Id: primitive.NewObjectID(),
CreateTime: time.Now(),
DisplayName: "Hello",
}
ctx := context.Background()
_, err := model.InsertOne(ctx, r)
if err != nil {
panic(err)
}
update := bson.M{"$set": bson.M{
"displayName": "Hello world",
"createTime": time.Now(),
}}
_, err = model.UpdateByID(ctx, r.Id, update)
if err != nil {
panic(err)
}
r.DisplayName = "Hello world!"
_, err = model.ReplaceOne(ctx, bson.M{"_id": r.Id}, r)
if err != nil {
panic(err)
}
var tr Roster
err = model.FindOne(ctx, &tr, bson.M{"_id": r.Id})
if err != nil {
panic(err)
}
}mongodb官方驱动使用
再来看下在在golang中的mongodb官方驱动使用示例：
Go
package main
import (
"context"
"log"
"go.mongodb.org/mongo-driver/bson"
"go.mongodb.org/mongo-driver/mongo"
"go.mongodb.org/mongo-driver/mongo/options"
)
func main() {
clientOptions := options.Client().ApplyURI("mongodb://localhost:27017")
client, err := mongo.Connect(context.Background(), clientOptions)
if err != nil {
log.Fatal(err)
}
defer client.Disconnect(context.Background())
coll := client.Database("your_db_name").Collection("user")
// 插入数据
doc := &user.User{
Id: "1",
Name: "Alice",
Email: "alice@example.com",
}
_, err = coll.InsertOne(context.TODO(), doc)
if err != nil {
log.Fatal(err)
}
// 查询数据
var result user.User
err = coll.FindOne(context.TODO(), bson.M{"_id": "1"}).Decode(&result)
if err != nil {
log.Fatal(err)
}
log.Printf("Found user: %+v", result)
// 更新数据
updateResult, err := coll.UpdateOne(
context.TODO(),
bson.M{"_id": "1"},
bson.D{{"$set", bson.D{{"email", "alice.updated@example.com"}}}},
)
if err != nil {
log.Fatal(err)
}
log.Printf("Modified count: %v", updateResult.ModifiedCount)
// 删除数据
deleteResult, err := coll.DeleteOne(context.TODO(), bson.M{"_id": "1"})
if err != nil {
log.Fatal(err)
}
log.Printf("Deleted count: %v", deleteResult.DeletedCount)
}增删改查示例
Go
package main
import (
"context"
"fmt"
"log"
"time"
//"go.mongodb.org/mongo-driver/bson/primitive"
"go.mongodb.org/mongo-driver/mongo"
"go.mongodb.org/mongo-driver/mongo/options"
"go.mongodb.org/mongo-driver/bson"
)
type User struct {
Name string `json:"name"`
Email string `json:"email"`
Age int `bson:"Agg"`
}
// ... 上面User结构体定义 ...
func main() {
// 连接MongoDB
clientOptions := options.Client().ApplyURI("mongodb://test1:111111@localhost:27017/?tls=false&authSource=test1")
client, err := mongo.Connect(context.Background(), clientOptions)
if err != nil {
log.Fatal(err)
}
defer func() {
if err = client.Disconnect(context.Background()); err != nil {
log.Fatal(err)
}
}()
// 解析JSON字符串到User结构体（假设已经完成）
user := User{Name: "Alice", Email: "alice@example.com",Age:22}
// 选择数据库和集合
collection := client.Database("test1").Collection("users")
// 插入文档
insertResult, err := collection.InsertOne(context.TODO(), user)
if err != nil {
log.Fatal(err)
}
fmt.Println("Inserted ID:", insertResult.InsertedID)
// 插入文档
doc := bson.D{{"name", "Alice1"}, {"age", 30}, {"createdAt", time.Now()}}
insertResult, err = collection.InsertOne(context.TODO(), doc)
if err != nil {
log.Fatal(err)
}
fmt.Println("Inserted ID:", insertResult.InsertedID)
// 更新文档
filter := bson.D{{"name", "Alice1"}}
update := bson.D{{"$set", bson.D{{"age", 31}}}}
updateResult, err := collection.UpdateOne(context.TODO(), filter, update)
if err != nil {
log.Fatal(err)
}
fmt.Println("Modified Count:", updateResult.ModifiedCount)
// 删除文档
filter = bson.D{{"age", 22}}
deleteResult, err := collection.DeleteOne(context.TODO(), filter)
if err != nil {
log.Fatal(err)
}
fmt.Println("Deleted Count:", deleteResult.DeletedCount)
// 查找单个文档
var singleResult bson.M
err = collection.FindOne(context.TODO(), bson.D{}).Decode(&singleResult)
if err != nil {
log.Fatal(err)
}
fmt.Println("Single Document:", singleResult)
// 查找所有文档
cursor, err := collection.Find(context.TODO(), bson.D{})
if err != nil {
log.Fatal(err)
}
defer cursor.Close(context.TODO())
for cursor.Next(context.TODO()) {
var result bson.M
err := cursor.Decode(&result)
if err != nil {
log.Fatal(err)
}
fmt.Println("Document:", result)
}
// 过滤查找
filteredCursor, err := collection.Find(context.TODO(), bson.D{{"age", bson.D{{"$gt", 31}}}})
if err != nil {
log.Fatal(err)
}
defer filteredCursor.Close(context.TODO())
for filteredCursor.Next(context.TODO()) {
var filteredDoc bson.M
err := filteredCursor.Decode(&filteredDoc)
if err != nil {
log.Fatal(err)
}
fmt.Println("Filtered Document:", filteredDoc)
}
}注意事项
示例中的bson.D 和 bson.M 都是Go语言中用于表示MongoDB的BSON文档的数据类型，但它们之间存在一些关键的区别 。
bson.D (Ordered Dictionary)，bson.D是一个有序的字典类型，其中元素按照它们被定义的顺序排列。它是一个包含了键值对的切片，其中每一个元素都是一个两元素的数组，第一个元素是字符串（字段名），第二个元素可以是任意类型（字段值）。当你需要按照特定顺序来定义BSON文档的字段时，使用它。
bson.M (Map)，bson.M是一个无序的映射类型，基于Go语言的map[string]interface{}，用于表示不关心顺序的键值对集合。用途: 更适合用于构建动态查询条件或者不需要保持特定字段顺序的情况。如：
Go
query := bson.M{"name": "Alice", "age": bson.M{"$gt": 30}}对于大多数常规的查询构建，特别是当字段不是严格按照顺序组织时用它。当文档的结构是动态生成或者需要频繁修改时，bson.M提供了更灵活的键值对添加和管理方式。
在Go语言中，使用mongo-go-drive驱动，需r将JSON字符串转换为结构体，才存储到MongoDB中。如果你有一个JSON字符串，需要将其解析到Go的结构体中。
直接将JSON字符串存入MongoDB并非最佳实践，因为MongoDB使用BSON（Binary JSON）作为存储格式，虽然BSON与JSON相似，但直接存储JSON字符串会导致数据以文本形式存在，丧失了BSON的一些优势，如高效的查询和索引能力。
然而，如果你确实需要将JSON字符串原样存储到MongoDB中（例如，作为文档的一个字段），可以通过将JSON字符串作为文档的一个键值对插入。
如果golang的结构体不增加bson标签，能否成功写入mongodb?
为何有了json标签，还要bson标签呢？
尽管从表面上看，为BSON序列化单独定义标签似乎增加了些冗余，但实际上，这样的设计提高了代码的清晰度、灵活性和对MongoDB特性的直接支持。
即使Go语言的结构体没有显式地增加bson标签，你仍然可以成功地将结构体实例写入MongoDB。mongo-go-driver会按照结构体字段的名称来映射到BSON文档的键名。但是，这种方式有一些限制和注意事项：
字段名称：如果没有bson标签，MongoDB驱动会直接使用Go结构体字段名作为BSON文档的键。这意味着字段名必须符合MongoDB的命名规范，且大小写敏感性会得到保留。这可能导致查询时需要精确匹配字段名的大小写。
嵌套结构体：对于嵌套的结构体字段，如果不使用bson标签来指定嵌套层次或别名，那么嵌套结构体的字段会扁平化到同一层级，可能导致数据结构与预期不符。
忽略字段：如果想让某些字段不被序列化到MongoDB，没有bson标签就无法直接实现这一点。默认情况下，所有未标记的公开字段都会被序列化。
特殊类型处理：对于Go中的某些类型，如时间time.Time，如果没有使用bson标签指定其为日期类型（如bson:"date"），它们会被序列化为BSON的字符串或其他默认格式，可能不符合MongoDB的最佳实践。
因此，虽然不加bson标签可以工作，但在很多实际应用场景中，为了更好地控制数据的序列化和反序列化行为，以及确保数据的一致性和查询效率，建议还是使用bson标签来明确指定字段映射规则。
model模型的方式使用
具体的实例化方法，参照goctl模型层的使用，在internal/svc/servicecontext.go 中完成模型的连接和实例化。比较简单，具体根据需要更改。
Go
package svc
import "myprj/internal/config"
//手动代码
import "myprj/rpc/model"
type ServiceContext struct {
Config config.Config
Model model.NewUserModel// 手动代码
}
func NewServiceContext(c config.Config) *ServiceContext {
return &ServiceContext{
Config: c,
Model: model.NewUserModel(c.DataSource, c.Cache), // 手动代码
}
}其他资源
[zeromicro/go-zero]关于mongo生成model方案讨论 - ABSoft
Release Release v1.1.6 · zeromicro/go-zero · GitHub
MongoDB统一数据查询钩子_go-zero mongodb-CSDN博客
使用goctl model 生成MongoDB操作模板_go生成mongodb定义-CSDN博客
go-zero mongo 创建事务_go-zero mongodb-CSDN博客
Go操作mongodb数据库方法示例_Golang_脚本之家
如何将 Go 与 MongoDB 结合使用？-mysql教程-PHP中文网
MongoDB Go Driver - Go Driver v1.15
goctl model | go-zero Documentation
基本 CURD | go-zero Documentation