انتقل إلى الوثائق

من المخطط إلى المخطط البياني

دليل SQL إلى ERD

حوّل مخطط قاعدة البيانات إلى رسم. تعرّف على SQL المدعوم، وعاين البيانات، واستعلم عن نموذجك.

SQL DDL → رسم ERافتح SQL إلى ERD
البدء

عقد بنية SQL الجاهزة للذكاء الاصطناعي

استخدم هذه الصفحة كعقد مدمج عند طلب من ذكاء اصطناعي كتابة أو تحرير SQL لـ Erd Go. تفضل أنماط البناء أدناه، واجعل العبارات كاملة ومنتهية بفاصلة منقوطة، وتجنب كائنات قاعدة البيانات غير المدعومة ما لم تكن بحاجة إلى SQL الخام خارج Erd Go. يتم دعم بناء جملة SQLite وPostgreSQL وMySQL وMSSQL عبر الجزء المشترك أدناه. يعمل تحويل SQL إلى ERD بالكامل في المتصفح، ويتم قفل محركات المحلل والمعاينة الخاصة به بواسطة آلاف اختبارات الوحدة والتكامل التي تغطي مخططات الإنتاج في العالم الحقيقي (SaaS، المصرفية، الاجتماعية، التحليلات، EHR).

SQLite

قواعد صفوف INTEGER PRIMARY KEY، والأعمدة بلا أنواع، وAUTOINCREMENT، وWITHOUT ROWID، والجداول الصارمة المُتحقق منها (STRICT)، وإجراءات المفاتيح الخارجية (FK)، وإعادة تشغيل عمليات الترحيل

PostgreSQL

أنواع ENUM والمركبة، والمصفوفات، وJSONB، وSERIAL، وأعمدة الهوية، وNULLS NOT DISTINCT، وفهارس التعبير، وهوية المخطط، وحساسية حالة الأحرف للأسماء المقتبسة

MySQL

AUTO_INCREMENT، و ENUM & SET المضمنة، وعلامات الاقتباس المرتدة، و COMMENT، و UNSIGNED/SIGNED، والفهارس المضمنة، و CHANGE/MODIFY COLUMN، وتحديد الموضع FIRST/AFTER

MSSQL

IDENTITY، وNVARCHAR(MAX)، والأسماء المحاطة بأقواس، والفهارس العنقودية، ودفعات GO، وALTER COLUMN، والأعمدة المحسوبة، والقيم الافتراضية المسماة، والفترات الزمنية

DDL

CREATE TYPE، و CREATE TABLE، وإعادة تشغيل ترحيل ALTER TABLE، و CREATE INDEX، وعبارات DROP الآمنة لتشكيل المخطط

DML / SELECT

INSERT، وUPDATE، وDELETE لبيانات المعاينة، بالإضافة إلى بناء جملة SELECT للقراءة فقط لعمليات الانضمام، والتعابير الجدولية المشتركة (CTEs)، والتجمعات، والنوافذ، والتقارير

البدء السريع

استخدم هذا كاستجابة نموذجية عند طلب SQL متوافق مع Erd Go من ذكاء اصطناعي: الأنواع المخصصة أولا، ثم الجداول، ثم قيود العلاقات بعد الجداول عندما يكون ذلك مفيدا، ثم DML النموذجي. حافظ على استعلامات SELECT للقراءة فقط منفصلة.

PostgreSQL / البدء السريع لـ PostgreSQL
-- Define custom types
CREATE TYPE status_enum AS ENUM (
  'active', 'inactive', 'suspended'
);

-- Create tables with constraints
CREATE TABLE departments (
  id SERIAL PRIMARY KEY,
  name VARCHAR(100) NOT NULL UNIQUE
);

CREATE TABLE employees (
  id SERIAL PRIMARY KEY,
  name VARCHAR(100) NOT NULL,
  email TEXT UNIQUE NOT NULL,
  status status_enum DEFAULT 'active',
  department_id INTEGER,
  salary NUMERIC(10, 2) DEFAULT 0
);

-- Add constraints via ALTER TABLE
ALTER TABLE employees
  ADD CONSTRAINT fk_dept
  FOREIGN KEY (department_id)
  REFERENCES departments(id);

-- Add sample data after schema DDL
INSERT INTO departments (id, name) VALUES
  (1, 'Engineering'),
  (2, 'Design');

INSERT INTO employees (id, name, email, status, department_id, salary) VALUES
  (1, 'Alice', '[email protected]', 'active', 1, 1500.00),
  (2, 'Bob', '[email protected]', 'inactive', 2, 1200.00);

UPDATE employees
  SET status = 'active'
  WHERE id = 2;
بناء جملة المخطط: يمكن الإعلان عن العلاقات إما مضمنة REFERENCES أو ALTER TABLE ADD FOREIGN KEY. يساهم كلا الشكلين بنفس بيانات العلاقات التعريفية وصفاتها.
بناء جملة DML: ضع INSERT, UPDATE، و DELETE بعد مخطط DDL. يتم تقييم البرنامج النصي من أعلى إلى أسفل، لذا يجب أن تشير صفوف العينة إلى الجداول والأنواع الموجودة بالفعل.
بناء جملة SELECT: احتفظ باستعلامات التقارير للقراءة فقط منفصلة عن نصوص التعديل. يجب أن تشير فقط إلى الجداول والصفوف التي ينتجها برنامج المخطط/DML النصي.
SQL / مثال
SELECT e.name, d.name AS department, e.salary
FROM employees e
JOIN departments d ON d.id = e.department_id
WHERE e.status = 'active'
ORDER BY e.salary DESC;

علامات تبويب SQL واستيراد الملفات

ابدأ ملف SQL جديداً بنموذج، أو علامة تبويب مخطط فارغة، أو استيراد ملفات SQL. يفصل النموذج المخطط والبيانات في علامات تبويب. يضيف زر إضافة SQL علامة تبويب محرر أخرى؛ انقر نقراً مزدوجاً فوق عنوانها لإعادة تسميتها.

تتجمع علامات التبويب النشطة معاً بترتيبها المرئي لـ ERD، وعرض البيانات، وعرض الاستعلام، وطلبات الذكاء الاصطناعي. تظل علامة التبويب غير النشطة مسودة محفوظة ويتم استبعادها من تلك التدفقات العملية. ضع الأنواع والجداول قبل العبارات التي تعتمد عليها.

يقبل استيراد ملفات SQL ملفات نصية متعددة لـ SQL ويراجع مشكلات التحليل معاً قبل الاستيراد. يساعد هذا في حل المراجع بين الملفات. استخدم ترتيب علامات التبويب للحفاظ على مقصودة التبعيات خطوات الترحيل.

استخدم مفاتيح الأسهم و Home/End في شريط علامات التبويب لتبديل علامات التبويب، و Alt+Left/Right لإعادة ترتيبها، و Shift+Alt+F لتنسيق SQL في المحرر.

افتح مستكشف SQL (SQL Explorer) بجانب علامات التبويب لشجرة مجلدات قابلة لتغيير الحجم. أنشئ مجلدات متداخلة وملفات SQL، وحدد ملفاً لفتحه، وقم بالتنظيم باستخدام السحب والإفلات. تدعم نافذة إجراءات الصف المنبثقة خيار إعادة التسمية وحذف الملف؛ وانقر في أي مكان خارجها لإغلاقها. يؤدي حذف الملف الأخير إلى إبقاء ملف SQL فارغاً مفتوحاً. لا تغير المجلدات ترتيب التنفيذ. يؤدي إزالة مجلد إلى الاحتفاظ بملفاته والمجلدات الفرعية التابعة له في المجلد الأصل. يحتفظ الحفظ بشجرة المجلدات وتفضيلات اللوحة.

تحرير الرسم ومراجعته

SQL هو مصدر معنى المخطط. استخدم ميزة "إضافة جدول" (Add Table) لإنشاء جدول، أو حدد إجراءات الجدول والأعمدة على لوحة الرسم لتحرير الأعمدة والاتصالات. تقوم تعديلات مخطط لوحة الرسم بتحديث علامات تبويب SQL المالكة وكذلك المخطط.

تقوم إزالة عمود بمعاينة الاتصالات والمفاتيح والفهارس المتأثرة وأوامر SQL التابعة. راجع الإزالة أو التتبيع (cascade) قبل التأكيد. قد تتطلب عمليات الترحيل المعقدة أو العبارات التابعة غير المدعومة تحرير SQL مباشراً.

استخدم درجة صحة ERD لفحص النتائج الهيكلية واقتراحات العلاقات الاختيارية. تحتاج العلاقات المقترحة إلى مراجعة؛ فهي لا تحل محل المفاتيح الخارجية المعلنة أو تنشئ قواعد عمل تلقائياً.

قم بترتيب الجداول باستخدام وضع التخطيط (Layout Mode)، أو التكبير أو ملاءمة الشاشة (Fit to Screen)، وابحث عن الجداول باستخدام مستعرض الجداول (Table Navigator)، واستخدم ألوان الجداول أو خريطة المصغرات (minimap) للتنقل في مخطط كبير. مرر فوق عنصر تحكم شريط الأدوات أو ركز عليه للحصول على نص المساعدة الخاص به.

حدد جدولاً وافتح منتقي الألوان (Color Picker) للإعدادات المسبقة للألوان الصلبة أو المتدرجة. أدخل قيمة سداسية عشري أو اختر "مخصص" (Custom) بجانبها لاستخدام منتقي الألوان الأصلي. يظل كلا عنصرَي التحكم متزامنين؛ ويحافظ زر "حفظ" على لون الجدول.

عند تعيين أدوات الجدول لتظهر عند التحويم فقط، يظهر إضافة عمود (Add column) عند تحويم الصف الأخير المرئي أو التركيز على الزر بواسطة لوحة المفاتيح. تحافظ الأدوات المرئية دائما على إظهاره.

اختر مجموعات الجداول على شريط أدوات لوحة SQL، ثم مجموعة جديدة. امنح المجموعة اسماً ولوناً، وحدد جدولها، واختر إنشاء مجموعة. يبدأ الجدول المحدد محدد؛ وينتمي الجدول إلى مجموعة واحدة؛ ويعرض النموذج عندما سينقل تحديدك جدولاً خارج مجموعة أخرى. يتم دعم ما يصل إلى 50 مجموعة، بأسماء تصل إلى 160 حرفاً.

انقر فوق رأس مجموعة لتعديل اسمها أو لونها أو أعضائها. اسحب الرأس لتحريك جداولها معاً؛ واتركه لتطبيق النقل. يلغي Escape، أو إلغاء المؤشر، أو فقدان تركيز النافذة المعاينة. يؤدي إلغاء تجميع الجداول إلى إزالة الإطار مع الاحتفاظ بالجداول ومواضعها و SQL والعلاقات.

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

مراجعة الذكاء الاصطناعي داخل محرر SQL

  1. أدخل تغييراً معيناً في Ask AI لتعديل SQL واختيار نموذج متاح. يتوفر تعيين مفتاح Gemini API عندما تريد استخدام مفتاح Gemini الخاص بك.
  2. راجع التغييرات المقترحة ومعاينة المخطط المؤقتة. يستخدم الطلب لقطة علامة التتبويب النشطة الملتقطة عند إرسالها؛ ولا يتم حفظ الاستجابة تلقائياً.
  3. قبول أو رفض التغييرات الفردية، أو استخدام الإجراءات للتغييرات المتبقية. انتقل بين تغييرات الكود باستخدام F7 و Shift+F7. تظل علامات التتبيلة غير النشطة والمحمية كمسودات.
  4. افحص كود SQL المقبول، ثم احفظ المستند. يتيح لك نسخ موجه الذكاء الاصطناعي (AI Prompt) في هذا الدليل أيضًا استخدام التوثيق مع مساعد خارج التطبيق.

البيانات، والاستعلامات، والتصديرات، والملفات المحفوظة

استخدم أزرار ERD و Data و Query لتبديل منصات العمل. يقوم عرض البيانات بتجسيد DDL و DML المدعومين في المتصفح ويعرض الجداول والصفوف والأنواع وسجل التنفيذ. قم بتغيير حجم أعمدة الشبكة عن طريق سحب حوافها أو انقر نقراً مزدوجاً للملاءمة. انقر نقراً مزدوجاً فوق خلية بيانات أو اضغط على Enter للتحرير؛ توفر الحقول المنطقية والتعدادية قيمًا صالحة. يتبع صف الإضافة افتراضيات المخطط الخاص بك. استيراد CSV أو TSV أو TXT أو XLSX مع معاينة تعيين الأعمدة. يظل NULL والنص الفارغ منفصلين. تصبح التعديلات التي تم التحقق من صحتها كود SQL في علامة تبويب تعديلات البيانات ويمكن التراجع عنها. قم بتنزيل صفوف الجدول أو نتائج الاستعلام كملف CSV.

يتذكر أمر الحفظ (Save) مساحة عمل ERD، أو Data، أو Query المحددة؛ وتؤدي إعادة الفتح إلى استعادتها، بما في ذلك Data/Query على الهواتف. تبدأ الملفات القديمة في ERD. تحافظ محررات التاريخ/الوقت الأصلية على القيم المدعومة، بينما تظل الطوابع الزمنية مع الكسور أو إزاحات المنطقة الزمنية قابلة للتحرير كالنصوص. تظل الهويات التي تولدها قاعدة البيانات للقراءة فقط.

يقوم عرض الاستعلام (Query View) بتشغيل استعلامات SELECT للقراءة فقط مقابل الجداول الحالية في الذاكرة. وهو يدعم بناء الجملة الموضح أدناه؛ ولا يتصل بقاعدة بيانات خارجية. يتم حفظ نص الاستعلام مع سياق مستند SQL.

يتذكر أمر الحفظ (Save) أيضاً جدول البيانات المحدد. تؤدي إعادة الفتح إلى استعادته، مع اعتبار الجدول الأول كخيار بديل إذا كان غير متاح. تقوم حقول المخطط بمحاذاة الأسماء والأنواع والقواعد؛ مرر مؤشر الماوس فوق شارة القاعدة للحصول على شرحها. يؤدي الانتقال إلى SQL بجانب عنوان الجدول إلى فتح علامة تبويب SQL المحددة له والكشف عن عبارة CREATE TABLE، وإعادة فتح لوحة SQL عند إخفائها مع الحفاظ على تحديد البيانات والمسودات. تجمع نتائج الاستعلام بين العدد، والتوقيت، وملائمة العرض، والنسخ، وتنسيق CSV في رأس واحد.

اسحب الفاصل الرفيع بين محرر الاستعلام والنتائج، أو بين مخطط البيانات والصفوف، لتغيير حجم الأجزاء. تعمل مفاتيح الأسهم على تغيير حجم الفاصل المحدد، ويلغي مفتاح Escape السحب، ويؤدي النقر المزدوج إلى إعادة تعيينه. تظل أحجام الأجزاء تفضيلات مؤقتة لمساحة العمل.

يستخدم إنشاء بيانات العينة أنواع الأعمدة، والأسماء، والعلاقات، والقيود الخاصة بك. تتحكم لغة العينة في الأسماء بالإضافة إلى عبارات المنتجات/الوصف الطبيعية بـ 17 لغة. راجع المولدات المقترحة والنطاقات، واعرض النتيجة، ثم أدخل علامة تبويب بيانات عينة منفصلة صراحةً. تظهر قيم Booleans كـ true/false؛ وتبقى معرفات IDs رقمية. لا يستبدل الإنشاء أبداً الصفوف الموجودة.

اختر تصدير ERD لتحديد PNG أو SVG المدعوم بالصور أو PDF بحجم HD أو 2K أو 4K. لا تحل الصور المُصدَّرة محل مستند محفوظ وقابل للتحرير.

سجل الدخول واستخدم حفظ SQL و ERD لحفظ سياق SQL والرسم التخطيطي، بما في ذلك علامات التبويب، وتعديلات الشبكة المطبقة، ونص الاستعلام، والتخطيط. تتحقق عملية الحفظ من الخلية النشطة أو مسودة الصف الجديد أولاً؛ تظل البيانات غير الصالحة مرئية للتصحيح. تحتاج معاينات الاستيراد إلى إجراء الاستيراد صراحةً. افتح الملفات المحفوظة من قائمة الملفات، واستخدم مشاركة على مستند محفوظ مملوك لتكوين الوصول العام وتوزيع رابطه للقراءة فقط.

تفتح مستندات SQL و Prisma و Builder في أدواتها الخاصة. لدى Prisma و Builder قوائم ملفات منفصلة وحفظ سحابي فقط. تحمي مطالبات التغييرات غير المحفوظة المستندات المعدلة عند مغادرة مساحة العمل؛ واحفظ تغييراتك قبل المشاركة أو التبديل بعيداً.

استكشاف أخطاء مساحة العمل لـ SQL وإصلاحها

استكشاف أخطاء مساحة العمل لـ SQL وإصلاحها
العرضما يجب التحقق منه
الجدول مفقودتحقق من تشخيصات التحليل، وعلامات التبويب النشطة، وترتيب العبارات. يمكن أن يغير DROP لاحق أو إعادة تسمية المخطط النهائي.
العلاقة مفقودةتحقق من وجود كلا الجداول والأعمدة، وتطابق عدد أعمدة المفاتيح الخارجية، وأن المفتاح المُشار إليه فريد عالمياً. تأهل بأسماء مخططات مبهمة.
لا يُظهر عرض البيانات أي صفوفضع INSERT بعد CREATE TABLE في علامة تبويب نشطة. افحص سجل التنفيذ بحثاً عن الصفوف المرفوضة أو التراجع عن المعاملة.
لم تعد نتائج الاستعلام تتطابق مع SQLقم بتشغيل الاستعلام مرة أخرى بعد تغيير المخطط أو البيانات؛ واستخدم الجداول الحالية في الذاكرة.
يقترح إضافة جدول لهجة مختلفةيأخذ بناء جملة مساحة العمل النشطة المكتشفة الأولوية على الخيار الاحتياطي المحدد يدويًا. راجع مؤشر لغة SQL والإعدادات الافتراضية الخاصة بالجدول.
تعذر تعديل ملف محفوظتحقق من تسجيل الدخول والملكية. يمنح الرابط العام حق القراءة فقط؛ استخدم إعادة المحاولة أو فتح الملفات لأخطاء التحميل القابلة للاسترداد.

سير عمل بنية الذكاء الاصطناعي

عند استخدام مساعد الذكاء الاصطناعي، اطلبه بإنتاج SQL بهذا الترتيب. هذا يحافظ على النتيجة سهلة التحليل، وسهلة الرسم البياني، وسهلة المعاينة مع صفوف نموذجية أو استعلامات للقراءة فقط.

1. تحديد النطاقات أولاً

ضع تعريفات التعداد/المركب لـ CREATE TYPE قبل الجداول التي تشير إليها. فضّل الأسماء الصريحة على الأنواع المضمنة المخصصة عندما يتم مشاركة مجال ما.

2. إنشاء الجداول الأساسية

استخدم CREATE TABLE للأعمدة، والمفاتيح الأساسية، والتفرُّد، والقيم الافتراضية، والفحوصات، والأعمدة المُنشأة، والمفاتيح الخارجية المضمنة.

3. إعادة تشغيل عمليات الترحيل

استخدم ALTER TABLE للقيود المضافة، وإعادة التسْمية، والأعمدة المحذوفة، وتغييرات نوع العمود/قابلية القبول للقيم الفارغة (nullability)، والمفاتيح الخارجية الدائرية.

4. إضافة البيانات والاستعلامات أخيرًا

ضع INSERT/UPDATE/DELETE بعد جميع أوامر DDL. احتفظ باستعلامات SELECT منفصلة عن تحويل المخطط عندما تريد مجموعات نتائج.

نصيحة لموجه الذكاء الاصطناعي: اطلب نص SQL واحداً كاملاً ومنتهياً بفاصلة منقوطة. أخبر الذكاء الاصطناعي بتجنب الكائنات غير المدعومة مثل الإجراءات المخزنة، والمشغلات (triggers)، و CTEs التكرارية في استعلامات SELECT للقراءة فقط، و ALTER TYPE. يتم الاحتفاظ بفهارس التعبير مع تحذير؛ اطلب مفاتيح أعمدة بسيطة عندما تحتاج إلى شارات فهارس ERD.

بناء جملة DDL و DML

أشكال العبارات هذه آمنة لنصوص المخططات التي تم إنشاؤها بواسطة الذكاء الاصطناعي وبيانات النموذج. يقود نفس النحو بنية ERD وصفوف معاينة الذاكرة، لذا احتفظ بـ DDL قبل DML وتجنب الآثار الجانبية الخارجية الخاصة بقاعدة البيانات.

العبارات المدعومة

SQL / مثال
-- Schema statements
CREATE TYPE type_name AS ENUM (...);
CREATE TYPE type_name AS (...);
CREATE TABLE table_name (...);
CREATE OR REPLACE TABLE table_name (...);
CREATE VIEW view_name AS SELECT ...;
CREATE OR REPLACE VIEW view_name AS SELECT ...;
CREATE OR ALTER VIEW view_name AS SELECT ...;
ALTER TABLE table_name ADD ...;
ALTER TABLE table_name DROP COLUMN column_name;
ALTER TABLE table_name RENAME COLUMN old_name TO new_name;
CREATE INDEX index_name ON table_name (column_name);
DROP INDEX index_name;
TRUNCATE TABLE table_name;
DROP TABLE [IF EXISTS] table_name;
DROP VIEW [IF EXISTS] view_name;
DROP TYPE [IF EXISTS] type_name;

-- Data statements
INSERT INTO table_name [(col1, col2, ...)] VALUES (...), (...);
UPDATE table_name SET col1 = value WHERE condition;
DELETE FROM table_name WHERE condition;
دعم WHERE: =, !=, <>, >, <, >=, <=, LIKE, NOT LIKE, IN, NOT IN, BETWEEN, NOT BETWEEN, IS NULL, IS NOT NULL، بالإضافة إلى AND / OR التركيبات. تتبع مقارنات NULL منطق UNKNOWN القياسي لـ SQL - col = NULL لا يتطابق أبدا؛ استخدم col IS NULL بدلاً من ذلك. أهداف التعيين غير المعروفة ومراجع الأعمدة اليمنى وأعمدة التصفية ترفض الطفرة الكاملة قبل أي تغيير في الصف.

دلالات المعاينة لأوامر DML المُنشأة بواسطة الذكاء الاصطناعي

إنشاء بيانات عينة محلياً: في عرض البيانات (Data View)، اختر إنشاء بيانات نموذجية، اختر الكشف التلقائي أو لهجة SQL، وقاموس أسماء من 26 دولة أو اللغة الإنجليزية العامة، ونسبة اختيارية للقيم التي تقبل القيم الفارغة، وعدد صفوف الجدول، وتوسيع الجدول لتخصيص مولداته، أو نطاقاته، أو قيمه المسموحة. قم بالمعاينة أولاً، ثم انسخ/قم بتنزيل SQL أو أدرج جديداً بيانات نموذجية علامة تبويب. لا توجد حاجة لمفتاح ذكاء اصطناعي أو طلب بيانات خارجي. إذا قست استبدال المخطط المدمج، فاجعل علامة تبويب بيانات التجارة الإلكترونية النموذجية القديمة غير نشطة أولاً. يحافظ التوليد على الصفوف الموجودة، ونسخ مجموعات المفاتيح الأجنبية الكاملة مع تغطية الأب المتوازنة، والتحقق من القيود والأنواع العددية المدعومة. قيود CHECK المصنوعة بالكامل من IS NULL / IS NOT NULL، و AND، و OR، والأقواس تأخذ الأولوية على نسبة NULL الاختيارية، بما في ذلك مراجع المنشور/الفيديو الحصرية. يحتوي الكتالوج على أكثر من 4,200 إدخال مضمن، بما في ذلك أكثر من 2,600 اسم بالتهجئة الأصلية ومعالجات البريد الإلكتروني ASCII، بالإضافة إلى الشركات والمنتجات والوظائف والشوارع والأوصاف باللغة الطبيعية وأمثلة المواقع عبر أكثر من 40 دولة، إلى جانب العملات وعناوين IP ووحدات SKU والحالات والألوان والتواريخ و JSON. تدعم الدفعات ما يصل إلى 5,000 صف لكل جدول، و 10,000 صف و 150,000 خلية إجمالاً، و 5 ميجابايت من SQL. تتطلب دورات العلاقات الفارغة المطلوبة، والنطاقات الفريدة المستنفدة، وأسماء الجداول المتصادمة عبر المخططات، وأنواع المعقدة المطلوبة غير المدعومة تعديلات قبل أنสิ้น التوليد. يمكن أن تصبح القيم المعقدة القابلة للقيم الفارغة والمراجع الكاسرة للدورة فارغة (NULL) مع ملاحظة معاينة. تكرر البذور قيم القاموس المُولَّدة؛ لا تزال القيم الافتراضية لقاعدة البيانات تتبع سلوكها العادي. أكمل مراجعة الذكاء الاصطناعي أولاً، وأعد فتح المولد إذا تغير مساحة عمل SQL.

يتم إعادة تشغيل الصفوف من الصفر

يتم تطبيق عبارات DDL و DML معاً بترتيب المصدر؛ تستخدم كل عبارة بيانات المخطط الفعالة في تلك اللحظة.

الأنواع تظل قابلة للفحص

تظل التعدادات المسماة والأنواع المركبة التي يتم إنشاؤها باستخدام CREATE TYPE جزءاً من المخطط الذي تم تحليله.

يتم فرض القيود

تؤثر أعمدة PK، وFK، وNOT NULL، وUNIQUE، وDEFAULT، وCHECK، والأعمدة المُولَّدة، ونطاقات التعداد (enum) على صفوف المعاينة.

يجب أن تكون الأخطاء قابلة للإصلاح

فضّل قوائم الأعمدة الصريحة وشروط WHERE المحددة حتى تتمكن التشخيصات من الإشارة إلى الجدول أو العمود بالضبط.

لا تطلب من الذكاء الاصطناعي الاعتماد على: مستقل SELECT مجموعات النتائج في النص البرمجي الرئيسي للـ schema/DML، أو الأجسام الإجرائية غير المدعومة، أو مكالمات قاعدة البيانات الخارجية. CREATE VIEW, CREATE OR REPLACE VIEW، و MSSQL CREATE OR ALTER VIEW يتم تحقيقها من SELECT نتيجة للمعاينة؛ احتفظ بالاستعلامات المخصصة للقراءة فقط منفصلة.

المعاملات في عرض البيانات

يدعم عرض البيانات BEGIN، وCOMMIT، وROLLBACK، وSAVEPOINT، وROLLBACK TO، وRELEASE في المعاينة الموجودة في الذاكرة. تؤثر هذه العبارات على صفوف المعاينة؛ ولا يتم اعتمادها أبداً في قاعدة بيانات خارجية.

تحتفظ SQLite و PostgreSQL و SQL Server بتعليمات DDL الخاصة بالمعاملات في المعاينة. يقوم DDL في MySQL بارتكاب المعاملة النشطة. تؤثر أوامر SQLite PRAGMA foreign_keys و MySQL SET FOREIGN_KEY_CHECKS على التحقق اللاحق من DML.

يتجاهل عارض ERD غلاف المعاملات ويمثل عبارات المخطط بترتيب المصدر. لذلك يمكن أن ينتج عن التراجع عن المعاملة في عرض البيانات مجموعة مختلفة من الجداول عن الرسم التخطيطي. تحقق من كل منضدة عمل للتعرف على السلوك الذي تختبره.

SQL / معاينة المعاملة
CREATE TABLE preview_items (
  id INTEGER PRIMARY KEY,
  label TEXT NOT NULL
);
INSERT INTO preview_items (id, label) VALUES (1, 'Before transaction');

BEGIN;
INSERT INTO preview_items (id, label) VALUES (2, 'Keep this row');
SAVEPOINT before_trial;
INSERT INTO preview_items (id, label) VALUES (3, 'Undo this row');
ROLLBACK TO before_trial;
RELEASE before_trial;
COMMIT;
في هذا المثال، يحتفظ عرض البيانات بالعنصرين 1 و 2. تتم إزالة العنصر 3 بواسطة ROLLBACK TO قبل COMMIT. يقرأ عرض الاستعلام (Query View) صفوف المعاينة النهائية هذه.

بناء جملة استعلام SELECT

اطلب من الذكاء الاصطناعي الاحتفاظ باستعلامات التقارير للقراءة فقط كـ SELECT تعليمات. يمكن لهذه الإشارة إلى الجداول والصفوف الناتجة عن النص البرمجي schema/DML وهي مفيدة لعمليات الانضمام، والمرشحات، والمجاميع، ومجموعات النتائج على شكل تقارير دون الحاجة إلى قاعدة بيانات حية.

شكل الاستعلام المدعوم

SQL / مثال
WITH dept_totals AS (
  SELECT department_id, COUNT(*) AS employee_count, SUM(salary) AS payroll
  FROM employees
  GROUP BY department_id
)
SELECT d.name,
       dt.employee_count,
       dt.payroll
FROM dept_totals dt
JOIN departments d ON d.id = dt.department_id
WHERE dt.employee_count >= 1
ORDER BY dt.payroll DESC
LIMIT 10;

SELECT فقط

يقبل محرر الاستعلام عبارات SELECT، بما في ذلك SELECT بدون FROM وعبارات WITH CTE التي تتحلل إلى SELECT.

عمليات الانضمام والفلترة

عمليات الانضمام INNER، وLEFT، وRIGHT، وFULL، وCROSS، وشروط WHERE، وEXISTS، والاستعلامات الفرعية IN، وBETWEEN، وLIKE، وILIK، والتحققات من قيم NULL.

الدوال التجميعية

مجموعات GROUP BY، وHAVING، وCOUNT، وSUM، وAVG، وMIN، وMAX، وARRAY_AGG، وGROUP_CONCAT، وSTRING_AGG، ومتغيرات DISTINCT.

الترتيب والتقسيم إلى صفحات

أسماء ORDER BY أو الترتيبات العددية، ASC/DESC، وNULLS FIRST/LAST، وLIMIT/OFFSET، وTOP، وFETCH FIRST.

دعم متقدم لـ SELECT

CTEs والجداول المشتقة

يتم دعم عبارات WITH وSELECT المتداخلة في FROM والاستعلامات الفرعية القيية وEXISTS وNOT EXISTS وIN وNOT IN.

معاملات المجموعات

يمكن لـ UNION و UNION ALL و INTERSECT و EXCEPT دمج مجموعات النتائج المتوافقة.

دوال النوافذ

أوامر ROW_NUMBER و RANK و DENSE_RANK و NTILE و LAG و LEAD و FIRST_VALUE و LAST_VALUE مع OVER و PARTITION BY. تستخدم النوافذ المرتبة الإطار الافتراضي لـ SQL الواعي للقرناء، ويقوم NTILE بتخصيص الدلاء الأكبر أولاً.

مساعدو اللهجات

يتم تطبيع دوال SQLite و PostgreSQL و MySQL و MSSQL الشائعة للمعاينة، بما في ذلك مساعدي JSON والتاريخ/النص.

للقراءة فقط بحسب التصميم: احتفظ بـ INSERT, UPDATE, DELETE, CREATE, ALTER، و DROP تعليمات في برنامج الـ schema/DML النصي. يجب أن تظل بناء جملة الاستعلام SELECT-فقط.

التشخيص والأخطاء

تظهر تشخيصات النحو مشاكل تحليل المخطط، وتنفيذ DDL/DML، و SELECT للقراءة فقط برسايل واضحة. تتضمن أخطاء التحليل مواضع الأسطر/الأعمدة عندما يكون ممكناً، وتشير رسائل التنفيذ إلى الجدول أو العمود أو شكل العبارة الذي يحتاج إلى تصحيح.

أخطاء تحليل المخطط

يبلغ محلل المخطط (SQLite و PostgreSQL و MySQL و MSSQL) عن المشاكل بمستويين من الخطورة: خطأ يمنع تعليمة واحدة من المساهمة في المخطط؛ تحذير يحافظ على بناء الجملة الصالح ولكنه يعلم شيئا يجب أن يعرفه المستخدم.

SQL / مثال
// Every entry the editor receives has this shape:
{
  message:  "Column 'a' missing data type",
  severity: "error" | "warning",
  position: { line: 1, column: 17, index: 16 },
  token?:   { type, value, raw }   // present for parser-side errors
}

أخطاء المحلل اللغوي

قوائم الأعمدة الفارغة لـ PRIMARY KEY / UNIQUE / FOREIGN KEY، وأنواع البيانات المطلوبة المفقودة (بما في ذلك أعمدة SQLite STRICT)، والأقواس غير المتطابقة، والفواصل غير المتوقعة، والقيود سيئة التنسيق.

تحذيرات محلل الرموز

السلاسل غير المغلقة، وتعليقات الكتل غير المغلقة، والأقواس غير المتطابقة، وتعبيرات CHECK المشبوهة عبر الأسطر.

تحذيرات المفتاح الأجنبي

يتم إسقاط المفاتيح الأجنبية التي تشير إلى جدول غير معروف، أو عمود غير معروف، أو ورقة مخطط غامضة، أو هدف غير PK/غير UNIQUE من المخطط مع تحذير توضيحي.

تشخيصات مجمعة

تم تجميع التحذيرات حسب السبب، بما في ذلك علاقة مهملة، جدول غير معروف، عمود غير معروف، هدف مفتاح خارجي غير فريد، تحذيرات، وأخطاء التحليل.

SQL فارغ

الإدخال الفارغ صالح وينتج مخططاً فارغاً. فقط الإدخالات غير النصية غير الصالحة تُلقي خطأ.

سجل تنفيذ DDL/DML

تُلحق كل عبارة DDL أو DML يتم تنفيذها مدخلًا منظماً واحداً بسجل التنفيذ الموجود في الذاكرة. يحافظ تدفق الرسائل على الترتيب الزمني ويصنف كل عبارة كـ خطأ, تحذير، أو نجاح.

SQL / مثال
// Each log entry is:
{
  type:      "success" | "warning" | "error",
  message:   "Inserted 3 row(s) into \"users\"",
  timestamp: 1734567890123  // ms since epoch, monotonic
}
SQL / مثال
-- Examples ────────────────────────────────────────────────
-- success
CREATE TABLE users (id INT PRIMARY KEY);
-- → success: Table "users" created with 1 columns

-- warning (no WHERE clause)
UPDATE users SET id = 99;
-- → warning: UPDATE "users": no WHERE clause — all 2 row(s) will be affected
-- → success: Updated 2 row(s) in "users"

-- error (unknown table)
INSERT INTO ghost VALUES (1);
-- → error: INSERT INTO "ghost": table does not exist
قابلة للتنفيذ دائماً. يذكر كل خطأ وتحذير اسم الجدول/العمود المخالف، بحيث يمكنك تحديد المشكلة بدقة دون إعادة قراءة البرنامج النصي.

التشخيصات الشائعة

SQL / مثال
error    : INSERT INTO "x": unknown column(s): foo
warning  : INSERT INTO "x" row 3: expected 4 values but got 3
warning  : UPDATE "x": setting NOT NULL column "name" to NULL
warning  : DELETE FROM "x": no WHERE clause — all 1200 row(s) will be removed
error    : DROP: table "ghost" does not exist
warning  : ALTER "x": column "old_col" does not exist
warning  : Relation dropped: foreign key 'posts.user_id' references column
           'users.no_such' which does not exist on table 'users'.
warning  : Relation dropped: foreign key 'events.email' references 'users.email',
           but the target is only partial-unique, not globally unique.
مقاوم للاعطال. يقوم تحليل المخطط، وتنفيذ DDL/DML، وتنفيذ SELECT باسترداد كود SQL التالف إلى أخطاء مرئية حتى تتمكن من الاستمرار في تحسين نفس البرنامج النصي.

CREATE TYPE

تعريف أنواع بيانات مخصصة لإعادة استخدامها عبر مخطط قاعدة البيانات الخاص بك. يجب أن تظهر أنواع التعداد (enum) والمركبة المسماة قبل الجداول التي تشير إليها، بما في ذلك المراجع المؤهلة للمخطط.

1.1. النوع المركب

تعريف أنواع مركبة مخصصة تحتوي على حقول متعددة لأنواع بيانات مختلفة.

SQL / مثال
CREATE TYPE type_name AS (
  field1 data_type1,
  field2 data_type2,
  ...
);

مثال:

SQL / مثال
CREATE TYPE address_type AS (
  street VARCHAR(100),
  city TEXT,
  postal_code INTEGER
);

CREATE TYPE coordinates AS (
  latitude DECIMAL(10, 8),
  longitude DECIMAL(11, 8)
);
أنواع البيانات المدعومة: INTEGER، وBIGINT، وSMALLINT، وTEXT، وVARCHAR(n)، وCHAR(n)، وDECIMAL(p,s)، وNUMERIC، وBOOLEAN، وDATE، وTIME، وTIMESTAMP، وFLOAT، وREAL، وDOUBLE PRECISION، وUUID، وJSON، وJSONB، وBYTEA، وMONEY، والمزيد.

1.2. نوع التعداد (Enum)

إنشاء أنواع مُعدَّدة بقيم محددة مسبقاً لتحسين سلامة البيانات وقراءتها.

SQL / مثال
CREATE TYPE enum_name AS ENUM (
  'value1',
  'value2',
  ...
);

مثال:

SQL / مثال
CREATE TYPE status_enum AS ENUM (
  'pending',
  'active',
  'completed',
  'cancelled'
);

CREATE TYPE priority_level AS ENUM (
  'low', 'medium', 'high', 'critical'
);
مهم: يجب وضع قيم التعداد داخل علامات اقتباس مفردة ('value') وليست مزدوجة.

1.3. الأنواع المؤهلة للمخطط

يتم تحليل الأنواع المعرفة من قبل المستخدم بنفس وعي المخطط مثل الجداول. إذا حدد مخططين نفس اسم الورقة، فإن ERD يبقيهما منفصلين؛ وإذا كان النوع فريدا، يظل اسم العرض بسيطا.

SQL / مثال
CREATE TYPE s1.status AS ENUM ('draft', 'active');
CREATE TYPE s2.status AS ENUM ('queued', 'done');

CREATE TABLE s1.items (
  id    INT PRIMARY KEY,
  state s1.status
);

CREATE TABLE s2.items (
  id    INT PRIMARY KEY,
  state s2.status
);
قاعدة الدقة: s1.status لا يحل أبدا إلى s2.status فقط لأن كلاهما يتشاركان اسم الورقة status. أسماء الأنواع المؤهلة صارمة، بينما تحل الأنواع غير المؤهلة محلها فقط عندما تكون غير غامضة.

CREATE TABLE

تعريف جداول قاعدة البيانات مع الأعمدة وأنواع البيانات والقيود.

2.1. هيكل الجدول الأساسي

النحو العام لإنشاء جدول:

SQL / مثال
CREATE TABLE table_name (
  column_name data_type [constraints],
  ...
  -- table-level constraints (optional)
);

-- Also supports:
CREATE TABLE IF NOT EXISTS table_name ( ... );
CREATE TABLE schema_name.table_name ( ... );
ملاحظة: يمكن أن تستخدم أسماء الجداول والأعمدة علامات التنصيص المزدوجة ("name")، وعلامات الاقتباس المرتدة (\`name\`)، أو الأقواس المربعة ([name]) لتجنب الأحرف الخاصة أو الكلمات المحجوزة.

2.2. تعريفات مستوى العمود

يمكن أن يتضمن كل عمود قيوداً وخصائص مختلفة:

SQL / مثال
CREATE TABLE users (
  id INTEGER PRIMARY KEY,
  username VARCHAR(50) UNIQUE NOT NULL,
  email TEXT NOT NULL CHECK (email LIKE '%@%'),
  status VARCHAR(20) DEFAULT 'active',
  created_at TIMESTAMP DEFAULT now(),
  department_id INTEGER REFERENCES departments(id)
);

PRIMARY KEY

يحدد كل صف بشكل فريد

فريد (UNIQUE)

يضمن أن قيم الأعمدة مميزة

NOT NULL

يمنع القيم الفارغة (null)

DEFAULT

تعيين القيم الافتراضية (القيم الحرفية أو الدوال)

CHECK

يتحقق من البيانات بتعابير منطقية

REFERENCES

ينشئ علاقات المفتاح الخارجي

تدعم قيم DEFAULT:
  • القيم الحرفية: الأرقام (123)، والنصوص ('text')
  • دوال PostgreSQL: now(), CURRENT_TIMESTAMP, CURRENT_DATE, nextval('seq'::regclass)
  • دوال MSSQL: GETDATE(), NEWID()
REFERENCES (مضمنة): يتعرف على REFERENCES table(column)، والمؤهلة بالمخطط REFERENCES schema.table(column)، والأعمدة المستهدفة المحذوفة مثل REFERENCES departments، وإجراءات المفتاح الأجنبي مثل ON DELETE CASCADE, ON UPDATE SET NULL, MATCH FULL، و DEFERRABLE INITIALLY DEFERRED.

2.3. الأعمدة المُنشأة / المحسوبة

مرجع سريع. راجع الأعمدة المحسوبة القسم أدناه للحصول على تفصيل كامل لكل لهجة بما في ذلك نموذج MSSQL المجرد AS.

SQL / مثال
CREATE TABLE products (
  id SERIAL PRIMARY KEY,
  price NUMERIC(10, 2),
  quantity INTEGER,

  -- PostgreSQL / MySQL: parenthesized expression
  total NUMERIC GENERATED ALWAYS AS (price * quantity) STORED,

  -- MySQL VIRTUAL column
  discount NUMERIC GENERATED ALWAYS AS (price * 0.1) VIRTUAL
);

2.4. أنواع التعداد المضمنة (ENUM)

يمكنك إعلان ENUM مباشرة في تعريج عمود (أسلوب MySQL). سيقوم المحلل بتسجيله كنوع تعداد مسمن واستبدال نوع العمود تلقائيا.

SQL / مثال
CREATE TABLE tasks (
  id INTEGER PRIMARY KEY,
  status ENUM('todo', 'doing', 'done'),
  priority ENUM('low', 'medium', 'high')
);
كيف يعمل: يتم تسجيل تعدادات ENUM المدمجة تلقائياً كأنواع مسماة. يستخدم الاسم البسيط الأول column_enum (على سبيل المثال، status_enum); الجداول اللاحقة ذات التعريف المختلف لنفس اسم العمود تحصل على اسم مؤهل بالجدول مثل tasks_status_enum حتى لا تنهار النطاقاتها عن طريق الخطأ.
نصيحة: إذا كنت بحاجة إلى تعدادات مشتركة أو أسماء مخصصة، فحددها صراحة باستخدام CREATE TYPE ... AS ENUM بدلاً من ذلك.

2.5. قيود مستوى الجدول

قم بتعريف القيود في نهاية نص الجدول. مفيد للمفاتيح المركبة والقيود متعددة الأعمدة:

SQL / مثال
-- Syntax:
[CONSTRAINT name] PRIMARY KEY (col1, col2, ...)

[CONSTRAINT name] FOREIGN KEY (col1, col2, ...)
  REFERENCES ref_table(ref_col1, ref_col2, ...)
  [MATCH FULL|PARTIAL|SIMPLE]
  [ON DELETE CASCADE|RESTRICT|SET NULL|SET DEFAULT|NO ACTION]
  [ON UPDATE CASCADE|RESTRICT|SET NULL|SET DEFAULT|NO ACTION]
  [DEFERRABLE|NOT DEFERRABLE] [INITIALLY DEFERRED|IMMEDIATE]

[CONSTRAINT name] UNIQUE (col1, col2, ...)

[CONSTRAINT name] CHECK (expression)

مثال:

SQL / مثال
CREATE TABLE order_items (
  order_id INTEGER,
  product_id INTEGER,
  quantity INTEGER CHECK (quantity > 0),
  unit_price NUMERIC(10, 2),

  CONSTRAINT pk_order_items
    PRIMARY KEY (order_id, product_id),
  CONSTRAINT fk_order
    FOREIGN KEY (order_id) REFERENCES orders(id),
  CONSTRAINT fk_product
    FOREIGN KEY (product_id) REFERENCES products(id),
  CONSTRAINT uq_order_product
    UNIQUE (order_id, product_id),
  CONSTRAINT chk_price
    CHECK (unit_price >= 0)
);
القيود المدعومة: يتم دعم قيود PRIMARY KEY و FOREIGN KEY و UNIQUE و CHECK على مستوى الجدول. اسم القيد (CONSTRAINT name) اختياري.
صحة المفتاح الأجنبي: إذا REFERENCES ref_table يحذف قائمة الأعمدة المستهدفة، فتحلها Erd Go إلى المفتاح الأساسي للجدول المُشار إليه، بما في ذلك المفاتيح الأساسية المركبة. إذا حددت الأعمدة المستهدفة صراحةً، فيجب أن تكون مدعومة بمفتاح أساسي PRIMARY KEY، أو قيد فريد UNIQUE، أو عام CREATE UNIQUE INDEX; الفهارس الفريدة المُصفاة / الجزئية لا تُعد أهدافاً للمفاتيح الخارجية. يتم إسقاط العلاقات غير الصالحة مع إعطاء تحذير.

2.6. أسماء الأعمدة ذات الكلمات المحجوزة

كلمات مثل key, index, value، و name محجوزة في بعض اللهجات ولكنها تستخدم بشكل شائع كأسماء أعمدة في حالات أخرى. يزيل المحلل الغموض تلقائيا عندما يكون الرمز التالي هو نوع بيانات معروف، لذا يعمل الاستخدام المجرد غير المقتبس:

SQL / مثال
CREATE TABLE feature_flags (
  id        BIGSERIAL PRIMARY KEY,
  org_id    BIGINT NOT NULL,
  key       VARCHAR(128) NOT NULL,   -- 'key' as column name → OK
  index     INT,                     -- 'index' as column name → OK
  value     TEXT,                    -- 'value' as column name → OK
  enabled   BOOLEAN NOT NULL DEFAULT FALSE,
  UNIQUE (org_id, key)
);

-- The MySQL "KEY ... (cols)" index form is still recognized correctly
CREATE TABLE posts (
  id   INT PRIMARY KEY,
  body TEXT,
  KEY idx_body (body),                 -- treated as index, adds IDX badge
  FULLTEXT KEY ft_body (body)          -- treated as fulltext index badge
);
قاعدة إزالة الغموض: KEY / INDEX / FULLTEXT / SPATIAL متبوعا بكلمة مفتاحية لنوع البيانات (VARCHAR, INT، ...) هو عمود. يليه معرف وقائمة أعمدة بين قوسين، وهو فهرس. للأمان المطلق، ضع العمود بين علامتي اقتباس مع "key", `key`، أو [key].

أعمدة الهوية / الترقيم التلقائي

استخدم بناء الهوية الأصلي اللهجة المحددة. تنتج جميع الأشكال المدعومة عمود مفتاح أساسي مع AUTO_INCREMENT علامة، ولكن لدى SQLite قاعدة صارمة واحدة: AUTOINCREMENT يتطلب مفرداً INTEGER PRIMARY KEY عمود.

SQLite

SQL / مثال
-- Rowid alias; auto assigns a value when omitted
CREATE TABLE users (
  id INTEGER PRIMARY KEY,
  email TEXT NOT NULL UNIQUE
);

-- AUTOINCREMENT prevents rowid reuse after DELETE
CREATE TABLE events (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  name TEXT NOT NULL
);

-- Invalid for SQLite AUTOINCREMENT:
-- 1. BIGINT PRIMARY KEY AUTOINCREMENT
-- 2. INT PRIMARY KEY AUTOINCREMENT
-- 3. AUTOINCREMENT on a composite primary key
قاعدة SQLite: استخدم تماماً INTEGER PRIMARY KEY AUTOINCREMENT. لا تستخدم BIGINT, INT، أو مفتاح أساسي مركب مع AUTOINCREMENT.

PostgreSQL

SQL / مثال
-- Classic SERIAL family
CREATE TABLE users (
  id SERIAL PRIMARY KEY,
  big_id BIGSERIAL,
  small_id SMALLSERIAL
);

-- Modern SQL-standard identity columns
CREATE TABLE events (
  id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
  name TEXT
);

CREATE TABLE invoices (
  id BIGINT GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY
);
مهم: GENERATED ALWAYS AS IDENTITY هو الهوية عمود (زيادة تلقائية)، يختلف عن GENERATED ALWAYS AS (expression) وهو محسوب عمود. يبقيهما المحلل منفصلين تلقائيا.

MySQL

SQL / مثال
CREATE TABLE users (
  id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
  email VARCHAR(255) NOT NULL UNIQUE
) ENGINE=InnoDB;

MSSQL / SQL Server

SQL / مثال
-- IDENTITY(seed, increment)
CREATE TABLE [dbo].[Customers] (
  [CustomerID] BIGINT IDENTITY(1,1) NOT NULL CONSTRAINT pk_customer PRIMARY KEY,
  [Email] NVARCHAR(255) NOT NULL
);

-- Bare IDENTITY (defaults to (1,1))
CREATE TABLE [dbo].[Orders] (
  [OrderID] INT IDENTITY NOT NULL PRIMARY KEY
);
مخرجات ERD: كل نموذج أعلاه يظهر بشكل متطابق في المخطط - رمز مفتاح PK بالإضافة إلى AUTO_INCREMENT وسم — بحيث يمكنك مزج اللهجات في مخطط واحد دون فقدان تلميح الزيادة التلقائية.

الأعمدة المحسوبة (لكل لهجة)

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

PostgreSQL و MySQL — GENERATED ALWAYS AS

SQL / مثال
CREATE TABLE products (
  id SERIAL PRIMARY KEY,
  price NUMERIC(10,2),
  qty INTEGER,
  total NUMERIC GENERATED ALWAYS AS (price * qty) STORED,
  discount NUMERIC GENERATED ALWAYS AS (price * 0.1) VIRTUAL
);

-- Complex expressions, including CASE
CREATE TABLE orders (
  id BIGSERIAL PRIMARY KEY,
  qty INT,
  flag INT GENERATED ALWAYS AS (CASE WHEN qty > 100 THEN 1 ELSE 0 END) STORED
);
أنماط قاعدة البيانات: في قاعدة بيانات أصلية، STORED يخزن القيمة المحسوبة و VIRTUAL يحسبه عند القراءة. يحتفظ Erd Go بقيم المعاينة في الذاكرة؛ ويحافظ ERD على كل وضع كبيانات وصفية للعمود.

MSSQL / SQL Server — العمود AS تعبير [PERSISTED]

يحتوي MSSQL على بناء الجملة الخاص به: column_name AS expression، يليه اختيارياً PERSISTED (واختيارياً NOT NULL). كلاهما بين قوسين و مجرد أشكال التعبير مدعومة.

SQL / مثال
CREATE TABLE [dbo].[Customers] (
  [CustomerID] BIGINT IDENTITY(1,1) NOT NULL CONSTRAINT pk_c PRIMARY KEY,
  [FirstName] NVARCHAR(50) NOT NULL,
  [LastName]  NVARCHAR(50) NOT NULL,

  -- Parenthesized form
  [FullName] AS ([FirstName] + ' ' + [LastName]) PERSISTED,

  -- Bare form (no parens) — also accepted
  [Initials] AS LEFT([FirstName], 1) + LEFT([LastName], 1)
);

CREATE TABLE [dbo].[Loans] (
  [LoanID] BIGINT IDENTITY(1,1) NOT NULL PRIMARY KEY,
  [StartDate] DATE NOT NULL,
  [TermMonths] INT NOT NULL,

  -- Function call in a bare AS expression
  [MaturityDate] AS DATEADD(MONTH, [TermMonths], [StartDate]) PERSISTED,

  -- CASE expression in a bare AS
  [SignedAmount] AS CASE WHEN [TermMonths] > 12 THEN 1 ELSE 0 END
);
AS العارضة: يقبل المحلل col AS expression (بدون أقواس محيطة) - بما في ذلك استدعاءات الدوال مثل DATEADD(...)، والمراجع المؤهلة للجدول مثل c.GrowthDurationDays، و CASE التعابير - تنتهي عند فاصلة العمود التالية، PERSISTED، أو نهاية جسم الجدول.
مخرجات ERD: تظهر جميع الأعمدة المحسوبة COMPUTED كنوع والتعبير المحفوظ في إضافات العمود / تلميح الأدوات.

ALTER TABLE

على غرار الهجرة الشائعة ALTER TABLE يتم تشغيل التعليمات مرة أخرى بعد إنشاء الجدول، بحيث يعكس المخطط النهائي الأعمدة المضافة، والقيود، وإعادة التسمية، والأعمدة المحذوفة، وتغييرات نوع العمود/قابلية الخلو. بناء جملة تفريغ PostgreSQL باستخدام ALTER TABLE ONLY يحافظ على هوية الجدول المؤهل.

إضافة وتقييد

أوامر ADD COLUMN، و ADD PRIMARY KEY، و ADD UNIQUE، و ADD CHECK، و ADD FOREIGN KEY ينعكس ظهورها في مخطط ERD.

إعادة التسمية والإسقاط

تظل عمليات إعادة تسمية الجدول، والعمود، والقيد، والفهرس—بما في ذلك MySQL RENAME TABLE، و PostgreSQL ALTER INDEX، و SQL Server sp_rename—مرتبطة بتجسيد الكائن الصحيح قبل عمليات DROP اللاحقة.

تغييرات الأعمدة

يتم إعادة تشغيل أوامر PostgreSQL التالية: ALTER COLUMN TYPE/SET DATA TYPE/SET أو DROP DEFAULT/nullability، و MSSQL ALTER COLUMN، و MySQL MODIFY/CHANGE COLUMN.

سلامة العلاقات

يتم التحقق من صحة المفاتيح الأجنبية مقابل حالة الجدول النهائية بعد إعادة تشغيل الترحيل، بما في ذلك تغييرات PK/UQ/index وأعداد الأعمدة المصدر/الهدف الدقيقة.

3.1. إضافة مفتاح أجنبي

SQL / مثال
ALTER TABLE table_name
  ADD [CONSTRAINT name] FOREIGN KEY (cols...)
    REFERENCES ref_table[(ref_cols...)]
    [ON DELETE action] [ON UPDATE action]
    [DEFERRABLE|NOT DEFERRABLE] [INITIALLY DEFERRED|IMMEDIATE];

مثال:

SQL / مثال
ALTER TABLE orders
  ADD CONSTRAINT fk_orders_customer
  FOREIGN KEY (customer_id)
  REFERENCES customers(id)
  ON DELETE CASCADE;

3.2. إضافة مفتاح أساسي

SQL / مثال
ALTER TABLE table_name
  ADD [CONSTRAINT name] PRIMARY KEY (cols...);

مثال:

SQL / مثال
ALTER TABLE products
  ADD CONSTRAINT pk_products
  PRIMARY KEY (product_id);

3.3. إضافة قيد فريد

SQL / مثال
ALTER TABLE table_name
  ADD [CONSTRAINT name] UNIQUE (cols...);

مثال:

SQL / مثال
ALTER TABLE users
  ADD CONSTRAINT uq_users_email
  UNIQUE (email);

3.4. إضافة قيد تحقق

SQL / مثال
ALTER TABLE table_name
  ADD [CONSTRAINT name] CHECK (expression);

مثال:

SQL / مثال
ALTER TABLE employees
  ADD CONSTRAINT chk_salary
  CHECK (salary >= 0);

3.5. مثال على إعادة تشغيل الترحيل

SQL / مثال
CREATE TYPE app.ticket_status AS ENUM ('new', 'open', 'closed');

CREATE TABLE app.accounts (
  tenant_id  INT NOT NULL,
  account_no TEXT NOT NULL,
  status     app.ticket_status NOT NULL DEFAULT 'new',
  PRIMARY KEY (tenant_id, account_no)
);

CREATE TABLE app.contacts (
  tenant_id   INT NOT NULL,
  account_no  TEXT NOT NULL,
  owner_email TEXT,
  CONSTRAINT fk_contacts_account
    FOREIGN KEY (tenant_id, account_no)
    REFERENCES app.accounts
    ON DELETE CASCADE
    DEFERRABLE INITIALLY DEFERRED
);

ALTER TABLE app.contacts ADD COLUMN audit_state TEXT;
ALTER TABLE app.contacts ALTER COLUMN owner_email TYPE VARCHAR(320);
ALTER TABLE app.contacts ALTER COLUMN owner_email SET NOT NULL;
ALTER TABLE app.contacts RENAME COLUMN owner_email TO contact_email;
ALTER TABLE app.contacts DROP COLUMN audit_state;

CREATE UNIQUE INDEX ux_contacts_email
  ON app.contacts (contact_email);
ما يفعله ERD: يتحلل مفتاح جهة الاتصال الخارجي (contact FK) إلى المفتاح الأساسي المركب على app.accounts, owner_email يصبح contact_email, audit_state تتم إزالته، ويمنح الفهرس الفريد contact_email a UQ شارة.

3.6. أمر CHANGE / MODIFY COLUMN في MySQL

SQL / مثال
CREATE TABLE `customers` (
  `id` BIGINT AUTO_INCREMENT PRIMARY KEY,
  `email` VARCHAR(320) NOT NULL,
  UNIQUE INDEX `ux_customers_email` (`email`)
) ENGINE=InnoDB;

CREATE TABLE `orders` (
  `id` BIGINT AUTO_INCREMENT PRIMARY KEY,
  `customer_email` VARCHAR(320),
  `status` ENUM('new','paid') NOT NULL DEFAULT 'new',
  `old_note` VARCHAR(50),
  CONSTRAINT `fk_orders_customer`
    FOREIGN KEY (`customer_email`)
    REFERENCES `customers`(`email`)
    ON DELETE SET NULL
) ENGINE=InnoDB;

ALTER TABLE `orders`
  CHANGE COLUMN `old_note` `note` VARCHAR(255) NOT NULL;
ALTER TABLE `orders`
  MODIFY COLUMN `status` ENUM('new','paid') NOT NULL DEFAULT 'paid';

3.7. أمر ALTER COLUMN في MSSQL / SQL Server

SQL / مثال
CREATE TABLE [dbo].[Customers] (
  [CustomerID] INT IDENTITY(1,1) NOT NULL,
  [Email] NVARCHAR(320) NOT NULL,
  CONSTRAINT [PK_Customers] PRIMARY KEY CLUSTERED ([CustomerID]),
  CONSTRAINT [UQ_Customers_Email] UNIQUE NONCLUSTERED ([Email])
);

CREATE TABLE [dbo].[Orders] (
  [OrderID] INT IDENTITY(1,1) NOT NULL,
  [CustomerEmail] NVARCHAR(320),
  [LegacyNote] NVARCHAR(50),
  CONSTRAINT [PK_Orders] PRIMARY KEY NONCLUSTERED ([OrderID]),
  CONSTRAINT [FK_Orders_Customers]
    FOREIGN KEY ([CustomerEmail])
    REFERENCES [dbo].[Customers]([Email])
    ON DELETE SET NULL
);

ALTER TABLE [dbo].[Orders]
  ALTER COLUMN [LegacyNote] NVARCHAR(255) NOT NULL;
ALTER TABLE [dbo].[Orders]
  ADD [CreatedAt] DATETIME2 NOT NULL DEFAULT '2026-01-01';
حد النحو: إعادة تشغيل عمليات ترحيل SQL إلى ERD أغنى عمداً من تنفيذ عرض البيانات (Data View). يظل تحليل المخطط النهائي مقتصراً على المتصفح ولا يتطلب اتصالاً بقاعدة البيانات؛ ولا تؤدي عبارات التنفيذ وحدها إلى إضعاف نموذج دورة حياة ERD.

CREATE INDEX

يتم تحليل DDL الخاص بالفهرس عبر اللهجات الأربع جميعها. تظهر مفاتيح الأعمدة البسيطة كشارات ERD صغيرة: IDX لتحسينات السرعة غير الفريدة، UQ للفهارس الفريدة العالمية، و PUQ للفهارس الفريدة المصفاة / الجزئية. يتم الاحتفاظ بإدخالات التعبيرات في مخرجات المحلل والإبلاغ عنها عندما لا يمكن تعيينها بصدق لشارة عمود.

شارة IDX

فهرس غير فريد. قرص صلب على العمود. تكتم الفهارس المركبة القرص (باللون الرمادي) على كل عمود مفتاحي بحيث يكون الفرق بين عمود مفرد وعمود متعدد واضحاً بنظرة سريعة.

شارة UQ

من CREATE UNIQUE INDEX عالمي. يتصرف مثل قيد UNIQUE للتحقق من صحة المفتاح الأجنبي وشارات الأعمدة.

شارة PUQ

من CREATE UNIQUE INDEX ... WHERE. يظهر محدد التفرد الجزئي ولكنه لا يتحقق من صحة أهداف المفاتيح الأجنبية كفريدة عالمياً.

قاعدة القمع

القيود الأقوى تفوز: PK ⟶ UQ ⟶ PUQ ⟶ IDX. لا يتم تخفيض رتبة مفتاح أقوى بواسطة فهرس لاحق.

متعدد اللهجات

PostgreSQL CONCURRENTLY / USING / INCLUDE / WHERE، و MySQL FULLTEXT/SPATIAL و inline KEY/INDEX، و MSSQL CLUSTERED/NONCLUSTERED مع INCLUDE، وفهارس SQLite القياسية.

4.1. النحو

SQL / مثال
CREATE [UNIQUE] INDEX [IF NOT EXISTS] [name]
  ON [schema.]table (col1 [ASC|DESC] [NULLS FIRST|LAST], col2, ...)
  [INCLUDE (cols)]      -- PG / MSSQL: covering columns (no badge added)
  [WHERE predicate]     -- PG / MSSQL: partial / filtered index
  [USING method]        -- PG: btree, hash, gin, gist, brin
  [WITH (options)];     -- storage parameters

4.2. أمثلة

تسريع بحث المفتاح الخارجي المتكرر (فهرس أحادي العمود IDX):

SQL / مثال
CREATE INDEX idx_orders_customer ON orders (customer_id);

فهرس مركب (حبة IDX باهتة على كل عمود مفتاح):

SQL / مثال
CREATE INDEX idx_orders_customer_status
  ON orders (customer_id, status);

ترقية العمود إلى UNIQUE دون تغيير تعريفه:

SQL / مثال
CREATE UNIQUE INDEX uq_shipments_tracking
  ON shipments (tracking_number);

فهرس فريد جزئي / مفلتر (PUQ، وليس هدف مفتاح خارجي عام):

SQL / مثال
CREATE UNIQUE INDEX ux_users_active_email
  ON users (email)
  WHERE deleted_at IS NULL;

فهرس MySQL المدمج داخل CREATE TABLE:

SQL / مثال
CREATE TABLE posts (
  id INT PRIMARY KEY,
  slug VARCHAR(160) NOT NULL,
  body TEXT,
  UNIQUE INDEX ux_posts_slug (slug),
  KEY idx_posts_body (body),
  FULLTEXT KEY ft_body (body)
);

MSSQL / SQL Server مؤشر مفلتر + تضمن (INCLUDE):

SQL / مثال
CREATE NONCLUSTERED INDEX idx_active_orders
  ON orders (customer_id)
  INCLUDE (total)
  WHERE status = 'active';

4.3. السلوك والدلالات

  • فهارس الوظائف / التعبير (على سبيل المثال CREATE INDEX … ON t (lower(email))) يتم الاحتفاظ بها وتنتج تحذيراً صريحاً ولكن بدون شارة — فهي لا تُعيّن بشكل نظيف إلى عمود واحد.
  • تضمين الأعمدة (INCLUDE) (أعمدة التغطية) يتم تحليلها ولكن لا يتم وضع شارة لها أبداً - فقط أعمدة المفاتيح تحظى بالشارة.
  • أعمدة PK / UQ هي ضمانات أقوى من IDX، لذا فإن أي لاحق CREATE INDEX عليها يتم تخطيها بصمت - فلن ترى عناصر مكررة.
  • فهارس فريدة جزئية / مفلتره تُعرض كـ PUQ مع الـ WHERE مسند في تفاصيل الأعمدة. لا تُقبل كأهداف فريدة عالمياً للتحقق من صحة المفتاح الأجنبي.
  • شارات النهاية لا تتأثر بالترتيب: يمنع ضمان الفرادة العالمي IDX شارة ما إذا كان الفهرس الفريد أو غير الفريد يظهر أولاً. يتم الاحتفاظ ببيانات الفهرس المركب بغض النظر عن ترتيب الإعلان.
  • الفهارس على الجداول / الأعمدة غير المعروفة يتم إسقاطها بصمت - مفيد عند نقل مخططات جزئية دون كسر المخطط.
  • دورة حياة الفهرس يتضمن مستوى أعلى CREATE/DROP INDEX، و PostgreSQL DROP INDEX CONCURRENTLY، و MySQL ALTER TABLE … ADD/DROP/RENAME INDEX، و PostgreSQL ALTER INDEX … RENAME، وإعادة تسمية فهارس SQL Server عبر sp_rename. تتبع بيانات الوصف الخاصة بـ UQ/PUQ/IDX المسمى الاسم النهائي الباقي.
نصيحة: تظهر حبوب IDX المركبة بلون رمادي خافت لتعكس اللغة البصرية للمفاتيح الأساسية المركبة / المفاتيح الفريدة المركبة. تعني حبة IDX الصلبة دائماً "فهرساً من عمود واحد" - سهلة القراءة في المخططات الكثيفة.

دعم متعدد اللهجات

يتعامل محلل جانب المتصفح مع اختلافات النحو عبر SQLite و PostgreSQL و MySQL و MSSQL دون اتصال بقاعدة بيانات. يستخدم الاكتشاف التلقائي إشارات النحو الهيكلي ويظل محايداً للإدخال مختلط اللهجات حقاً؛ يمكن للمستدعين أيضاً توفير لهجة صريحة. تتبع الأمثلة أدناه نفس الترتيب القياسي: SQLite أولاً، تليها PostgreSQL، و MySQL، و MSSQL.

4.1. ميزات SQLite

SQL / مثال
-- SQLite uses type affinities: INTEGER, TEXT, REAL, NUMERIC, BLOB
CREATE TABLE users (
  id       INTEGER PRIMARY KEY,         -- implicit rowid alias
  email    TEXT UNIQUE NOT NULL,
  name     TEXT NOT NULL,
  balance  REAL DEFAULT 0.0,
  metadata BLOB,
  created  TEXT DEFAULT (datetime('now'))
);

-- AUTOINCREMENT prevents rowid reuse after DELETE
CREATE TABLE events (
  id   INTEGER PRIMARY KEY AUTOINCREMENT,
  name TEXT NOT NULL,
  ts   TEXT DEFAULT CURRENT_TIMESTAMP
);

-- WITHOUT ROWID — clustered on the declared PRIMARY KEY
CREATE TABLE kv_store (
  key   TEXT PRIMARY KEY,
  value TEXT
) WITHOUT ROWID;

-- STRICT mode — enforces declared column types
CREATE TABLE audit_log (
  id      INTEGER PRIMARY KEY,
  action  TEXT NOT NULL,
  payload TEXT
) STRICT;

-- STRICT + WITHOUT ROWID combined
CREATE TABLE config (
  key   TEXT PRIMARY KEY,
  value TEXT NOT NULL
) STRICT, WITHOUT ROWID;

-- Foreign keys with ON DELETE / ON UPDATE actions
CREATE TABLE orders (
  id          INTEGER PRIMARY KEY,
  customer_id INTEGER NOT NULL
    REFERENCES users(id) ON DELETE CASCADE ON UPDATE SET NULL,
  total       REAL DEFAULT 0 CHECK (total >= 0)
);

-- IF NOT EXISTS works as expected
CREATE TABLE IF NOT EXISTS sessions (
  token   TEXT PRIMARY KEY,
  user_id INTEGER REFERENCES users(id),
  expires TEXT
);
خاص بـ SQLite: INTEGER PRIMARY KEY (اسم مستعار لـ rowid)، AUTOINCREMENT, WITHOUT ROWID, STRICT الجداول، أعمدة بلا نوع وغير صارمة (typeless non-STRICT)، وتقارب الأنواع (INTEGER, TEXT, REAL, NUMERIC, BLOB), datetime('now') / CURRENT_TIMESTAMP القيم الافتراضية، و REFERENCES مع ON DELETE / ON UPDATE الإجراءات.
صحة النوع: تقبل جداول SQLite العادية أسماء أنواع معلنة تعسفية (مثل VARCHAR(255), BOOLEAN، أو TIMESTAMP) وقد يغفل تحديد النوع. تتبع جداول STRICT مجموعة SQLite المسموحة بدقة: INT, INTEGER, REAL, TEXT, BLOB، أو ANY; يجب أن يعلن كل عمود STRICT عن واحد.

مثال إعادة تشغيل ترحيل SQLite:

SQL / مثال
CREATE TABLE authors (
  id    INTEGER PRIMARY KEY,
  email TEXT NOT NULL UNIQUE
) STRICT;

CREATE TABLE posts (
  author_id INTEGER NOT NULL
    REFERENCES authors(id) ON DELETE CASCADE ON UPDATE RESTRICT,
  post_id   TEXT NOT NULL,
  body      TEXT,
  PRIMARY KEY (author_id, post_id)
) STRICT, WITHOUT ROWID;

ALTER TABLE posts ADD COLUMN summary TEXT;
ALTER TABLE posts RENAME COLUMN summary TO excerpt;
ALTER TABLE authors RENAME TO writers;

4.2. ميزات PostgreSQL

SQL / مثال
-- Composite type + ENUM + array column types
CREATE TYPE address AS (street TEXT, city VARCHAR(100), zip VARCHAR(20));
CREATE TYPE org_plan AS ENUM ('free','starter','pro','enterprise');

CREATE TABLE organizations (
  id            BIGSERIAL PRIMARY KEY,
  -- Or: id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY
  name          VARCHAR(255) NOT NULL,
  plan          org_plan NOT NULL DEFAULT 'free',

  -- PostgreSQL-specific types
  billing_addr  address,                          -- composite type
  data          JSONB DEFAULT '{}',               -- JSON binary
  tags          TEXT[],                           -- 1-D array
  matrix        INT[5],                           -- sized array
  uuid          UUID DEFAULT gen_random_uuid(),
  ip            INET,
  ts            TIMESTAMPTZ DEFAULT NOW(),

  -- Dollar-quoted defaults
  description   TEXT DEFAULT $$Hello World$$,

  -- Type casting in defaults
  seq_id        INTEGER DEFAULT nextval('org_seq'::regclass)
);

-- Schema-qualified table & type references both work
CREATE TABLE public.users (
  id INTEGER PRIMARY KEY,
  status public.org_plan          -- schema-qualified user-defined type
);

-- Empty body INHERITS (PG-only)
CREATE TABLE child () INHERITS (parent);
PostgreSQL: يدعم أنواع SERIAL، وأعمدة الهوية، و JSONB و BYTEA و INET، ومتغيرات الطابع الزمني، والمصفوفات، والأنواع المركبة و ENUM، UNIQUE NULLS NOT DISTINCT، والحفاظ على فهارس التعبير، والهوية الدقيقة الحساسة لحالة الشفرة في PostgreSQL للأسماء المقتبسة.

4.3. ميزات MySQL

SQL / مثال
-- Backtick-quoted identifiers + ENGINE / CHARSET / COLLATE
CREATE TABLE `users` (
  `id` BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
  `name` VARCHAR(100) NOT NULL,

  -- Inline ENUM and SET (auto-registered as named types)
  `status` ENUM('active', 'inactive', 'suspended') NOT NULL DEFAULT 'active',
  `flags`  SET('verified','staff','beta','muted'),

  -- UNSIGNED / SIGNED modifiers + TINYINT(1)
  `age`     TINYINT UNSIGNED,
  `is_pro`  TINYINT(1) UNSIGNED DEFAULT 0,

  -- COMMENT on columns
  `email` VARCHAR(255) COMMENT 'User email address',

  -- Timestamps with ON UPDATE CURRENT_TIMESTAMP
  `created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
  `updated_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,

  -- MySQL-specific types
  `bio`         MEDIUMTEXT,
  `avatar`      LONGBLOB,
  `birth_year` YEAR(4),
  `location`    POINT,

  -- Inline indexes become ERD badges when they map to columns
  INDEX idx_name (`name`),
  FULLTEXT KEY ft_bio (`bio`),
  UNIQUE INDEX ux_name (`name`),
  UNIQUE KEY uk_email (`email`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
خاص بـ MySQL: AUTO_INCREMENT, COMMENT، والمعدلات الموقعة، ومتغيرات الأعداد الصحيحة/النصوص/العنصر الثنائي/المكانية، والمضمنة ENUM و SET، والفهارس المضمنة، CHANGE COLUMN, MODIFY COLUMN, FIRST/AFTER الموضع الفيزيائي، ON UPDATE CURRENT_TIMESTAMP، وخيارات الجداول الشائعة.

4.4. ميزات MSSQL / SQL Server

SQL / مثال
-- Bracket-quoted identifiers + IDENTITY + computed columns
CREATE TABLE [dbo].[Users] (
  [UserID]      BIGINT IDENTITY(1,1) NOT NULL CONSTRAINT pk_users PRIMARY KEY CLUSTERED,
  [FirstName]   NVARCHAR(50) NOT NULL,
  [LastName]    NVARCHAR(50) NOT NULL,

  -- Computed column (parenthesized form)
  [FullName]    AS ([FirstName] + ' ' + [LastName]) PERSISTED,

  -- Computed column (bare AS form — also supported)
  [Initials]    AS LEFT([FirstName],1) + LEFT([LastName],1),

  -- MSSQL-specific types
  [IsActive]    BIT DEFAULT 1,
  [CreatedAt]   DATETIME2 DEFAULT GETDATE(),
  [UniqueToken] UNIQUEIDENTIFIER DEFAULT NEWID(),
  [SeqToken]    UNIQUEIDENTIFIER DEFAULT NEWSEQUENTIALID() ROWGUIDCOL,
  [Photo]       VARBINARY(MAX),
  [Notes]       NVARCHAR(MAX),
  [Config]      XML,
  [Location]    GEOGRAPHY,
  [TreePath]    HIERARCHYID
) ON [PRIMARY];
GO

-- ALTER TABLE with WITH CHECK and CONSTRAINT WITH (...)
ALTER TABLE [Users] WITH CHECK
  ADD CONSTRAINT [chk_active] CHECK ([IsActive] IN (0,1));
GO

-- Multi-statement batches separated by GO are honored
CREATE TABLE [dbo].[Orders] (
  [OrderID] INT IDENTITY NOT NULL PRIMARY KEY  -- bare IDENTITY → (1,1)
);
GO
خاص بـ MSSQL: IDENTITY(seed, increment), NVARCHAR(MAX)، والتاريخ/الوقت، والنوع الثنائي، و XML، وأنواع المعرفات والأنواع المكانية، ROWGUIDCOL، والفهارس المجمعة، GO دفعات، ALTER COLUMN، والأعمدة المحسوبة، والمسماة DEFAULT ... FOR column القيود والأعمدة الزمنية المولدة و PERIOD FOR SYSTEM_TIME.
الأعمدة المحسوبة بـ AS العارضة: col AS expression PERSISTED (بدون أقواس محيطة) مدعوم بالكامل، بما في ذلك استدعاءات الدوال (DATEADD, LEFT، ...)، مراجع الأعمدة المؤهلة للجدول (c.col)، و CASE التعبيرات.

4.5. أنماط اقتباس المعرفات

جميع اصطلاحات الاقتباس الثلاثة الرئيسية مدعومة:

SQL / مثال
-- PostgreSQL / Standard SQL: double quotes
CREATE TABLE "My Table" (
  "Column Name" INTEGER
);

-- MySQL: backtick quotes
CREATE TABLE `my_table` (
  `column_name` INT
);

-- MSSQL / SQL Server: square brackets
CREATE TABLE [my_table] (
  [column_name] INT
);

ملاحظات ونصائح

تفاصيل دعم بناء الجملة المهمة: ما الذي يساهم في بنية المخطط، وما هي أوامر DDL/DML التي يمكن إعادة تشغيلها مع صفوف العينة، وما يمكن لاستعلامات SELECT قراءته، وأين تقع الحدود.

✓ دعم بناء جملة المخطط / ERD

  • متعدد اللهجات: يمكن أن تشترك صيغ SQLite و PostgreSQL و MySQL و MSSQL في نص برمجي واحد؛ يظل الاكتشاف التلقائي محايداً عندما تكون الإشارات القوية مختلطة حقاً
  • كلمات مفتاحية غير حساسة لحالة الأحرف: يمكن كتابة CREATE و TABLE و ALTER وغيرها بأي حالة أحرف
  • المعرفات المحاطة بعلامات تنصيص: علامات الاقتباس المزدوجة ("name")، وعلامات الاقتباس المرتدة (`name`)، والأقواس ([name])
  • أسماء الأعمدة ذات الكلمات المحجوزة: عارٍ key, index, value, name, order، إلخ، يتم قبولها عندما تتبعها نوع بيانات
  • الأسماء المؤهلة بالمخطط: schema.table و schema.type (على سبيل المثال، public.users, dbo.Orders, app.status_enum) - يتم الاحتفاظ ببادئات المخطط في الأنواع المعرفة من قبل المستخدم للبحث الصارم وتُبسط للعرض فقط عندما تكون غير غامضة
  • التعليقات: سطر واحد (-- comment) وتعليقات الكتلة (/* comment */) يتم تخطيها تلقائياً
  • BOM & CRLF: يتم التعامل مع علامة ترتيب البايت UTF-8 ونهايات الأسطر في نظام ويندوز بسلاسة
  • الأنواع المخصصة: CREATE TYPE … AS ENUM و CREATE TYPE … AS (composite)، بما في ذلك الأسماء المؤهلة للمخطط
  • تعدادات ENUM و SET المدمجة (MySQL): ENUM('a','b') و SET('a','b','c') داخل أنواع الأعمدة - مسجلة تلقائيا كأنواع مسماة ومسماة بواسطة الجدول/العمود عندما تستخدم أسماء الأعمدة المكررة مجالات مختلفة
  • القيود: على مستوى العمود وعلى مستوى الجدول PRIMARY KEY, FOREIGN KEY, UNIQUE, CHECK (بما في ذلك الأنواع المركبة متعددة الأعمدة). يتم التحقق من أهداف المفاتيح الخارجية مقابل المفاتيح الأساسية، أو القيود الفريدة، أو الفهارس الفريدة الشاملة
  • الهوية / الترقيم التلقائي: SERIAL/BIGSERIAL (PG)، GENERATED ALWAYS/BY DEFAULT AS IDENTITY (PG)، AUTO_INCREMENT (MySQL)، IDENTITY(1,1) والمجردة IDENTITY (MSSQL) — كلها تتوحد في المخطط
  • الأعمدة المحسوبة: GENERATED ALWAYS AS (expr) STORED/VIRTUAL (PG/MySQL) و MSSQL col AS (expr) [PERSISTED] + مجرد col AS expr [PERSISTED]
  • مصفوفات PostgreSQL: type[]، ذات الحجم المحدد type[5]، المتداخلة type[][][]، ومصفوفات الأنواع المعرفة من قبل المستخدم (على سبيل المثال، webhook_event[])
  • القيم الافتراضية: القيم الحرفية، السلاسل المحاطة بعلامة دولار، استدعاءات الدوال (now(), CURRENT_TIMESTAMP, GETDATE(), NEWID(), NEWSEQUENTIALID(), gen_random_uuid(), nextval())، و ON UPDATE CURRENT_TIMESTAMP (MySQL)
  • إجراءات المفتاح الأجنبي (FK): ON DELETE / ON UPDATE مع CASCADE, RESTRICT, SET NULL, SET DEFAULT, NO ACTION، بالإضافة إلى MATCH, DEFERRABLE، و INITIALLY البيانات الوصفية. يتم الاحتفاظ بالإجراءات كبيانات وصفية للعلاقة.
  • إعادة تشغيل الترحيل: ALTER TABLE ADD COLUMN، وإضافة/حذف/إعادة تسمية المفاتيح والقيود، وإعادة تسمية الجدول/العمود/الفهرس، DROP COLUMN, ALTER COLUMN TYPE/SET DATA TYPE, SET/DROP DEFAULT, SET/DROP NOT NULL، و MSSQL sp_rename، و MySQL MODIFY/CHANGE COLUMN
  • الفهارس: المستوى الأعلى CREATE/DROP INDEX، و PostgreSQL ALTER INDEX … RENAME، وإضافة/حذف/إعادة تسمية في MySQL وإدراج KEY/INDEX/UNIQUE INDEX/FULLTEXT/SPATIAL التعريفات. يتم عرض الفهارس المدعومة بالأعمدة كـ IDX, UQ، أو PUQ شارات
  • IF NOT EXISTS وIF EXISTS: يتم التعامل معها بسلاسة على كلا CREATE و DROP
  • مغلفات المعاملات الخاصة بالمخطط فقط: BEGIN, COMMIT, SET search_path, USE [db] (MSSQL)، و SET FOREIGN_KEY_CHECKS (MySQL) يتم تخطيها بسلاسة
  • تم تخطيها بسلاسة: CREATE VIEW, CREATE MATERIALIZED VIEW, CREATE FUNCTION/TRIGGER/SCHEMA/SEQUENCE، الإجرائية EXEC تعليمات بخلاف sp_rename, DECLARE, PRINT, PARTITION BY, INHERITS (بما في ذلك الجسم الفارغ)، WITH OIDS, STORAGE PLAIN, EXCLUDE USING gist، وأجسام العبارات التي لا تؤثر على هيكل ERD

✓ بناء جملة معاينة DDL/DML

  • التنفيذ من الأعلى إلى الأسفل: يتم تشغيل البرنامج النصي بترتيب العبارات، لذا يجب أن تأتي بيانات النموذج بعد المخطط الذي تشير إليه
  • العبارات المدعومة: CREATE TYPE, CREATE TABLE, CREATE VIEW, CREATE INDEX, ALTER TABLE تغييرات العمود/القيود، DROP INDEX, TRUNCATE TABLE, INSERT, UPDATE, DELETE, DROP TABLE, DROP VIEW، و DROP TYPE
  • مرشحات WHERE: =, !=, <>, >, <, >=, <=, LIKE, IN, NOT IN, NOT LIKE, BETWEEN, NOT BETWEEN, IS NULL، و IS NOT NULL
  • تجسيد الصفوف: تعرض الجداول عداد الصفوف، وبيانات التعريف الهيكلية، وبيانات الصفوف الحالية بعد تنفيذ عبارات DML
  • الأنواع المسماة: أنواع ENUM والمركبة التي تم إنشاؤها باستخدام CREATE TYPE يتم إظهارها بشكل منفصل عن الجداول
  • سجل التنفيذ: يتم التقاط حالات النجاح والتحذير والخطأ للأعمدة غيرKnownة، والجداول المفقودة، والمفاتيح المكررة، وانتهاكات NULL، والتحديثات / الحذف الواسعة؛ يفشل ربط التغييرات غير الصالحة قبل تغير الصفوف
  • تقييم القيمة الافتراضية: القيم الافتراضية الحرفية بالإضافة إلى الدوال مثل now(), CURRENT_TIMESTAMP, CURRENT_DATE, GETDATE()، و NEWID()

✓ بناء جملة استعلام SELECT

  • قراءة فقط SELECT: SELECT يمكن للتعليمات قراءة جداول الذاكرة المؤقتة الناتجة من ملف SQL الرئيسي
  • بيانات التعريف للنتيجة: يتم الاحتفاظ بالأعمدة، وعدد الصفوف، والوقت المنقضي، وتنسيق NULL/منطقي/رقم، وأخطاء الاستعلام مع نتيجة SELECT
  • الاستعلامات العلائقية: عمليات الانضمام، وفلاتر WHERE، وGROUP BY، وHAVING، وORDER BY، وLIMIT/OFFSET، وTOP، وFETCH FIRST، والتعابير الجدولية المشتركة (CTEs)، والجداول المشتقة، والاستعلامات الفرعية، وعوامل المجموعات
  • مساعدات تحليلية: الدوال التجميعية، ودوال القيم القياسية الشائعة، ومساعدات JSON، ودوال التاريخ/النصوص، ودوال النافذة مثل ROW_NUMBER, RANK, NTILE, FIRST_VALUE, LAST_VALUE, LAG، و LEAD; تشمل الإطارات الافتراضية المرتبة مجموعة الأقران الحالية

✗ لا يزال غير مدعوم / تم تخطيه

  • ALTER TYPE: تعذر تعديل أنواع ENUM أو الأنواع المركبة الحالية
  • عبارة LIKE: CREATE TABLE foo (LIKE bar INCLUDING …) يتم تخطيها بلطف - لا يتم تحقيق الأعمدة المنسوخة
  • وراثة الأعمدة INHERITS: الـ INHERITS (parent) يتم تحليل العبارة نفسها دون أخطاء، ولكن لا يتم سحب الأعمدة الموروثة إلى الجدول الفرعي لأغراض ERD
  • تنفيذ الفهرس: يمكن لـ DDL الخاص بالفهرس إنشاء شارات للمخطط، لكن تنفيذ المعاينة لا يحاكي محركات التخزين، أو مُخططي الاستعلامات، أو أداء الفهرس
  • حدود SELECT: لا يدعم بناء جملة استعلام القراءة فقط تعبيرات CTE العودية، أو تنفيذ قاعدة البيانات الخارجية، أو الإجراءات المخزنة، أو عبارات التعديل
  • كائنات أخرى: المشغلات، والإجراءات المخزنة، والوظائف، والتسلسلات
  • التنفيذ الخارجي: معاينة DDL/DML لا تتصل بقاعدة بيانات حقيقية ولا تحفظ الصفوف خارج ملف SQL الحالي
سلوك النحو: لا تساهم DML في إنشاء مخطط قاعدة البيانات. يتم إعادة تشغيل بيانات الجدول، والنوع، ودورة حياة الفهارس المسماة بترتيب المصدر، بما في ذلك إعادة التسمية، والحذف، والإنشاء لاحقاً دون تسريب بيانات التعريف بين تجسيدات الكائنات. يتم تنفيذ عبارات DDL/DML المدعومة في الذاكرة من الأعلى إلى الأسفل، وتقرأ استعلامات SELECT للقراءة فقط من نتائج الذاكرة تلك دون تغييرها.
أفضل الممارسات:
  • أنهِ كل عبارة بفاصلة منقوطة (;)
  • تعريف CREATE TYPE قبل الجداول التي تشير إليها
  • تعريف CREATE TABLE قبل ذات الصلة INSERT, UPDATE، أو DELETE تعليمات
  • استخدم ALTER TABLE للمفاتيح الخارجية عندما تشير الجداول إلى بعضها البعض (التبعية الدائرية)
  • استخدم DDL للهيكل أولاً، ثم DML للتحقق من صفوف النموذج وسلوك القيود
  • احتفظ ببيانات العرض التجريبي في ملف SQL نفسه لأن صفوف المعاينة مشتقة من البرنامج النصي
استرداد الأخطاء: يتم تخطي العبارات غير المدعومة، وتظهر تحذيرات/أخطاء النحو مع سياق كافٍ لمواصلة تحسين نفس الملف بدلاً من البدء من الصفر.

من خلال اتباع أنماط بناء الجملة هذه، يمكن لـ Erd Go إنشاء مخطط ERD الخاص بك، ومعاينة البيانات في الذاكرة، وتشغيل استعلامات القراءة فقط من نفس ملف SQL.

ErdGo.com - تحويل SQL إلى مخططات ومعاينة البيانات بشكل أسرع