پریسما چیه؟

معرفی

“Prisma” نوع جدیدی از ابزار ORM Data Mapper است که به عنوان رابط بین برنامه وب و پایگاه داده مورد علاقه شما عمل می کند. این پیچیدگی های ارتباط با سرور را انتزاعی می کند و به شما امکان می دهد به لطف مدل داده بصری، مهاجرت های خودکار، ایمنی نوع و تکمیل خودکار، به جای فکر کردن در مورد پرس و جوی SQL بعدی، روی ساخت برنامه خود تمرکز کنید.

شروع شدن

برای شروع کار با Prisma، باید با مجموعه ابزارهای فهرست شده در زیر آشنا باشید

مشتری Prisma
Prisma Client یکی از اجزای اصلی کیت ابزار پایگاه داده Prisma است و به قدری مهم است که اغلب از آن به سادگی “Prisma” یاد می شود. این برنامه توسعه دهندگان را قادر می سازد تا با پایگاه داده خود به روشی یکپارچه و کارآمد تعامل داشته باشند.

Prisma Client یک جزء اصلی از مجموعه ابزار پایگاه داده Prisma است و آنقدر مهم است که اغلب به سادگی به عنوان “Prisma” شناخته می شود.

در هسته خود، Prisma Client یک سرویس گیرنده پایگاه داده ایمن نوع است که بر اساس طرحواره Prisma شما ایجاد می شود. این بدان معناست که هر درخواستی که با استفاده از Prisma Client انجام می‌دهید توسط طرح اعتبارسنجی می‌شود و اطمینان حاصل می‌کند که همیشه با داده‌های معتبر کار می‌کنید. Prisma Client طیف گسترده ای از ویژگی ها را برای کار با پایگاه داده شما فراهم می کند، از جمله عملیات اصلی CRUD، فیلتر کردن، مرتب سازی و تجمیع.

Prisma Schema مانند دستورالعمل یک پازل است که به شما می گوید همه قطعات کجا می روند. این طرح به Prisma می گوید که پایگاه داده شما چگونه است و چگونه سازماندهی شده است.

یکی از مزایای کلیدی Prisma Client سهولت استفاده از آن است. ایجاد Prisma Client یک فرآیند ساده است که در زیر در این مقاله به آن پرداخته خواهد شد و تنها چند دقیقه طول می کشد و پس از راه اندازی آن، می توانید با استفاده از جاوا اسکریپت آشنا با پایگاه داده خود تعامل برقرار کنید | نحو تایپ اسکریپت. با Prisma Client، لازم نیست نگران نوشتن پرس و جوهای پیچیده SQL یا رسیدگی به جزئیات پایگاه داده سطح پایین باشید. در عوض، می‌توانید روی ساخت برنامه‌های شگفت‌انگیز تمرکز کنید که بیشترین استفاده را از داده‌های شما می‌کنند.

راه اندازی / نصب پریسما

• برای شروع ابتدا باید آن را در پروژه خود نصب کنید

npm install prisma --save-dev
npx prisma

• سپس ادامه دهید و a ایجاد کنید prisma.schema فایل. این فایل شمای پایگاه داده شما را تعریف می کند و به عنوان پایه ای برای ایجاد Prisma Client شما عمل می کند.

در اینجا مثالی از اینکه یک فایل طرحواره Prisma ممکن است برای یک سیستم احراز هویت شبیه باشد آورده شده است:

datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
}

generator client {
  provider = "prisma-client-js"
}

model User {
  id       Int      @id @default(autoincrement())
  email    String   @unique
  password String
}

در این مثال، ما یک منبع داده به نام تعریف کرده ایم دسی بی که از PostgreSQL به عنوان ارائه دهنده استفاده می کند. ما همچنین یک ژنراتور به نام تعریف کرده ایم مشتری که از ارائه دهنده Prisma Client استفاده می کند. در نهایت مدلی به نام تعریف کردیم کاربر که دارای یک شناسه فیلدی که به صورت خودکار افزایش می یابد پست الکترونیک زمینه ای که منحصر به فرد است و الف کلمه عبور رشته.

برای استفاده از این طرح در کد خود، ابتدا باید Prisma Client خود را ایجاد کنید. با اجرای دستور زیر می توانید این کار را انجام دهید:

Prisma Client را نصب کنید

npm install @prisma/client

این دستور نیز اجرا می شود prisma generate دستور، که Prisma Client را تولید می کند، سپس می توانید از Prisma Client برای ارسال پرس و جو به پایگاه داده خود استفاده کنید. در زیر یک قطعه است

import { PrismaClient } from '@prisma/client'

const prisma = new PrismaClient()
// use `prisma` in your application to read and write data in your DB

برای استفاده از این طرح در کد خود، ابتدا باید Prisma Client خود را ایجاد کنید. با اجرای دستور زیر می توانید این کار را انجام دهید:

npx prisma generate

هنگامی که Prisma Client خود را ایجاد کردید، می توانید از آن در کد خود برای تعامل با پایگاه داده خود استفاده کنید. در اینجا مثالی از نحوه استفاده از Prisma Client برای ایجاد یک کاربر جدید آورده شده است:

const { PrismaClient } = require('@prisma/client')

const prisma = new PrismaClient()

async function createUser(email, password) {
  const newUser = await prisma.user.create({
    data: {
      email: email,
      password: password
    }
  })

  return newUser
}

createUser('test@example.com', 'password123')
  .then(user => console.log(user))
  .catch(error => console.error(error))

در این مثال، ما یک تابع به نام ایجاد کرده ایم createUser که طول می کشد email و password به عنوان استدلال ما از Prisma Client برای ایجاد یک کاربر جدید با موارد مشخص شده استفاده می کنیم email و passwordو سپس کاربر جدید را برگردانید. ما همچنین برخی از مدیریت خطا را در صورت بروز مشکل در نظر گرفته‌ایم.

Prisma Migrate

Prisma Migrate یک ابزار قدرتمند است که مدیریت مهاجرت های پایگاه داده در پروژه های Prisma را آسان می کند. با Prisma Migrate می توانید به راحتی تغییرات طرحواره پایگاه داده را به صورت ایمن و کنترل شده ایجاد، اصلاح و برگردانید.

برای ایجاد یک مهاجرت جدید، می توانید دستور زیر را اجرا کنید:

npx prisma migrate dev --name init

با این کار یک دایرکتوری جدید به نام ایجاد می شود مهاجرت ها در دایرکتوری ریشه پروژه شما، همراه با یک فایل مهاجرت جدید به نام “init”. شما می توانید این فایل مهاجرت را ویرایش کنید تا تغییرات طرح مورد نظر خود را تعریف کنید.

// migrations/20220227150000_init.js

در صورتی که به هر دلیلی نیاز به بازگشت مجدد مهاجرت دارید، می توانید از دستور زیر استفاده کنید:

npx prisma migrate reset

برای اطلاعات در مورد مهاجرت MongoDB اینجا را بخوانید

استودیو پریسما

Prisma Studio ابزار بصری است که به شما امکان می دهد با استفاده از یک رابط کاربری گرافیکی با پایگاه داده خود تعامل داشته باشید. در اینجا نحوه راه اندازی Prisma Studio و اعمال آن بر روی طرحی که قبلا ایجاد کردیم، آمده است

Prisma Studio در واقع به عنوان بخشی از Prisma CLI گنجانده شده است، به این معنی که زمانی که Prisma را با استفاده از npm یا yarn نصب می کنید، به طور خودکار نصب می شود.

برای راه اندازی استودیو Prisma، کافی است این را در ترمینال خود اجرا کنید:

npx prisma studio

با این کار رابط کاربری Prisma Studio در مرورگر وب پیش‌فرض شما باز می‌شود. این دستور تا زمانی که شما Prisma را نصب کرده باشید و در دایرکتوری قرار داشته باشید که حاوی یک فایل طرحواره Prisma است کار می کند.

هنگامی که به پایگاه داده خود متصل شدید، یک نمایش گرافیکی از طرح خود را در سمت چپ استودیو Prisma مشاهده خواهید کرد. برای مشاهده و ویرایش داده های هر مدل و همچنین افزودن و حذف رکوردها می توانید روی هر مدل کلیک کنید.

به عنوان مثال، فرض کنید می خواهیم یک کاربر جدید به پایگاه داده خود اضافه کنیم. ما می توانیم این کار را با کلیک بر روی کاربر در قسمت سمت چپ مدل کنید و سپس روی دکمه «ایجاد کاربر جدید» کلیک کنید. با این کار فرمی ظاهر می شود که می توانیم اطلاعات کاربر جدید را وارد کنیم.

هنگامی که اطلاعات کاربر را وارد کردیم و روی دکمه “ایجاد” کلیک کردیم، استودیو Prisma کاربر جدید را به پایگاه داده ما اضافه می کند و نمایش گرافیکی طرحواره ما را بر اساس آن به روز می کند.

در نتیجه

اگرچه، Prisma اولین ابزار ORM نیست، اما یک تغییر دهنده بازی برای توسعه دهندگانی است که به دنبال ساده سازی گردش کار پایگاه داده خود و ساخت برنامه های شگفت انگیز سریعتر از همیشه هستند. Prisma با قابلیت‌های مدل‌سازی داده بصری، تولید کلاینت پایگاه‌داده ایمن و ویژگی‌های جستجوی قدرتمند، روش تعامل ما با پایگاه‌های داده را متحول کرده است. Prisma با حذف نیاز به پرسش‌های خسته‌کننده SQL و ساده‌سازی مدیریت پایگاه داده، به توسعه‌دهندگان اجازه می‌دهد تا روی ساختن آنچه به بهترین شکل انجام می‌دهند تمرکز کنند – برنامه‌های کاربردی عالی.

منابع