自從我開始開發(fā)我的第一個(gè)專案（我的 OT Pokémon 和 Habbo 的第一個(gè)網(wǎng)站）以來，我一直選擇 Raw SQL。老實(shí)說，我仍然非常喜歡編寫自己的查詢並更精確地控制這個(gè)「低級(jí)」層。 ORM 並不讓我完全放心，因?yàn)槲乙呀?jīng)花了幾天時(shí)間分析日誌來識(shí)別和優(yōu)化低效查詢。

但是，在我使用 Raw SQL 的許多程式碼庫中，絕大多數(shù)沒有遷移控制，而且資料庫也沒有受到監(jiān)控。一切都在即興創(chuàng)作的基礎(chǔ)上進(jìn)行：「您需要一個(gè)新字段嗎？運(yùn)行ALTER TABLE 並添加一個(gè)新列。」這種方法在所有場景下都是極其有害的，出現(xiàn)了幾個(gè)問題，例如：“我們應(yīng)該在生產(chǎn)環(huán)境中上哪些列？”，“創(chuàng)建了哪些新實(shí)體？”，“環(huán)境是否同步？” - 以及許多其他類似的問題。

我的問題的解決方案

面對所有這些問題，我決定採用新的工具來讓我和與我一起工作的團(tuán)隊(duì)的日常工作變得更健康。我不想放棄我所擁有的靈活性，但我也想更好地控制應(yīng)用程式的自由度。經(jīng)過大量研究，我發(fā)現(xiàn)了一個(gè)我認(rèn)為最完整的解決這些問題的工具：Kysely，它是TypeScript 的查詢構(gòu)建器，除了實(shí)用之外，還是完全類型安全的—對我來說非常重要的一點(diǎn)。這個(gè)函式庫引起了我的注意，以至於我開始直接和間接地積極為社群做出貢獻(xiàn)，為與 Kysely 整合的其他開源函式庫創(chuàng)建插件。

然而，使用 Kysely 時(shí)最大的困難之一是，與 ORM 不同，它沒有實(shí)體或自動(dòng)產(chǎn)生類型/介面。所有這些工作都需要手動(dòng)完成，這可能有點(diǎn)累人。在研究解決方案的過程中，我發(fā)現(xiàn)了一個(gè)最終在所有涉及 PostgreSQL 的專案中採用的工具：Kanel。 Kanel 自動(dòng)產(chǎn)生資料庫類型，完美補(bǔ)充了 Kysely。

此外，Kanel 還有一個(gè)可以直接與 Kysely 一起使用的附加功能：Kanel-Kysely。我一直在積極為這個(gè)儲(chǔ)存庫做出貢獻(xiàn)，幫助開發(fā)新功能，例如遷移表的類型過濾器以及 Zod 物件到駝峰命名法的轉(zhuǎn)換。

配置 Kysely

我將使用 NestJS 來說明以下範(fàn)例。因此，如果您不理解某些語法或程式碼中的某些內(nèi)容，我建議您閱讀 NestJS 文件。在我看來，它是最好的 JavaScript 框架——特別是如果你想「逃避」JavaScript。但這是我另一篇文章的主題。

如果您想嚴(yán)格遵循範(fàn)例，您需要先初始化一個(gè)帶有 NestJS 的儲(chǔ)存庫。不過，您也可以開發(fā)自己的程式碼。

首先，我們需要安裝 Kysely 本身、它的 CLI 和 Node.js 的 PostgreSQL 模組。

npm i kysely pg && npm i kysely-ctl --save-dev

接下來，我們需要在專案的根目錄中為 Kysely 建立一個(gè)設(shè)定檔。我還將為我們的遷移和種子檔案使用 Knex 前綴。

// kysely.config.ts

import "dotenv/config";

import { defineConfig, getKnexTimestampPrefix } from "kysely-ctl";
import { Pool } from "pg";

export default defineConfig({
  dialect: "pg",
  dialectConfig: {
    pool: new Pool({ connectionString: process.env.DATABASE_URL }),
  },
  migrations: {
    migrationFolder: "src/database/migrations",
    getMigrationPrefix: getKnexTimestampPrefix,
  },
  seeds: {
    seedFolder: "src/database/seeds",
    getSeedPrefix: getKnexTimestampPrefix,
  },
});

接下來，我們將在終端機(jī)中執(zhí)行指令 npx kysely migrate make create_user_table。它將負(fù)責(zé)創(chuàng)建我們的第一個(gè)遷移。接下來，我們將建立一個(gè)新的使用者表，完成後，我們將使用命令 npx kysely migratelatest.
在資料庫中執(zhí)行此遷移

// 20241225222128_create_user_table.ts

import { sql, type Kysely } from 'kysely'


export async function up(db: Kysely<any>): Promise<void> {
  await db.schema
  .createTable("user")
  .addColumn("id", "serial", (col) => col.primaryKey())
  .addColumn("name", "text", (col) => col.notNull())
  .addColumn("email", "text", (col) => col.unique().notNull())
  .addColumn("password", "text", (col) => col.notNull())
  .addColumn("created_at", "timestamp", (col) =>
    col.defaultTo(sql`now()`).notNull(),
  )
  .execute();
}

export async function down(db: Kysely<any>): Promise<void> {
  await db.schema.dropTable("user").execute();
}

完成所有這些步驟後，讓我們?yōu)槲覀兊馁Y料庫建立一個(gè)模組。另請注意，我正在使用 Kysely 外掛程式將我們的列轉(zhuǎn)換為駝峰命名法。

// src/database/database.module.ts

import { EnvService } from "@/env/env.service";
import { Global, Logger, Module } from "@nestjs/common";
import { CamelCasePlugin, Kysely, PostgresDialect } from "kysely";
import { Pool } from "pg";

export const DATABASE_CONNECTION = "DATABASE_CONNECTION";

@Global()
@Module({
  providers: [
    {
      provide: DATABASE_CONNECTION,
      useFactory: async (envService: EnvService) => {
        const dialect = new PostgresDialect({
          pool: new Pool({
            connectionString: envService.get("DATABASE_URL"),
          }),
        });

        const nodeEnv = envService.get("NODE_ENV");

        const db = new Kysely({
          dialect,
          plugins: [new CamelCasePlugin()],
          log: nodeEnv === "dev" ? ["query", "error"] : ["error"],
        });

        const logger = new Logger("DatabaseModule");

        logger.log("Successfully connected to database");

        return db;
      },
      inject: [EnvService],
    },
  ],
  exports: [DATABASE_CONNECTION],
})
export class DatabaseModule {}

配置 Kanel

讓我們從安裝依賴項(xiàng)開始。

npm i kanel kanel-kysely --save-dev

接下來，讓我們?yōu)?Kanel 建立設(shè)定檔以開始工作。請注意，我將使用一些插件，例如camelCaseHook（將我們的介面轉(zhuǎn)換為camelCase）和kyselyTypeFilter（以排除Kysely的遷移表），我很高興能夠貢獻(xiàn)這些功能之一，並使我們的工作甚至更容易。

// .kanelrc.js

require("dotenv/config");

const { kyselyCamelCaseHook, makeKyselyHook, kyselyTypeFilter } = require("kanel-kysely");

/** @type {import('kanel').Config} */
module.exports = {
  connection: {
    connectionString: process.env.DATABASE_URL,
  },
  typeFilter: kyselyTypeFilter,
  preDeleteOutputFolder: true,
  outputPath: "./src/database/schema",
  preRenderHooks: [makeKyselyHook(), kyselyCamelCaseHook],
};

建立檔案後，我們將在終端機(jī)中執(zhí)行指令 npx kanel。請注意，在設(shè)定檔中指定的路徑中建立了一個(gè)目錄。此目錄對應(yīng)於您的架構(gòu)的名稱，在我們的範(fàn)例中為Public，其中我們有兩個(gè)新檔案：PublicSchema.ts 和User.ts 。您的 User.ts 可能看起來完全像這樣：

// @generated
// This file is automatically generated by Kanel. Do not modify manually.

import type { ColumnType, Selectable, Insertable, Updateable } from 'kysely';

/** Identifier type for public.user */
export type UserId = number & { __brand: 'UserId' };

/** Represents the table public.user */
export default interface UserTable {
  id: ColumnType<UserId, UserId | undefined, UserId>;

  name: ColumnType<string, string, string>;

  email: ColumnType<string, string, string>;

  password: ColumnType<string, string, string>;

  createdAt: ColumnType<Date, Date | string | undefined, Date | string>;
}

export type User = Selectable<UserTable>;

export type NewUser = Insertable<UserTable>;

export type UserUpdate = Updateable<UserTable>;

不過，最重要的是這個(gè)目錄之外的檔案Public，檔案Database.ts，因?yàn)槲覀円獋鬟f的正是這個(gè)，以便Kysely能夠理解我們資料庫的整個(gè)結(jié)構(gòu)。在我們的檔案 app.service.ts 中，我們將注入 DatabaseModule 提供者並將我們的類型 Database.
傳遞給 Kysely

npm i kysely pg && npm i kysely-ctl --save-dev

請注意，Kanel 產(chǎn)生的類型運(yùn)作正常，因?yàn)槲覀兊某淌酱a編輯器將準(zhǔn)確建??議我們在第一次遷移中建立的欄位。

最後的考慮因素

這是我非常喜歡在我的個(gè)人專案甚至工作中使用的組合（當(dāng)我有自由這樣做時(shí)）。對於喜歡原始 SQL 提供的靈活性但也選擇「更安全」路徑的每個(gè)人來說，查詢產(chǎn)生器都是必不可少的工具。 Kanel 還為我節(jié)省了許多時(shí)間的調(diào)試和創(chuàng)建新類型的時(shí)間。我強(qiáng)烈建議你用這兩個(gè)創(chuàng)建一個(gè)項(xiàng)目，你絕對不會(huì)後悔的。

儲(chǔ)存庫連結(jié)： Frankenstein-nodejs

以上是基斯利·卡內(nèi)爾 (Kisley Kanel)：完美二人組的詳細(xì)內(nèi)容。更多資訊請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！