pengenalan

Drizzle ORM ialah ORM yang ringkas dan ringan untuk TypeScript. Ia direka bentuk untuk mudah digunakan dan mudah difahami. Ia direka bentuk untuk digunakan dengan pangkalan data MySQL, tetapi boleh diperluaskan dengan mudah untuk berfungsi dengan pangkalan data lain.

Mulakan

Drizzle ORM menyokong PostgreSQL, MySQL dan SQLite. Panduan ini akan menumpukan pada MySQL, tetapi konsepnya adalah sama untuk semua pangkalan data.
Anda boleh menghubungi butiran lanjut tentang Drizzle ORM

Pemasangan

Untuk memasang Drizzle ORM, anda perlu memasang pakej daripada npm.

npm i drizzle-orm pg dotenv
npm i -D drizzle-kit tsx @types/pg

npm i drizzle-orm pg dotenv - Perintah ini memasang pakej Drizzle ORM, pakej pg dan pakej dotenv. Pakej pg diperlukan untuk sokongan PostgreSQL, tetapi ia tidak diperlukan untuk MySQL atau SQLite.

npm i -D drizzle-kit tsx @types/pg - Perintah ini memasang pakej Drizzle Kit, pakej tsx dan pakej @types/pg. Pakej Drizzle Kit diperlukan untuk Drizzle ORM berfungsi dengan TypeScript.

Konfigurasi

Untuk mengkonfigurasi Drizzle ORM, anda perlu mencipta fail .env dalam akar projek anda. Fail ini harus mengandungi maklumat berikut:

DATABASE_URL=your-database-url

Gantikan url-pangkalan data anda dengan URL pangkalan data anda. Sebagai contoh, jika anda menggunakan MySQL, URL sepatutnya kelihatan seperti ini:

DATABASE_URL=mysql://username:password@localhost:3306/database

Sediakan konfigurasi gerimis dalam fail drizzle.config.ts anda.

import 'dotenv/config';
import { defineConfig } from 'drizzle-kit';

export default defineConfig({
  out: './drizzle',
  schema: './src/db/schema.ts',
  dialect: 'postgresql',
  dbCredentials: {
    url: process.env.DATABASE_URL!,
  },
});

?Buat Jadual

Untuk mencipta jadual dalam pangkalan data anda, anda perlu mentakrifkan skema dalam fail yang dipanggil schema.ts. Fail ini harus mengandungi maklumat berikut:

import { pgTable, unique, integer, varchar } from 'drizzle-orm/pg-core';
import { sql } from 'drizzle-orm';

export const users = pgTable(
  'users',
  {
    id: integer().primaryKey().generatedAlwaysAsIdentity({
      name: 'users_id_seq',
      startWith: 1,
      increment: 1,
      minValue: 1,
      maxValue: 2147483647,
      cache: 1,
    }),
    name: varchar({ length: 255 }).notNull(),
    age: integer().notNull(),
    email: varchar({ length: 255 }).notNull(),
  },
  (table) => {
    return {
      usersEmailUnique: unique('users_email_unique').on(table.email),
    };
  }
);

Kami mentakrifkan jadual yang dipanggil pengguna dengan empat lajur: id, nama, umur dan e-mel. Lajur id ialah kunci utama yang meningkat secara automatik dan lajur nama, umur dan e-mel diperlukan.

?Sambung ke Pangkalan Data

Buat fail index.ts dalam direktori src/db dan mulakan sambungan ke pangkalan data.

import 'dotenv/config';
import { drizzle } from 'drizzle-orm/node-postgres';

const db = drizzle(process.env.DATABASE_URL!);

Kami telah pun mentakrifkan DATABASE_URL dalam fail .env. Kami menggunakan fungsi gerimis untuk menyambung ke pangkalan data.

?Sisipkan Data

Untuk memasukkan data ke dalam jadual pengguna, anda boleh menggunakan kaedah sisipan pada objek db.

import { users } from './schema';

const user = await db.insert(users).values({
  name: 'John Doe',
  age: 30,
  email: '
});

Kami menggunakan kaedah sisipan pada objek db untuk memasukkan pengguna baharu ke dalam jadual pengguna. Kami menghantar objek dengan nama, umur dan sifat e-mel kepada kaedah nilai.

?Data Pertanyaan

Untuk menanyakan data daripada jadual pengguna, anda boleh menggunakan kaedah pilih pada objek db.

npm i drizzle-orm pg dotenv
npm i -D drizzle-kit tsx @types/pg

Kami menggunakan kaedah pilih pada objek db untuk menanyakan pengguna daripada jadual pengguna. Kami menggunakan kaedah where untuk menapis hasil berdasarkan lajur id.

?Kemas kini Data

Untuk mengemas kini data dalam jadual pengguna, anda boleh menggunakan kaedah kemas kini pada objek db.

DATABASE_URL=your-database-url

Kami menggunakan kaedah kemas kini pada objek db untuk mengemas kini pengguna dalam jadual pengguna. Kami menggunakan kaedah yang ditetapkan untuk menetapkan lajur umur kepada 31, dan kaedah di mana untuk menapis hasil berdasarkan lajur id.

?Padamkan Data

Untuk memadam data daripada jadual pengguna, anda boleh menggunakan kaedah padam pada objek db.

DATABASE_URL=mysql://username:password@localhost:3306/database

Kami menggunakan kaedah padam pada objek db untuk memadam pengguna daripada jadual pengguna. Kami menggunakan kaedah where untuk menapis hasil berdasarkan lajur id.

Kesimpulan

Drizzle ORM ialah ORM yang ringkas dan ringan untuk TypeScript. Ia direka bentuk untuk mudah digunakan dan mudah difahami. Ia direka bentuk untuk digunakan dengan pangkalan data MySQL, tetapi boleh diperluaskan dengan mudah untuk berfungsi dengan pangkalan data lain. Anda boleh menghubungi butiran lanjut tentang Drizzle ORM

Terima kasih

Terima kasih kerana membaca panduan ini. Saya harap anda mendapati ia membantu. Jika anda mempunyai sebarang soalan atau maklum balas, sila hubungi saya. Saya ingin mendengar daripada anda.

Atas ialah kandungan terperinci Gerimis ORM Crash Course. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!