Rumah hujung hadapan web tutorial js Kisley Kanel: pasangan yang sempurna

Kisley Kanel: pasangan yang sempurna

Jan 03, 2025 pm 09:05 PM

Saya seorang yang, sejak saya mula membangunkan projek pertama saya (Pokemon OT saya dan tapak web pertama saya untuk Habbo), saya sentiasa memilih SQL Mentah. Secara jujur, saya masih sangat seronok menulis pertanyaan saya sendiri dan mempunyai kawalan yang lebih tepat ke atas lapisan "tahap rendah" ini. ORM tidak membuatkan saya selesa sepenuhnya, kerana saya telah menghabiskan masa berhari-hari menganalisis log untuk mengenal pasti dan mengoptimumkan pertanyaan yang tidak cekap.

Walau bagaimanapun, dalam banyak pangkalan kod tempat saya bekerja dengan Raw SQL, sebahagian besarnya tidak mempunyai kawalan penghijrahan dan pangkalan data juga tidak dipantau. Semuanya berfungsi secara improvisasi: "Adakah anda memerlukan medan baharu? Jalankan ALTER JADUAL dan tambah lajur baharu." Pendekatan ini sangat berbahaya dalam semua senario, beberapa soalan timbul, seperti: "Lajur yang manakah harus kita naikkan dalam persekitaran pengeluaran?", "Apakah entiti baharu yang dicipta?", "Adakah persekitaran disegerakkan?" — dan banyak lagi masalah serupa.

Penyelesaian kepada masalah saya

Menghadapi semua masalah ini, saya memutuskan untuk menggunakan alat baharu untuk menjadikan rutin saya dan pasukan yang bekerja dengan saya lebih sihat. Saya tidak mahu melepaskan fleksibiliti yang saya ada, tetapi saya juga mahu mengawal darjah kebebasan aplikasi dengan lebih baik. Selepas banyak penyelidikan, saya menemui alat yang saya anggap paling lengkap untuk menyelesaikan masalah ini: Kysely, ia adalah pembina pertanyaan untuk TypeScript yang, sebagai tambahan kepada praktikal, selamat jenis sepenuhnya — satu perkara yang sangat penting bagi saya. Lib ini menarik perhatian saya sehingga saya mula menyumbang secara aktif kepada komuniti, secara langsung dan tidak langsung, mencipta pemalam untuk perpustakaan sumber terbuka lain yang disepadukan dengan Kysely.

Namun, salah satu kesukaran terbesar apabila bekerja dengan Kysely ialah, tidak seperti ORM, ia tidak mempunyai entiti atau penjanaan jenis/antara muka automatik. Semua kerja ini perlu dilakukan secara manual, yang boleh menjadi agak meletihkan. Semasa penyelidikan saya untuk penyelesaian, saya menemui alat yang akhirnya saya pakai dalam semua projek saya yang melibatkan PostgreSQL: Kanel. Kanel menjana penaipan pangkalan data secara automatik, melengkapkan Kysely dengan sempurna.

Selain itu, Kanel mempunyai ciri tambahan untuk kegunaan langsung dengan Kysely: Kanel-Kysely. Saya telah menyumbang secara aktif kepada repositori ini, membantu membangunkan ciri baharu, seperti penapis jenis untuk jadual migrasi dan penukaran objek Zod kepada camelCase.

Mengkonfigurasi Kysely

Saya akan menggunakan NestJS untuk menggambarkan contoh berikut. Jadi, jika anda tidak memahami beberapa sintaks atau sesuatu dalam kod, saya cadangkan membaca dokumentasi NestJS. Pada pendapat saya, ia adalah rangka kerja JavaScript terbaik — terutamanya jika anda ingin "melarikan diri" JavaScript. Tetapi itu topik untuk catatan saya yang lain.

Sebelumnya, anda perlu mempunyai repositori dengan NestJS yang dimulakan, jika anda ingin mengikuti contoh kepada surat itu. Walau bagaimanapun, anda juga boleh membangunkan kod anda sendiri.

Pada mulanya, kita perlu memasang Kysely itu sendiri, CLI dan modul PostgreSQL untuk Node.js.

npm i kysely pg && npm i kysely-ctl --save-dev
Salin selepas log masuk
Salin selepas log masuk

Seterusnya, kita perlu mencipta fail konfigurasi dalam akar projek untuk Kysely. Saya juga akan menggunakan awalan Knex untuk migrasi dan fail benih kami.

// 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,
  },
});
Salin selepas log masuk

Seterusnya, kami akan menjalankan arahan npx kysely migrate make create_user_table dalam terminal kami. Ia akan bertanggungjawab untuk mencipta penghijrahan pertama kami. Seterusnya, kami akan mencipta jadual pengguna baharu dan, setelah selesai, kami akan menjalankan migrasi ini dalam pangkalan data kami dengan arahan npx kysely migrate latest.

// 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();
}
Salin selepas log masuk

Dengan semua langkah ini selesai, mari buat modul untuk pangkalan data kami. Juga perhatikan bahawa saya menggunakan pemalam Kysely untuk menukar lajur kami kepada camelCase.

// 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 {}
Salin selepas log masuk

Mengkonfigurasi Kanel

Mari kita mulakan dengan memasang kebergantungan kita.

npm i kanel kanel-kysely --save-dev
Salin selepas log masuk

Seterusnya, mari buat fail konfigurasi kami untuk Kanel mula melakukan kerjanya. Ambil perhatian bahawa saya akan menggunakan beberapa pemalam, seperti camelCaseHook (untuk mengubah antara muka kami menjadi camelCase) dan kyselyTypeFilter (untuk mengecualikan jadual penghijrahan Kysely), salah satu daripada ciri ini saya berbesar hati kerana dapat menyumbang dan membuat kerja yang kami ada. lebih mudah .

// .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],
};

Salin selepas log masuk

Setelah fail dibuat, kami akan menjalankan arahan npx kanel di terminal kami. Ambil perhatian bahawa direktori telah dibuat dalam laluan yang ditentukan dalam fail konfigurasi. Direktori ini sepadan dengan nama skema anda, dalam kes kami, Awam, dan di dalamnya kami mempunyai dua fail baharu: PublicSchema.ts dan User.ts . User.ts anda mungkin akan kelihatan seperti ini:

// @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>;

Salin selepas log masuk

Namun, perkara yang paling penting ialah fail di luar direktori ini Awam, fail Pangkalan Data.ts, kerana ini yang akan kami sampaikan supaya Kysely dapat memahami keseluruhan struktur pangkalan data kami. Di dalam fail app.service.ts kami, kami akan menyuntik penyedia DatabaseModule kami dan menyerahkan jenis Pangkalan Data kami.
kepada Kysely

npm i kysely pg && npm i kysely-ctl --save-dev
Salin selepas log masuk
Salin selepas log masuk

Perhatikan bahawa penaipan yang dijana Kanel berfungsi dengan betul, kerana editor kod kami akan mencadangkan dengan tepat lajur yang kami buat dalam penghijrahan pertama kami.

Kysely   Kanel: a dupla perfeita

Pertimbangan akhir

Ini adalah duo yang saya sangat suka gunakan dalam projek peribadi saya dan juga di tempat kerja (apabila saya mempunyai kebebasan untuk berbuat demikian). Pembina pertanyaan ialah alat penting untuk semua orang yang menyukai fleksibiliti yang ditawarkan oleh Raw SQL, tetapi juga memilih laluan "lebih selamat". Kanel juga telah menjimatkan banyak jam menyahpepijat dan mencipta penaipan baharu. Saya amat mengesyorkan anda membuat projek dengan kedua-dua ini, anda pasti tidak akan menyesal.

Pautan Repositori: frankenstein-nodejs

Atas ialah kandungan terperinci Kisley Kanel: pasangan yang sempurna. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!

Kenyataan Laman Web ini
Kandungan artikel ini disumbangkan secara sukarela oleh netizen, dan hak cipta adalah milik pengarang asal. Laman web ini tidak memikul tanggungjawab undang-undang yang sepadan. Jika anda menemui sebarang kandungan yang disyaki plagiarisme atau pelanggaran, sila hubungi admin@php.cn

Alat AI Hot

Undresser.AI Undress

Undresser.AI Undress

Apl berkuasa AI untuk mencipta foto bogel yang realistik

AI Clothes Remover

AI Clothes Remover

Alat AI dalam talian untuk mengeluarkan pakaian daripada foto.

Undress AI Tool

Undress AI Tool

Gambar buka pakaian secara percuma

Clothoff.io

Clothoff.io

Penyingkiran pakaian AI

Video Face Swap

Video Face Swap

Tukar muka dalam mana-mana video dengan mudah menggunakan alat tukar muka AI percuma kami!

Alat panas

Notepad++7.3.1

Notepad++7.3.1

Editor kod yang mudah digunakan dan percuma

SublimeText3 versi Cina

SublimeText3 versi Cina

Versi Cina, sangat mudah digunakan

Hantar Studio 13.0.1

Hantar Studio 13.0.1

Persekitaran pembangunan bersepadu PHP yang berkuasa

Dreamweaver CS6

Dreamweaver CS6

Alat pembangunan web visual

SublimeText3 versi Mac

SublimeText3 versi Mac

Perisian penyuntingan kod peringkat Tuhan (SublimeText3)

Apa yang perlu saya lakukan jika saya menghadapi percetakan kod yang dihiasi untuk resit kertas terma depan? Apa yang perlu saya lakukan jika saya menghadapi percetakan kod yang dihiasi untuk resit kertas terma depan? Apr 04, 2025 pm 02:42 PM

Soalan dan penyelesaian yang sering ditanya untuk percetakan tiket kertas terma depan dalam pembangunan front-end, percetakan tiket adalah keperluan umum. Walau bagaimanapun, banyak pemaju sedang melaksanakan ...

Demystifying JavaScript: Apa yang berlaku dan mengapa penting Demystifying JavaScript: Apa yang berlaku dan mengapa penting Apr 09, 2025 am 12:07 AM

JavaScript adalah asas kepada pembangunan web moden, dan fungsi utamanya termasuk pengaturcaraan yang didorong oleh peristiwa, penjanaan kandungan dinamik dan pengaturcaraan tak segerak. 1) Pengaturcaraan yang didorong oleh peristiwa membolehkan laman web berubah secara dinamik mengikut operasi pengguna. 2) Penjanaan kandungan dinamik membolehkan kandungan halaman diselaraskan mengikut syarat. 3) Pengaturcaraan Asynchronous memastikan bahawa antara muka pengguna tidak disekat. JavaScript digunakan secara meluas dalam interaksi web, aplikasi satu halaman dan pembangunan sisi pelayan, sangat meningkatkan fleksibiliti pengalaman pengguna dan pembangunan silang platform.

Siapa yang dibayar lebih banyak Python atau JavaScript? Siapa yang dibayar lebih banyak Python atau JavaScript? Apr 04, 2025 am 12:09 AM

Tidak ada gaji mutlak untuk pemaju Python dan JavaScript, bergantung kepada kemahiran dan keperluan industri. 1. Python boleh dibayar lebih banyak dalam sains data dan pembelajaran mesin. 2. JavaScript mempunyai permintaan yang besar dalam perkembangan depan dan stack penuh, dan gajinya juga cukup besar. 3. Faktor mempengaruhi termasuk pengalaman, lokasi geografi, saiz syarikat dan kemahiran khusus.

Adakah JavaScript sukar belajar? Adakah JavaScript sukar belajar? Apr 03, 2025 am 12:20 AM

Pembelajaran JavaScript tidak sukar, tetapi ia mencabar. 1) Memahami konsep asas seperti pembolehubah, jenis data, fungsi, dan sebagainya. 2) Pengaturcaraan asynchronous tuan dan melaksanakannya melalui gelung acara. 3) Gunakan operasi DOM dan berjanji untuk mengendalikan permintaan tak segerak. 4) Elakkan kesilapan biasa dan gunakan teknik debugging. 5) Mengoptimumkan prestasi dan mengikuti amalan terbaik.

Bagaimana untuk menggabungkan elemen array dengan ID yang sama ke dalam satu objek menggunakan JavaScript? Bagaimana untuk menggabungkan elemen array dengan ID yang sama ke dalam satu objek menggunakan JavaScript? Apr 04, 2025 pm 05:09 PM

Bagaimana cara menggabungkan elemen array dengan ID yang sama ke dalam satu objek dalam JavaScript? Semasa memproses data, kita sering menghadapi keperluan untuk mempunyai id yang sama ...

Bagaimana untuk mencapai kesan menatal paralaks dan kesan animasi elemen, seperti laman web rasmi Shiseido?
atau:
Bagaimanakah kita dapat mencapai kesan animasi yang disertai dengan menatal halaman seperti laman web rasmi Shiseido? Bagaimana untuk mencapai kesan menatal paralaks dan kesan animasi elemen, seperti laman web rasmi Shiseido? atau: Bagaimanakah kita dapat mencapai kesan animasi yang disertai dengan menatal halaman seperti laman web rasmi Shiseido? Apr 04, 2025 pm 05:36 PM

Perbincangan mengenai realisasi kesan animasi tatal dan elemen Parallax dalam artikel ini akan meneroka bagaimana untuk mencapai yang serupa dengan laman web rasmi Shiseido (https://www.shiseido.co.jp/sb/wonderland/) ... ...

Evolusi JavaScript: Trend Semasa dan Prospek Masa Depan Evolusi JavaScript: Trend Semasa dan Prospek Masa Depan Apr 10, 2025 am 09:33 AM

Trend terkini dalam JavaScript termasuk kebangkitan TypeScript, populariti kerangka dan perpustakaan moden, dan penerapan webassembly. Prospek masa depan meliputi sistem jenis yang lebih berkuasa, pembangunan JavaScript, pengembangan kecerdasan buatan dan pembelajaran mesin, dan potensi pengkomputeran IoT dan kelebihan.

Perbezaan dalam Konsol.Log Output Result: Mengapa kedua -dua panggilan berbeza? Perbezaan dalam Konsol.Log Output Result: Mengapa kedua -dua panggilan berbeza? Apr 04, 2025 pm 05:12 PM

Perbincangan mendalam mengenai punca-punca utama perbezaan dalam output konsol.log. Artikel ini akan menganalisis perbezaan hasil output fungsi Console.log dalam sekeping kod dan menerangkan sebab -sebab di belakangnya. � ...

See all articles