اتصال به دیتابیس با استفاده از Prisma در برنامههای NodeJS
Prisma یک ORM متنباز و شامل سه بخش زیر است:
- Prisma Client: یک کوئریساز auto-generated و type-safe برای NodeJS و TypeScript
- Prisma Migrate: سیستم مدیریت migrationها در دیتابیس
- Prisma Studio: رابط گرافیکی برای مشاهده و ویرایش دادهها در دیتابیس
Prisma Client میتواند در هر برنامهی NodeJS یا TypeScript مورد استفاده قرار گیرد، از جمله برنامههای serverless و میکروسرویسها. در ادامه، به نحوه استفاده از این ORM با دیتابیس PostgreSQL و نحوه استقرار برنامههای مبتنی بر آن در لیارا، پرداخته شده است.
برای استفاده از این ORM، در ابتدا باید با اجرای دستور زیر در خط فرمان سیستم خود، فایلهای Migration را ایجاد کنید:
ایجاد یک پروژه NodeJS
با اجرای دستورات زیر، محیط پروژه NodeJS خود را ایجاد کنید:
نصب پکیجهای مورد نیاز
با اجرای دستورات زیر، تمامی پکیجها و ابزارهای مورد نیاز برنامه را، نصب کنید:
راهاندازی و پیکربندی Prisma
با اجرای دستور زیر، Prisma را در برنامه خود، راهاندازی کنید:
دستور فوق، چندین فایل مرتبط با prisma را در پروژهتان، ایجاد میکند. درون فایل env.، متغیر DATABASE_URL را مشابه زیر، مقداردهی کنید:
مقدار متغیر فوق را با اطلاعات دیتابیس PostgreSQL خود، آپدیت کنید.
در ادامه، قطعه کد زیر را جایگزین کد فعلی فایل prisma/schema.prisma کنید:
ایجاد migrationها
با اجرای دستور زیر، migrationها را قبل از استقرار برنامه، تولید کنید:
ایجاد و پیکربندی برنامه اصلی
مسیر src/server.ts را ایجاد کنید و قطعه کد زیر را، درون آن، قرار دهید:
در مسیر اصلی پروژه، یک فایل به نام tsconfig.json ایجاد کنید و قطعه کد زیر را درون آن، قرار دهید:
آمادهسازی برنامه برای استقرار
بخش scripts را مانند زیر در فایل package.json تغییر دهید:
همچنین، یک فایل در مسیر اصلی پروژه، به نام liara_pre_start.sh ایجاد کنید و قطعه کد زیر را، درون آن، قرار دهید:
استقرار برنامه در لیارا
متغیر DATABASE_URL تعریف شده در فایل env. را طبق مستندات تنظیم متغیرهای محیطی در برنامه، به برنامه خود اضافه کنید.
در صورت استفاده از دیتابیس PostgreSQL لیارا، توصیه میشود هم برنامه و هم دیتابیس را در یک شبکه خصوصی قرار دهید و برای ایجاد اتصال ایمن و مطمئن از URI شبکه خصوصی دیتابیس استفاده کنید.
در نهایت، طبق مستندات ساخت برنامه NodeJS، یک برنامه NodeJS ایجاد کنید و با اجرای دستور زیر با استفاده از Liara CLI، برنامه خود را در لیارا، مستقر کنید:
یک پروژه NodeJS مبتنی بر Prisma در گیتهاب لیارا وجود دارد که میتوانید از آن، استفاده کنید.




















