تهيئة قاعدة البيانات بالبيانات واختبارها
تعلّم تهيئة قاعدة بياناتك ببيانات أولية لأغراض التطوير والاختبار، بما يضمن اتساق البيئات.
تهيئة قاعدة البيانات بالبيانات واختبارها درس مجاني في NestJS Enterprise Backend APIs على CoddyKit. هذا هو الدرس 3 من أصل 3. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في NestJS Enterprise Backend APIs، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة NestJS Enterprise Backend APIs 3 دروس في المجموع.
بعض أجزاء هذا الدرس لم تُترجم بعد وتظهر باللغة الإنجليزية.
What is Database Seeding?
Imagine starting a new project or running tests. Your database is empty! Database seeding is the process of populating a database with initial data.
This data can be anything from default user accounts to sample product listings. It's crucial for development, testing, and even for setting up a production environment with essential configuration data.
Benefits of Seeding
Seeding offers several key advantages:
- Consistent Environments: Ensures everyone on the team, and your CI/CD pipeline, works with the same baseline data.
- Faster Development: Developers don't waste time manually entering test data.
- Reliable Testing: Tests run against predictable data, making results more trustworthy.
- Easier Onboarding: New team members can quickly set up their local environment with meaningful data.
NestJS & TypeORM Seeding
In a NestJS application using TypeORM, seeding typically involves creating dedicated scripts that interact with your TypeORM entities and repositories.
While TypeORM itself has a CLI for migrations, for seeding, you often create custom scripts that can be run on demand. These scripts use TypeORM's EntityManager or specific repositories to insert data.
Crafting a Simple Seeder
Let's look at a conceptual example of a seeder script. This script would usually live in a src/database/seeds directory and be executed via a custom npm script.
It uses TypeORM's Repository to create and save a new user, ensuring the data is persisted correctly.
// src/database/seeds/user.seeder.ts
import { DataSource } from 'typeorm';
import { User } from '../../users/user.entity';
import { Seeder, SeederFactoryManager } from 'typeorm-extension';
export default class UserSeeder implements Seeder {
public async run(
dataSource: DataSource,
factoryManager: SeederFactoryManager
): Promise<any> {
const userRepository = dataSource.getRepository(User);
// Check if user already exists to prevent duplicates
let adminUser = await userRepository.findOneBy({ email: 'admin@example.com' });
if (!adminUser) {
adminUser = userRepository.create({
firstName: 'Admin',
lastName: 'User',
email: 'admin@example.com',
password: 'securePassword123', // In real app, hash this!
});
await userRepository.save(adminUser);
console.log('Admin user seeded.');
} else {
console.log('Admin user already exists.');
}
}
}Executing Seeder Scripts
To run your seeders, you typically add a custom script to your package.json. You might use ts-node to execute TypeScript files directly, or compile them first.
A common setup involves a typeorm-extension library which provides a more structured way to manage and run seeders, similar to how migrations are handled.
// package.json snippets
{
"scripts": {
"seed:run": "ts-node -r tsconfig-paths/register ./node_modules/typeorm-extension/dist/cli/index.js seed -d src/config/typeorm.config.ts"
}
}Development Data
For development, seeding often means populating your database with a good amount of realistic-looking data. This helps you test UI components, pagination, and search functionality without manually creating hundreds of entries.
You might use libraries like Faker.js (or @faker-js/faker) within your seeders to generate diverse and random data for users, products, posts, etc.
Test-Specific Data
When it comes to testing, seeding takes on a more precise role. You often need very specific, controlled datasets for your unit and integration tests.
For example, a test for a login feature might only need one specific user record, not hundreds. This ensures your tests are deterministic and don't break due to unexpected data.
Seeding in Test Workflows
To ensure a clean slate for each test run, it's a common practice to run seeders before or after your tests. Jest, a popular testing framework, allows you to define setup and teardown functions.
You could use beforeEach or beforeAll to execute a seeding script, ensuring your database is in a known state before tests begin.
// Conceptual test file snippet
import { INestApplication } from '@nestjs/common';
import { Test } from '@nestjs/testing';
import { AppModule } from './app.module';
import { DataSource } from 'typeorm';
import UserSeeder from './database/seeds/user.seeder'; // Your seeder
describe('UsersController (e2e)', () => {
let app: INestApplication;
let dataSource: DataSource;
beforeAll(async () => {
const moduleFixture = await Test.createTestingModule({
imports: [AppModule],
}).compile();
app = moduleFixture.createNestApplication();
await app.init();
// Get TypeORM DataSource
dataSource = app.get(DataSource);
});
beforeEach(async () => {
// Clear database and run specific seeders before each test
await dataSource.synchronize(true); // CAUTION: Clears all data! Use carefully.
await new UserSeeder().run(dataSource, null); // Run your seeder
});
afterAll(async () => {
await app.close();
});
it('/users (GET) should return seeded users', () => {
// Test logic here, expecting seeded data
});
});Key Seeding Practices
Follow these tips for robust seeding:
- Idempotency: Ensure running a seeder multiple times doesn't create duplicate data unless intended. Check for existing records first.
- Clear Separation: Keep development seeders (lots of dummy data) separate from testing seeders (minimal, precise data).
- Version Control: Store seeders in your version control system.
- Environment-Specific: Be cautious when running seeders in production. Only seed essential config data.
Seeding Benefits
Database seeding provides significant advantages for development and testing.
Which of the following are primary benefits of database seeding?
Recap: Seeding for Success
Congratulations! You've learned about database seeding, a vital practice for any backend developer.
We covered what seeding is, its benefits for development and testing, and how to implement and run seeders in a NestJS/TypeORM application. You also saw how to integrate seeding into your test workflows.
By mastering seeding, you ensure consistent, reliable, and efficient development and testing cycles!
تعلم TypeScript مع معلم ذكاء اصطناعي — مجانًا
اكتب وقم بتشغيل أكوادك الفعلية في المتصفح، واحصل على مساعدة فورية من معلم ذكاء اصطناعي متاح 24/7، واستمر من حيث توقفت على الويب أو في التطبيق.
- الدورات
- 20
- الدروس
- 76
الأسئلة الشائعة
هل درس «تهيئة قاعدة البيانات بالبيانات واختبارها» مجاني؟
نعم — نص درس «تهيئة قاعدة البيانات بالبيانات واختبارها» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة NestJS Enterprise Backend APIs، انتقل إلى CoddyKit PRO. تتضمن دورة NestJS Enterprise Backend APIs 3 دروس في المجموع.
ماذا ستتعلم في «تهيئة قاعدة البيانات بالبيانات واختبارها»؟
تعلّم تهيئة قاعدة بياناتك ببيانات أولية لأغراض التطوير والاختبار، بما يضمن اتساق البيئات. تتمرن على NestJS Enterprise Backend APIs مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ NestJS Enterprise Backend APIs؟
لا تُشترط خبرة سابقة. NestJS Enterprise Backend APIs على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 3 من أصل 3.
كم من الوقت يستغرق درس «تهيئة قاعدة البيانات بالبيانات واختبارها»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس NestJS Enterprise Backend APIs هذا؟
نعم. كل درس في NestJS Enterprise Backend APIs يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- مستودعات TypeORM مخصصة
- المعاملات وعمليات الترحيل
- تهيئة قاعدة البيانات بالبيانات واختبارها