Tiếp tục với series, bài này mình sẽ giới thiệu với mọi người về MongoDB với Mongoose trong NestJS: lưu nhật ký hoạt động của TaskFlow API song song với PostgreSQL đã dùng từ Bài 15.
1. Khi nào chọn MongoDB thay vì SQL.
MongoDB lưu dữ liệu dạng document (giống JSON) trong các collection, các document không bắt buộc cùng cấu trúc (xem series MongoDB và Node.js & MongoDB).
SQL hợp với dữ liệu quan hệ chặt, cần khoá ngoại và transaction như user, project, task. MongoDB hợp với dữ liệu ít quan hệ, cấu trúc hay đổi, ghi nhiều như log. Vì vậy PostgreSQL vẫn là database chính, MongoDB chỉ lưu activity log: mỗi lần tạo, sửa, xoá project hay task thêm một document. Mình dùng Mongoose (ODM: schema, model, validate) qua @nestjs/mongoose.
2. Chạy MongoDB bằng Docker và kết nối.
Giống PostgreSQL, mình chạy MongoDB 9 bằng Docker rồi cài package (@nestjs/mongoose 12.0.1, mongoose 9.12.1):
docker run -d --name taskflow-mongo \
-e MONGO_INITDB_ROOT_USERNAME=taskflow -e MONGO_INITDB_ROOT_PASSWORD=taskflow \
-p 127.0.0.1:27017:27017 -v taskflow-mongodata:/data/db mongo:9
npm install @nestjs/mongoose mongoose
Thêm MONGODB_URI="mongodb://taskflow:taskflow@localhost:27017/taskflow?authSource=admin" vào .env và .env.example (user root nằm ở database admin). Như Bài 14, thêm MONGODB_URI: z.url({ protocol: /^mongodb(\+srv)?$/ }), vào envSchema và mongoUri: process.env.MONGODB_URI ?? '', vào database.config.ts, rồi kết nối ngay sau PrismaModule:
- src/app.module.ts (đoạn trích, import MongooseModule từ @nestjs/mongoose, type ConfigType từ @nestjs/config)
PrismaModule,
MongooseModule.forRootAsync({
inject: [databaseConfig.KEY],
useFactory: (database: ConfigType<typeof databaseConfig>) => ({
uri: database.mongoUri,
}),
}),
forRoot(uri) nhận thẳng chuỗi kết nối, forRootAsync() lấy từ config như factory provider (Bài 6). MongoDB chưa chạy thì Nest thử kết nối 9 lần: mỗi lần driver chờ khoảng 30 giây (serverSelectionTimeoutMS), nghỉ 3 giây rồi thử lại, nên gần 5 phút sau app mới dừng, không phải bị treo. Muốn báo lỗi sớm khi dev, thêm retryAttempts, serverSelectionTimeoutMS vào object factory trả về.
3. Schema, @Prop và model.
Schema mô tả cấu trúc document của một collection, model tạo từ schema dùng để đọc ghi collection. Schema được viết bằng class:
- src/activities/schemas/activity.schema.ts
import { Prop, Schema, SchemaFactory } from '@nestjs/mongoose';
export const ACTIVITY_ENTITIES = ['project', 'task'] as const;
export const ACTIVITY_ACTIONS = ['created', 'updated', 'deleted'] as const;
// Collection "activities": chỉ thêm mới, không cập nhật (không cần updatedAt, __v)
@Schema({
timestamps: { createdAt: true, updatedAt: false },
versionKey: false,
})
export class Activity {
@Prop({ type: String, required: true, enum: ACTIVITY_ENTITIES })
entity: (typeof ACTIVITY_ENTITIES)[number];
@Prop({ required: true })
entityId: number;
@Prop({ type: String, required: true, enum: ACTIVITY_ACTIONS })
action: (typeof ACTIVITY_ACTIONS)[number];
// Dữ liệu tự do: mỗi loại hoạt động lưu một kiểu khác nhau
@Prop({ type: Object })
data?: object;
// Mongoose tự thêm nhờ timestamps
createdAt: Date;
}
export const ActivitySchema = SchemaFactory.createForClass(Activity);
// Index cho truy vấn "nhật ký của project 2, mới nhất trước"
ActivitySchema.index({ entity: 1, entityId: 1, createdAt: -1 });
Trong đó:
@Schema(): tên collection là tên class viết thường, số nhiều (activities).@Prop(): kiểu được đọc từ metadata TypeScript. Kiểu union nhưentityphải ghitype, nếu không sẽ lỗiCannot determine a type for the "Activity.entity" field.type: Objectnhận object bất kỳ.
Không cần migration: collection và index được tạo khi app khởi động. Tạo module, service, controller bằng nest g module activities --format (service, controller thêm --no-spec), rồi trong ActivitiesModule thêm imports: [MongooseModule.forFeature([{ name: Activity.name, schema: ActivitySchema }])] để đăng ký model và exports: [ActivitiesService].
4. CRUD với model.
- src/activities/activities.service.ts
import { Injectable, NotFoundException } from '@nestjs/common';
import { InjectModel } from '@nestjs/mongoose';
import { Model, QueryFilter, Types } from 'mongoose';
import type { ListActivitiesQueryDto } from './dto/list-activities-query.dto.js';
import { Activity } from './schemas/activity.schema.js';
export type NewActivity = Omit<Activity, 'createdAt'>;
@Injectable()
export class ActivitiesService {
constructor(
@InjectModel(Activity.name)
private readonly activityModel: Model<Activity>,
) {}
// Không await: MongoDB chậm hay lỗi cũng không làm hỏng request chính
log(activity: NewActivity): void {
this.activityModel.create(activity).catch((error: unknown) => {
console.error('Không ghi được activity', error);
});
}
// Nhật ký mới nhất trước, lọc theo entity/entityId nếu có
findAll(query: ListActivitiesQueryDto): Promise<Activity[]> {
const { limit, entity, entityId } = query;
const filter: QueryFilter<Activity> = {};
if (entity) filter.entity = entity;
if (entityId) filter.entityId = entityId;
return this.activityModel
.find(filter)
.sort({ createdAt: -1, _id: -1 })
.limit(limit)
.lean();
}
async findOne(id: Types.ObjectId): Promise<Activity> {
const activity = await this.activityModel.findById(id).lean();
if (!activity) {
throw new NotFoundException(
`Không tìm thấy activity ${id.toString()}`,
);
}
return activity;
}
// Xoá nhật ký cũ hơn số ngày cho trước, trả về số document đã xoá
async removeOlderThan(days: number): Promise<number> {
const before = new Date(Date.now() - days * 24 * 60 * 60 * 1000);
const result = await this.activityModel.deleteMany({
createdAt: { $lt: before },
});
return result.deletedCount;
}
}
Trong đó:
create()validate theo schema rồi thêm document;find()+sort/limitgiốngfindMany+orderBy/takecủa Prisma,deleteMany()xoá theo điều kiện;lean()trả object thường, nhẹ hơn document Mongoose. Nhật ký không sửa nên không dùngfindByIdAndUpdate().- Khác Prisma, Mongoose không bỏ qua
{ entity: undefined }mà so khớp vớinull(kết quả rỗng), nên bộ lọc chỉ thêm trường có giá trị.
ListActivitiesQueryDto kế thừa PickType(PaginationQueryDto, ['limit'] as const) như ListTasksQueryDto (Bài 18), thêm entity? (@IsOptional() @IsIn(ACTIVITY_ENTITIES)) và entityId? (@IsOptional() @Type(() => Number) @IsInt() @Min(1)). Controller có GET /activities (@Query() query: ListActivitiesQueryDto, trả Promise<Activity[]>), DELETE /activities?olderThanDays=N (@Query('olderThanDays', { schema: z.coerce.number().int().min(0) }), trả { deleted }) và:
- src/activities/activities.controller.ts (đoạn trích, ParseObjectIdPipe từ @nestjs/mongoose, Types từ mongoose)
@Get(':id')
findOne(
@Param('id', ParseObjectIdPipe) id: Types.ObjectId,
): Promise<Activity> {
return this.activitiesService.findOne(id);
}
_id là ObjectId (24 ký tự hex) chứ không phải số; ParseObjectIdPipe trả 400 khi id sai định dạng.
5. Ghi nhật ký khi thay đổi project và task.
ProjectsModule và TasksModule thêm imports: [ActivitiesModule], service inject ActivitiesService:
- src/projects/projects.service.ts (đoạn trích, constructor thêm private readonly activities: ActivitiesService)
private log(
entityId: number,
action: NewActivity['action'],
data?: object,
): void {
this.activities.log({ entity: 'project', entityId, action, data });
}
create() gọi this.log(project.id, 'created', { name: project.name }) trước khi trả về, update() gọi this.log(id, 'updated', dto), remove() gọi this.log(id, 'deleted'); TasksService tương tự với entity: 'task'. Tắt MongoDB thì POST /projects vẫn trả 201 ngay. Hai file projects.*.spec.ts thêm { provide: ActivitiesService, useValue: {} }. Nhân tiện, ParseIdPipe thêm giới hạn trên 2_147_483_647 để /tasks/3000000000 trả 400 thay vì 500.
Reset dữ liệu (npx prisma migrate reset --force, npx prisma db seed, xoá nhật ký bằng DELETE /api/v1/activities?olderThanDays=0) rồi thử:
curl http://localhost:3000/api/v1/projects -H "$K" -H "Content-Type: application/json" -d '{"name":"Blog"}'
curl http://localhost:3000/api/v1/tasks -H "$K" -H "Content-Type: application/json" \
-d '{"projectId":3,"title":"Viết bài MongoDB"}'
curl -X DELETE http://localhost:3000/api/v1/tasks/1 -H "$K"
curl "http://localhost:3000/api/v1/activities?limit=2" -H "$K"
# {"data":[{"_id":"6af974b7bfa1840c93493837","entity":"task","entityId":1,"action":"deleted","createdAt":"..."},
# {"_id":"6af974b7bfa1840c93493836",...,"action":"created","data":{"title":"Viết bài MongoDB","projectId":3},...}]}
curl "http://localhost:3000/api/v1/activities?entity=project&entityId=3" -H "$K"
# {"data":[{...,"entity":"project","entityId":3,"action":"created","data":{"name":"Blog"},...}]}
curl http://localhost:3000/api/v1/activities/abc -H "$K"
# {"statusCode":400,...,"message":"Invalid ObjectId: 'abc' is not a valid MongoDB ObjectId",...}
6. Lời kết.
Như vậy mình đã giới thiệu với mọi người về MongoDB với Mongoose trong NestJS: khi nào chọn MongoDB, MongooseModule, schema, model và CRUD cho activity log. Hiện project luôn thuộc user 1, bài sau mình sẽ giới thiệu về xác thực với JWT trong NestJS.
Đăng ký nhận tin.
Chúng tôi chỉ gửi tối đa 2 lần trên 1 tháng. Tuyên bố không spam mail!





0 Comments