🗄️ Learn Database by Practice

📖 About | حول المشروع

A collection of database exercises for learning through practice — covering both database design (ER modeling, normalization, relationships) and SQL (DDL, DML, DQL, joins, aggregation, subqueries, window functions, and more). Each exercise is documented with clear descriptions in both English and Arabic.

مجموعة من تمارين قواعد البيانات للتعلم من خلال الممارسة — تغطي تصميم قواعد البيانات (نمذجة ER، التطبيع، العلاقات) و SQL (DDL, DML, DQL، الجوينز، التجميع، الاستعلامات الفرعية، دوال النافذة، وغيرها). كل تمرين موثّق بأوصاف واضحة بالإنجليزية والعربية.

⚠️ Important Note | ملاحظة مهمة

This repository is different from programming-language repos (like Python/Go/Rust) where every exercise is a standalone, runnable file. Here, exercises are split into two distinct types:

Type	النوع	Executable?	قابل للتنفيذ؟
Design Exercises	تمارين التصميم	❌ No	❌ لا
SQL Exercises	تمارين SQL	✅ Yes	✅ نعم

Each type has its own template. See the Templates section below.

هذا المستودع مختلف عن مستودعات لغات البرمجة حيث كل تمرين ليس بالضرورة كوداً قابلاً للتشغيل. تمارين التصميم مخرجاتها تحليل ومخططات، بينما تمارين SQL هي استعلامات تُنفذ مباشرة. لكل نوع قالب خاص به — انظر قسم القوالب أدناه.

---

📂 Repository Structure | هيكل المستودع

learn-database-by-practice/
├── .gitignore                      # Git ignore file | ملف تجاهل الجيت
├── README.md                       # Project overview | نظرة عامة على المشروع
├── template-design.md              # Design problem template | قالب تمارين التصميم
├── template-sql.sql                # SQL problem template | قالب تمارين SQL
│
├── theory/                         # Short concept references | مرجع مختصر للمفاهيم
│   ├── 01_fundamentals.md
│   ├── 02_design.md
│   ├── 03_ddl.md
│   ├── 04_dml.md
│   ├── 05_dql_joins.md
│   ├── 06_aggregation.md
│   ├── 07_subqueries.md
│   ├── 08_window_functions.md
│   ├── 09_dcl_tcl.md
│   ├── 10_indexing.md
│   └── 11_advanced.md
│
└── problems/                       # All exercises | جميع التمارين
    ├── design/                     # Design exercises | تمارين التصميم
    │   ├── 0001_normalize_table/
    │   │   └── main.md
    │   ├── 0002_er_diagram_from_requirements/
    │   │   └── main.md
    │   └── ...
    │
    └── sql/                        # SQL exercises | تمارين SQL
        ├── 0001_create_simple_table/
        │   └── main.sql
        ├── 0002_inner_join_basics/
        │   └── main.sql
        └── ...

Why two problem folders? | لماذا يوجد مجلدين للتمارين؟ Design exercises produce an analysis or diagram, not runnable code — while SQL exercises (DDL, DML, DQL, joins, aggregation, subqueries, window functions, DCL/TCL, indexing, advanced objects) are all executed the same way, and often mix several topics in a single query. So design/ is kept separate, while all SQL topics stay flat under sql/ instead of being split into sub-folders per topic.

تمارين التصميم مخرجاتها تحليل أو مخطط، وليست كوداً قابلاً للتنفيذ — بينما تمارين SQL (DDL, DML, DQL، الجوينز، التجميع، الاستعلامات الفرعية، إلخ) كلها تُنفذ بنفس الطريقة، وغالبًا ما تدمج عدة مواضيع في استعلام واحد. لذلك تم فصل design/، بينما بقيت مواضيع SQL مسطحة داخل sql/ بدلاً من تقسيمها إلى مجلدات فرعية لكل موضوع.

---

🚀 Getting Started | البدء

Prerequisites | المتطلبات

• A relational database installed — PostgreSQL is used by default (Download)
• قاعدة بيانات علائقية مثبتة — يُستخدم PostgreSQL افتراضيًا

psql --version

Running a SQL Problem | تشغيل تمرين SQL

# Clone the repository | استنساخ المستودع
git clone https://github.com/AbdullahNamespace/learn-database-by-practice.git
cd learn-database-by-practice

# Run a specific SQL problem against your database | تشغيل تمرين SQL محدد على قاعدة بياناتك
psql -U your_user -d your_database -f problems/sql/0001_create_simple_table/main.sql

Working on a Design Problem | التعامل مع تمرين تصميم

Design problems don't execute — open main.md, read the requirements, and write your analysis, normalized schema, or ER diagram directly in the file (or link an image/diagram file next to it).

تمارين التصميم لا تُنفذ — افتح main.md، اقرأ المتطلبات، واكتب تحليلك أو المخطط المطبّع أو مخطط ER مباشرة في الملف (أو أضف رابطاً لصورة/ملف مخطط بجانبه).

---

📝 Problem Templates | قوالب التمارين

This repo uses two templates, since design and SQL exercises are fundamentally different in nature: يستخدم هذا المستودع قالبين، لأن تمارين التصميم وتمارين SQL مختلفة جوهرياً في طبيعتها:

• template-design.md — for design/analysis exercises (normalization, ER modeling, relationships) | لتمارين التصميم/التحليل
• template-sql.sql — for executable SQL exercises (DDL, DML, DQL, joins, etc.) | لتمارين SQL القابلة للتنفيذ

See each file for the full format. | انظر إلى كل ملف لمعرفة الصيغة الكاملة.

---

Happy Learning! 🗄️ | تعلّم سعيد!