mquery().find(match, function (err, docs) { 
    assert(Array.isArray(docs)); 
}) 
mquery().findOne(match, function (err, doc) {
    if (doc) { 
        // the document may not be found 
        console.log(doc); 
    } 
}) 
mquery().update(match, updateDocument, options, function (err, result){})

看起来是和ORM很像，我们看看其他场景：

mquery().find(match, function (err, docs) { 
    assert(Array.isArray(docs)); 
}) 
mquery().findOne(match, function (err, doc) {
    if (doc) { 
        // the document may not be found 
        console.log(doc); 
    } 
}) 
mquery().update(match, updateDocument, options, function (err, result){})

在ORM中，通常不会存在这样的多个方法链式调用，而是通过单个方法+多个参数的方式来操作，这也是Query Builder和ORM的一个重要差异。再来看看TypeORM的Query Builder模式：

import { getConnection } from "typeorm"; 
const user = await getConnection() 
    .createQueryBuilder() 
    .select("user") 
    .from(User, "user") 
    .where("user.id = :id", { id: 1 }) 
    .getOne();

以上的操作其实就相当于userRepo.find({ id: 1 })，你可能会觉得QB的写法过于繁琐，但实际上这种模式要灵活的多，和SQL语句的距离也要近的多（你可以理解为每一个链式方法调用都会对最终生成的SQL语句进行一次操作）。

同时在部分情境（如多级级联下）中，Query Builder反而是代码更简洁的那一方，如：

const selectQueryBuilder = this.executorRepository 
    .createQueryBuilder("executor") 
    .leftJoinAndSelect("executor.tasks", "tasks") 
    .leftJoinAndSelect("executor.relatedRecord", "records") 
    .leftJoinAndSelect("records.recordTask", "recordTask") 
    .leftJoinAndSelect("records.recordAccount", "recordAccount") 
    .leftJoinAndSelect("records.recordSubstance", "recordSubstance") 
    .leftJoinAndSelect("tasks.taskSubstance", "substance");

以上代码构建了一个包含多张表的级联关系的Query Builder。

级联关系如下：

Executor

tasks -> Task

relatedRecord -> Record

Task

substances -> Substance

Record

recordTask -> Task

recordAccount -> Account

recordSubstance -> Substance

knext.js

目前主流的QB是knext.js, Bookshelf.js和Objection.js的QB都是基于此来实现的，我们看下其具体使用：

const knex = require('knex')({
  client: 'sqlite3',
  connection: {
    filename: './data.db',
  },
});
 
try {
 
  await knex.schema
    .createTable('users', table => {
      table.increments('id');
      table.string('user_name');
    })
    .createTable('accounts', table => {
      table.increments('id');
      table.string('account_name');
      table
        .integer('user_id')
        .unsigned()
        .references('users.id');
    })
 
  const insertedRows = await knex('users').insert({ user_name: 'Tim' })
 
  await knex('accounts').insert({ account_name: 'knex', user_id: insertedRows[0] })
 
  const selectedRows = await knex('users')
    .join('accounts', 'users.id', 'accounts.user_id')
    .select('users.user_name as user', 'accounts.account_name as account')
 
  const enrichedRows = selectedRows.map(row => ({ ...row, active: true }))
 
} catch(e) {
  console.error(e);
};

可以看到knex的链式操作更进了一步，甚至可以链式创建多张数据库表。

Nest官方也提供了动态模块的方式来实现Nest项目内Knext的使用，具体参考：https://dev.to/nestjs/build-a-nestjs-module-for-knex-js-or-other-resource-based-libraries-in-5-minutes-12an和https://github.com/nestjsplus/knex以及https://github.com/nestjsplus/knex-cats

趋势

prisma官网有对2022年前11的DB查询工具的活跃度介绍，总结的较为全面，这里也贴一下当前介绍的几种ORM和QueryBuilder的NPM Trending。

总结：prisma近几年越来越被开发者接受，社区活跃度高；TypeORM做为Nest官方推荐的ORM框架和TS支持，也有很高的下载量；Sequelize做为老牌的ORM下载量最大，且趋于稳定，但社区活跃度不高。

业界mysql的实践方案调研

业界mysql的实践方案调研

分类

手写 SQL

SQL 构造器

ORM

调研情况

ORM

Sequelize

TypeORM

Prisma

SQL 构造器

knext.js

趋势