ent لـ Go: الدليل الشامل لـ ORM مع توليد الكود

في عالم التطوير بلغة Go، توجد العديد من مكتبات ORM، لكن ent من فيسبوك (الآن Meta) تحتل مكانة خاصة. إنها ليست مجرد ORM عادي - بل هي إطار عمل قوي للتعامل مع قواعد البيانات، يعتمد على توليد الكود. بدلاً من استخدام التأمل (reflection) أو الواجهات أثناء التشغيل، يقوم ent بتوليد كود Go مقيد النوع بدقة بناءً على مخطط البيانات الخاص بك. هذا يعني أن العديد من الأخطاء المتعلقة بالأنواع والاستعلامات يتم اكتشافها في مرحلة الترجمة، وليس في بيئة الإنتاج.

لماذا تحتاج إلى ent؟ إذا كنت تعمل مع قواعد البيانات العلائقية (PostgreSQL, MySQL, SQLite) وتريد كتابة مقيدة، وإكمال تلقائي في بيئة التطوير، والحد الأدنى من الكود المتكرر - فإن ent هو خيارك الأمثل. إنه مثالي للمشاريع التي تكون فيها الأداء وقابلية صيانة الكود أمرًا مهمًا. على عكس GORM الذي يستخدم التأمل، يقوم ent بتوليد كود لكل نموذج، مما يجعله أسرع وأكثر أمانًا بشكل ملحوظ.

في هذه المقالة، سنشرح ent بالتفصيل: من التثبيت إلى التقنيات المتقدمة. ستتعلم كيفية تعريف مخطط البيانات، وتوليد الكود، وتنفيذ عمليات CRUD، وبناء استعلامات معقدة مع الرسوم البيانية للعلاقات، وتجنب الأخطاء الشائعة. المحتوى موجه للمطورين الذين لديهم معرفة أساسية بلغة Go.

التثبيت

للبدء مع ent، ستحتاج إلى Go الإصدار 1.16 أو أعلى. يتضمن التثبيت حزمة ent نفسها وأداة سطر الأوامر لتوليد الكود.

# تثبيت أداة سطر الأوامر
go install entgo.io/ent/cmd/ent@latest

# تهيئة المشروع (سينشئ مجلد ent/)
go run entgo.io/ent/cmd/ent init User

الأمر الأول يقوم بتثبيت الملف الثنائي ent في $GOPATH/bin. الأمر الثاني ينشئ هيكل المشروع: مجلد ent/ مع ملف مخطط للكيان User. بعد ذلك، يمكنك البدء في تعريف الحقول والعلاقات.

بداية سريعة: مثال عملي بسيط

لنقم بإنشاء نموذج مستخدم بسيط وتنفيذ العمليات الأساسية. أولاً، نحدد المخطط في الملف ent/schema/user.go:

package schema

import (
    "entgo.io/ent"
    "entgo.io/ent/schema/field"
)

// User يحتوي على تعريف المخطط لكيان المستخدم.
type User struct {
    ent.Schema
}

// Fields حقول المستخدم.
func (User) Fields() []ent.Field {
    return []ent.Field{
        field.String("name").
            Unique().
            NotEmpty(),
        field.Int("age").
            Positive(),
        field.String("email").
            Unique(),
    }
}

الآن نقوم بتوليد الكود:

go generate ./ent

بعد ذلك، يمكن استخدام الكود المُولَّد في main.go:

package main

import (
    "context"
    "fmt"
    "log"

    "your-project/ent"
    "your-project/ent/user"

    _ "github.com/mattn/go-sqlite3"
)

func main() {
    // إنشاء عميل لـ SQLite (في الذاكرة)
    client, err := ent.Open("sqlite3", "file:ent?mode=memory&cache=shared&_fk=1")
    if err != nil {
        log.Fatalf("فشل فتح الاتصال بـ sqlite: %v", err)
    }
    defer client.Close()

    // الترحيل التلقائي للمخطط
    ctx := context.Background()
    if err := client.Schema.Create(ctx); err != nil {
        log.Fatalf("فشل إنشاء موارد المخطط: %v", err)
    }

    // إنشاء مستخدم
    u, err := client.User.
        Create().
        SetName("أحمد").
        SetAge(30).
        SetEmail("ahmed@example.com").
        Save(ctx)
    if err != nil {
        log.Fatalf("فشل إنشاء المستخدم: %v", err)
    }
    fmt.Printf("تم إنشاء المستخدم: %+v\n", u)

    // البحث عن مستخدم بالاسم
    found, err := client.User.
        Query().
        Where(user.NameEQ("أحمد")).
        Only(ctx)
    if err != nil {
        log.Fatalf("فشل الاستعلام عن المستخدم: %v", err)
    }
    fmt.Printf("تم العثور على المستخدم: %+v\n", found)
}