TypeScript Academy · درس

العلاقات وعمليات الربط مع الأنواع

نمذجوا العلاقات لضمان تحديد أنواع النتائج المربوطة بشكل صحيح

العلاقات وعمليات الربط مع الأنواع درس مجاني في TypeScript Academy على CoddyKit. هذا هو الدرس 4 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في TypeScript Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة TypeScript Academy 4 دروس في المجموع.

العلاقات والنتائج المتداخلة ذات الأنواع

تحتوي المخططات الواقعية على علاقات: فالمستخدم لديه منشورات عديدة، والمنشور ينتمي إلى مستخدم. ويتيح ORM الآمن من ناحية الأنواع التصريح بهذه العلاقات، ثم إرجاع نتائج متداخلة وذات أنواع صحيحة من الاستعلامات العلائقية.

التصريح بالعلاقات

إلى جانب الجداول، تعرّفون كائن علاقات يصف كيفية اتصالها. وتدعم هذه البيانات الوصفية إنشاء SQL ونوع النتيجة معًا.

import { relations } from "drizzle-orm";

export const usersRelations = relations(users, ({ many }) => ({
  posts: many(posts),
}));

export const postsRelations = relations(posts, ({ one }) => ({
  author: one(users, {
    fields: [posts.authorId],
    references: [users.id],
  }),
}));

استعلام علائقي

تتيح لكم واجهة الاستعلام طلب الصفوف المرتبطة باستخدام with. وتضع النتيجة البيانات المرتبطة داخل بنية متداخلة تحت اسم العلاقة.

const result = await db.query.users.findMany({
  with: { posts: true },
});
// result: (User & { posts: Post[] })[]

one مقابل many يحددان شكل النوع

تنتج علاقة many مصفوفة، بينما تنتج علاقة one كائنًا واحدًا (أو null). ويطابق النوع المتداخل التعددية التي صرّحتم بها.

const r = await db.query.posts.findMany({
  with: { author: true },
});
// r: (Post & { author: User })[]   // author is a single object

اختيار الأعمدة داخل العلاقات

يمكنكم تضييق الصفوف الأصلية والصفوف المتداخلة معًا. ويضيق نوع النتيجة على كل مستوى بشكل مستقل.

const r = await db.query.users.findMany({
  columns: { id: true, name: true },
  with: {
    posts: { columns: { title: true } },
  },
});
// r: { id: number; name: string; posts: { title: string }[] }[]

عمليات الربط اليدوية باستخدام أعمدة ذات أنواع

تظل عمليات الربط منخفضة المستوى آمنة من ناحية الأنواع أيضًا. ويستخدم شرط الربط مراجع أعمدة ذات أنواع، بينما يحدد الاختيار شكل النتيجة المسطحة.

const rows = await db
  .select({ author: users.name, title: posts.title })
  .from(posts)
  .innerJoin(users, eq(users.id, posts.authorId));
// rows: { author: string; title: string }[]

يُدخل left join قابلية null

قد ينتج عن LEFT JOIN عدم وجود صفوف في الجانب الأيمن، ولذلك تصبح الأعمدة المرتبطة قابلة لـ null في نوع النتيجة. ويعكس ORM ذلك تلقائيًا.

const rows = await db
  .select({ name: users.name, title: posts.title })
  .from(users)
  .leftJoin(posts, eq(posts.authorId, users.id));
// rows: { name: string; title: string | null }[]

النتائج المتداخلة مقابل المسطحة

تعطي الاستعلامات العلائقية (findMany + with) كائنات متداخلة، بينما تعطي عمليات الربط اليدوية صفوفًا مسطحة. اختاروا النتائج المتداخلة عندما تريدون أشجار كائنات، والمسطحة عندما تريدون إسقاطات جدولية.

كيفية تحديد أنواع التداخل

تُقرأ البيانات الوصفية للعلاقات على مستوى النوع. ويقاطع نوع الاستعلام الصف الأساسي مع كائن مفاتيحه هي العلاقات المطلوبة، ويُعيَّن لكل منها نوع مصفوفة أو نوع مفرد وفق تعدديتها.

type WithPosts = User & { posts: Post[] };
// "many" -> Post[], "one" -> User (or User | null for optional)

العلاقات المتداخلة بعمق

العلاقات قابلة للتركيب. يمكنكم طلب علاقة لعلاقة أخرى، وسيتداخل النوع بالعمق نفسه، مع استنتاجه بالكامل.

await db.query.users.findMany({
  with: { posts: { with: { comments: true } } },
});
// User & { posts: (Post & { comments: Comment[] })[] }

لماذا يهم هذا

تُعد كتابة أنواع نتائج عمليات الربط المتداخلة يدويًا عرضة للأخطاء، كما أنها تنحرف عن المخطط. ويؤدي اشتقاقها من العلاقات المصرّح بها إلى إبقاء نوع شجرة الكائنات وSQL متزامنين تمامًا، بحيث تصبح إعادة تسمية العلاقة خطأً في وقت الترجمة، لا مفاجأة في الإنتاج.

تحقق سريع

اختبروا مدى فهمكم للعلاقات وعمليات الربط ذات الأنواع.

مراجعة

صرّحتم عن العلاقات، ثم تركتم ORM ينتج نتائج متداخلة ذات أنواع: إذ تمنح many مصفوفات، وتمنح one كائنات مفردة، وتضيّق الاختيارات الجزئية كل مستوى، وتُدخل عمليات LEFT JOIN قابلية null، كما تتركب العلاقات المتداخلة بعمق. وتقود البيانات الوصفية للعلاقات كلًا من SQL وأنواع النتائج، مما يبقيهما متزامنين.

الأسئلة الشائعة

هل درس «العلاقات وعمليات الربط مع الأنواع» مجاني؟

نعم — نص درس «العلاقات وعمليات الربط مع الأنواع» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة TypeScript Academy، انتقل إلى CoddyKit PRO. تتضمن دورة TypeScript Academy 4 دروس في المجموع.

ماذا ستتعلم في «العلاقات وعمليات الربط مع الأنواع»؟

نمذجوا العلاقات لضمان تحديد أنواع النتائج المربوطة بشكل صحيح تتمرن على TypeScript Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ TypeScript Academy؟

لا تُشترط خبرة سابقة. TypeScript Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 4 من أصل 4.

كم من الوقت يستغرق درس «العلاقات وعمليات الربط مع الأنواع»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس TypeScript Academy هذا؟

نعم. كل درس في TypeScript Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

← العودة إلى TypeScript Academy