使用方法
安装客户端工具，连接并使用 FerretDB
本文档介绍如何安装 MongoDB 客户端工具并连接到 FerretDB。
安装客户端工具
您可以使用 MongoDB 的命令行工具 MongoSH 来访问 FerretDB。
使用 pig 命令添加 MongoDB 仓库，然后使用 yum 或 apt 安装 mongosh：
pig repo add mongo -u # 添加 MongoDB 官方仓库
yum install mongodb-mongosh # RHEL/CentOS/Rocky/Alma
apt install mongodb-mongosh # Debian/Ubuntu
安装完成后，您可以使用 mongosh 命令连接到 FerretDB。
连接到 FerretDB
您可以使用任何语言的 MongoDB 驱动程序通过 MongoDB 连接字符串访问 FerretDB。以下是使用 mongosh CLI 工具的示例：
$ mongosh
Current Mongosh Log ID: 67ba8c1fe551f042bf51e943
Connecting to: mongodb://127.0.0.1:27017/?directConnection=true&serverSelectionTimeoutMS=2000&appName=mongosh+2.4.0
Using MongoDB: 7.0.77
Using Mongosh: 2.4.0
For mongosh info see: https://www.mongodb.com/docs/mongodb-shell/
test>
使用连接字符串
FerretDB 的身份验证完全基于 PostgreSQL。由于 Pigsty 管理的 PostgreSQL 集群默认使用 scram-sha-256 认证方式，您必须在连接字符串中指定 PLAIN 认证机制：
mongosh 'mongodb://dbuser_meta:DBUser.Meta@10.10.10.10:27017?authMechanism=PLAIN'
连接字符串格式：
mongodb://<username>:<password>@<host>:<port>/<database>?authMechanism=PLAIN
使用不同的用户
您可以使用任何已在 PostgreSQL 中创建的用户连接到 FerretDB：
# 使用 dbuser_dba 用户
mongosh 'mongodb://dbuser_dba:DBUser.DBA@10.10.10.10:27017?authMechanism=PLAIN'
# 使用 mongod 超级用户
mongosh 'mongodb://mongod:DBUser.Mongo@10.10.10.10:27017?authMechanism=PLAIN'
# 连接到特定数据库
mongosh 'mongodb://test:test@10.10.10.11:27017/test?authMechanism=PLAIN'
基本操作
连接到 FerretDB 后，您可以像使用 MongoDB 一样进行操作。以下是一些基本操作示例：
数据库操作
// 切换/创建数据库
use mydb
// 显示所有数据库
show dbs
// 删除当前数据库
db.dropDatabase()
集合操作
// 创建集合
db.createCollection('users')
// 显示所有集合
show collections
// 删除集合
db.users.drop()
文档操作
// 插入单个文档
db.users.insertOne({
name: 'Alice',
age: 30,
email: 'alice@example.com'
})
// 插入多个文档
db.users.insertMany([
{ name: 'Bob', age: 25 },
{ name: 'Charlie', age: 35 }
])
// 查询文档
db.users.find()
db.users.find({ age: { $gt: 25 } })
db.users.findOne({ name: 'Alice' })
// 更新文档
db.users.updateOne(
{ name: 'Alice' },
{ $set: { age: 31 } }
)
// 删除文档
db.users.deleteOne({ name: 'Bob' })
db.users.deleteMany({ age: { $lt: 30 } })
索引操作
// 创建索引
db.users.createIndex({ name: 1 })
db.users.createIndex({ age: -1 })
// 查看索引
db.users.getIndexes()
// 删除索引
db.users.dropIndex('name_1')
与 MongoDB 的差异
FerretDB 实现了 MongoDB 的线协议，但底层使用 PostgreSQL 存储数据。这意味着：
- MongoDB 命令会被翻译为 SQL 语句执行
- 大多数基本操作与 MongoDB 兼容
- 某些高级功能可能有差异或不支持
您可以查阅以下资源了解详细信息：
程序语言驱动
除了 mongosh 命令行工具，您还可以使用各种编程语言的 MongoDB 驱动程序连接到 FerretDB：
Python
from pymongo import MongoClient
client = MongoClient('mongodb://dbuser_meta:DBUser.Meta@10.10.10.10:27017/?authMechanism=PLAIN')
db = client.test
collection = db.users
collection.insert_one({'name': 'Alice', 'age': 30})
Node.js
const { MongoClient } = require('mongodb');
const uri = 'mongodb://dbuser_meta:DBUser.Meta@10.10.10.10:27017/?authMechanism=PLAIN';
const client = new MongoClient(uri);
async function run() {
await client.connect();
const db = client.db('test');
const collection = db.collection('users');
await collection.insertOne({ name: 'Alice', age: 30 });
}
Go
import (
"go.mongodb.org/mongo-driver/mongo"
"go.mongodb.org/mongo-driver/mongo/options"
)
uri := "mongodb://dbuser_meta:DBUser.Meta@10.10.10.10:27017/?authMechanism=PLAIN"
client, err := mongo.Connect(context.TODO(), options.Client().ApplyURI(uri))
关键点：所有驱动程序都需要在连接字符串中指定 authMechanism=PLAIN 参数。