أساسيات SQL

أساسيات SQL — SQL Basics

حزمة database/sql هي الواجهة الموحدة للتعامل مع قواعد البيانات العلائقية في Go. التصميم ذكي: الحزمة تُعرّف الواجهة، والمشغّلات (drivers) تُنفّذها لكل قاعدة بيانات.

ملاحظة: أمثلة قواعد البيانات لا يمكن تشغيلها مباشرة على Go Playground لأنها تحتاج قاعدة بيانات فعلية. الكود هنا للقراءة والفهم — جرّبه محلياً.

بنية الحزمة

database/sql (الواجهة — Interface)
    ↓
مشغّل (Driver)
    ↓
قاعدة البيانات (PostgreSQL / MySQL / SQLite)

المشغّلات الشائعة:

PostgreSQL: github.com/lib/pq أو github.com/jackc/pgx
MySQL: github.com/go-sql-driver/mysql
SQLite: github.com/mattn/go-sqlite3

الاتصال بقاعدة البيانات

main.go

package main

import (
    "fmt"
)

func main() {
    // كود الاتصال الفعلي — Actual connection code
    code := `
import (
    "database/sql"
    _ "github.com/lib/pq"  // استيراد المشغّل — Import driver
)

func main() {
    // سلسلة الاتصال — Connection string
    dsn := "postgres://user:pass@localhost:5432/mydb?sslmode=disable"
    
    db, err := sql.Open("postgres", dsn)
    if err != nil {
        log.Fatal("فشل فتح الاتصال:", err)
    }
    defer db.Close()  // أغلق عند الخروج — Close on exit
    
    // تحقق من الاتصال — Verify connection
    if err := db.Ping(); err != nil {
        log.Fatal("فشل الاتصال:", err)
    }
    
    fmt.Println("تم الاتصال بنجاح! ✅")
}`
    fmt.Println("كود الاتصال بقاعدة البيانات:")
    fmt.Println(code)

    fmt.Println("\nملاحظات مهمة:")
    fmt.Println("1. sql.Open لا يُنشئ اتصالاً فعلياً — فقط يُعدّ التهيئة")
    fmt.Println("2. db.Ping() يتحقق من الاتصال الفعلي")
    fmt.Println("3. defer db.Close() يضمن إغلاق الاتصال")
    fmt.Println("4. _ import يُسجّل المشغّل بدون استخدامه مباشرة")
}

Output:

sql.Open ليست اتصالاً!

نقطة مهمة يُخطئ فيها كثير من المبتدئين:

sql.Open تُعدّ pool اتصالات — لا تفتح اتصالاً فعلياً
db.Ping() يفتح أول اتصال ويتحقق
*sql.DB آمن للاستخدام من عدة goroutines (thread-safe)
أنشئ *sql.DB واحد واستخدمه في كل التطبيق

إعدادات pool الاتصالات

db.SetMaxOpenConns(25)                  // أقصى اتصالات مفتوحة
db.SetMaxIdleConns(25)                  // أقصى اتصالات خاملة
db.SetConnMaxLifetime(5 * time.Minute)  // عمر الاتصال

الاستعلام — Query, QueryRow, Exec

main.go

package main

import "fmt"

func main() {
    fmt.Println("=== أنواع الاستعلامات ===")
    fmt.Println()

    fmt.Println("1️⃣ db.QueryRow — صف واحد:")
    fmt.Println(`   var name string
   var age int
   err := db.QueryRow("SELECT name, age FROM users WHERE id = $1", 42).
       Scan(&name, &age)`)
    fmt.Println()

    fmt.Println("2️⃣ db.Query — عدة صفوف:")
    fmt.Println(`   rows, err := db.Query("SELECT id, name FROM users WHERE age > $1", 18)
   defer rows.Close()  // مهم جداً!
   for rows.Next() {
       var id int
       var name string
       rows.Scan(&id, &name)
   }
   // تحقق من أخطاء التكرار
   if err := rows.Err(); err != nil { ... }`)
    fmt.Println()

    fmt.Println("3️⃣ db.Exec — بدون نتائج (INSERT, UPDATE, DELETE):")
    fmt.Println(`   result, err := db.Exec("INSERT INTO users (name, age) VALUES ($1, $2)", "أحمد", 25)
   id, _ := result.LastInsertId()    // الـ ID الجديد
   affected, _ := result.RowsAffected()  // عدد الصفوف المتأثرة`)
}

Output:

مثال كامل (للتشغيل محلياً)

main.go

package main

import "fmt"

// محاكاة بنية المستخدم — Simulated User struct
type User struct {
    ID   int
    Name string
    Age  int
}

func main() {
    // محاكاة نتائج الاستعلام — Simulated query results
    users := []User{
        {ID: 1, Name: "أحمد", Age: 28},
        {ID: 2, Name: "فاطمة", Age: 24},
        {ID: 3, Name: "عمر", Age: 32},
    }

    // محاكاة QueryRow — Simulated QueryRow
    fmt.Println("=== QueryRow ===")
    target := users[0]
    fmt.Printf("المستخدم: %s (عمره %d)\n\n", target.Name, target.Age)

    // محاكاة Query — Simulated Query
    fmt.Println("=== Query (كل المستخدمين) ===")
    for _, u := range users {
        fmt.Printf("  #%d: %s — %d سنة\n", u.ID, u.Name, u.Age)
    }

    // محاكاة Exec — Simulated Exec
    fmt.Println("\n=== Exec (إضافة مستخدم) ===")
    newUser := User{ID: 4, Name: "نورة", Age: 22}
    users = append(users, newUser)
    fmt.Printf("تمت الإضافة: %s (ID: %d)\n", newUser.Name, newUser.ID)
    fmt.Printf("المجموع: %d مستخدمين\n", len(users))
}

Output:

الحماية من SQL Injection

لا تضع قيم المستخدم في النص مباشرة! استخدم المعاملات الموضعية:

// ❌ خطير — SQL injection!
query := fmt.Sprintf("SELECT * FROM users WHERE name = '%s'", userInput)

// ✅ آمن — Parameterized query
db.Query("SELECT * FROM users WHERE name = $1", userInput)

المعاملات الموضعية:

PostgreSQL: $1, $2, $3
MySQL: ?, ?, ?
SQLite: ?, ?, ? أو $1, $2, $3

التعامل مع NULL

main.go

package main

import (
    "database/sql"
    "fmt"
)

func main() {
    // sql.NullString للتعامل مع NULL — Handle NULL values
    var name sql.NullString
    name = sql.NullString{String: "أحمد", Valid: true}

    if name.Valid {
        fmt.Println("الاسم:", name.String)
    } else {
        fmt.Println("الاسم: غير محدد")
    }

    // قيمة NULL — NULL value
    var email sql.NullString
    // email.Valid = false (افتراضياً)
    if email.Valid {
        fmt.Println("البريد:", email.String)
    } else {
        fmt.Println("البريد: غير محدد")
    }

    fmt.Println("\nأنواع Null المتاحة:")
    fmt.Println("sql.NullString, sql.NullInt64, sql.NullFloat64")
    fmt.Println("sql.NullBool, sql.NullTime, sql.NullInt32")
}

Output:

تحدي — Challenge

package main

import "fmt"

type User struct {
    ID   int
    Name string
    Age  int
}

func main() {
    users := []User{
        {1, "أحمد", 28},
        {2, "فاطمة", 24},
        {3, "عمر", 32},
    }

    fmt.Println("المستخدمين:")
    // اطبع كل مستخدم وابحث عن الأكبر سناً
    // اكتب الكود هنا
    fmt.Printf("الأكبر: %s\n", "")
}