مصادر SQL صفحة تربط مشروعك بقواعد بيانات حية. بمجرد ربط مصدر، يستطيع المساعد فحص المخطط وكتابة SQL مقابل جداولك وعرض النتيجة داخل المحادثة (جدول أو مخطط). كل الوصول للقراءة فقط، لا يستطيع المساعد تعديل بياناتك.
بنية الصفحة
| ما تراه | المنطقة |
|---|---|
تحدّث مع مستنداتك / {المشروع} / مصادر SQL. | فتات الشريط العلوي |
| العنوان مع زر + اتصال جديد في الحافة النهائية. | ترويسة الصفحة |
| شبكة بطاقات المصادر. | جسم القائمة |
| بطاقة بحدود متقطّعة بزر اربط مصدر SQL عندما لا توجد. | الحالة الفارغة |
بطاقات مصادر SQL
كل بطاقة تلخّص قاعدة بيانات مرتبطة.| ما يعرضه | العنصر |
|---|---|
| اسم المصدر. | عنوان البطاقة |
| جدولاً مفحوصاً. | عدد الجداول |
| مصطلحاً في القاموس الدلالي. | عدد المصطلحات |
| طابع زمني نسبي مثل منذ ٣ ساعات آخر تحديث أو لم يُحدَّث. | آخر تحديث |
| حيّ بالأخضر، أو قديم بالكهرماني عندما لم يُحدَّث المخطط منذ فترة. | شارة الحالة |
| يفتح صفحة تفاصيل المصدر. | النقر |
الحالة الفارغة
| النص | العنصر |
|---|---|
| لا توجد مصادر SQL بعد. | العنوان |
| اربط قاعدة بيانات للقراءة فقط ليجيب وكيلك على الأسئلة من بيانات حية. | النص |
| اربط مصدر SQL. شارة بلون متدرّج. | الزر |
ربط مصدر جديد
حوار الاتصال الجديد فيه حقل اسم وقائمة منسدلة لللهجة وحقل سلسلة اتصال.| ملاحظات | الحقل |
|---|---|
| إدخال نص عادي. النص الإرشادي مثلاً hr_prod. يحظر الحوار الحفظ حتى يحتوي الحقل على حرف غير فراغ على الأقل. | الاسم مطلوب |
| قائمة منسدلة بـ PostgreSQL، MySQL، SQL Server، BigQuery، Snowflake. | اللهجة |
| إدخال بأسلوب كلمة المرور. النص الإرشادي postgresql://user:password@host:5432/dbname. | سلسلة الاتصال مطلوب |
| شرح صغير سطر واحد وصول للقراءة فقط. يفحص الوكيل كل استعلام قبل تشغيله. | ملاحظة الاتصال |
| إرسال بلون متدرّج. تتبدّل التسمية إلى جارٍ الاتصال… مع دائرة دوّارة أثناء الطلب. | زر اتصل |
| يغلق الحوار. | زر إلغاء |
صفحة تفاصيل مصدر SQL
صفحة التفاصيل لها أربعة تبويبات: المخطط، المصطلحات الدلالية، سجل الاستعلامات، والاتصال.تبويب المخطط
التبويب الافتراضي. يعرض ما يراه المساعد عند توليده SQL.| ملاحظات | العنصر |
|---|---|
| يصفّي قائمة الجداول بالاسم. | بحث تصفية الجداول |
| اسم الجدول، شارة PK للمفتاح الأساسي، شارة FK للمفاتيح الأجنبية، عدّاد صفاً و** عموداً**، وسهم توسيع صغير. | كل بطاقة جدول |
| قائمة بالأعمدة باسم العمود، النوع، وأي قيود. | الجدول الموسَّع |
| يعيد فحص قاعدة البيانات. يؤكّد إشعار تم تحديث المخطط. | زر تحديث المخطط |
تبويب المصطلحات الدلالية
يعلّم المساعد مفردات عربية ↔ إنجليزية لمخططك.| ما يعرضه | العنصر |
|---|---|
| علّم الوكيل مفردات عربية ↔ إنجليزية لمخططك. | العنوان الفرعي |
| يفتح محرر المصطلح. | زر أضف مصطلحاً |
| المصطلح العربي، المصطلح الإنجليزي، تعبير SQL، شارة النوع. | كل بطاقة مصطلح |
| لا توجد مصطلحات بعد. أضف أول مصطلح ليطابق الوكيل الأسئلة الطبيعية بـ SQL. | الحالة الفارغة |
| ملاحظات | الحقل |
|---|---|
| واحد على الأقل من العربي أو الإنجليزي مطلوب. | المصطلح العربي |
| واحد على الأقل من العربي أو الإنجليزي مطلوب. | المصطلح الإنجليزي |
التعبير الذي يحقنه المساعد عند رصده هذا المصطلح، مثلاً COUNT(*) أو employees.department_id. | تعبير SQL مطلوب |
| قائمة منسدلة: مؤشّر، بُعد، فلتر، اسم بديل لجدول. | النوع |
تبويب سجل الاستعلامات
يقول سجل الاستعلامات قريباً. كل SQL يشغّله الوكيل مقابل هذا المصدر سيُسجَّل هنا.التبويب فارغ عمداً اليوم، يأتي مسار التدقيق في تحديث لاحق.تبويب الاتصال
| ملاحظات | الحقل |
|---|---|
| للقراءة فقط. اللهجة المختارة عند إنشاء المصدر. | اللهجة |
| للقراءة فقط ومحجوبة. لا يستطيع سوى مسؤول تدويرها (الحذف وإعادة الاتصال). | سلسلة الاتصال |
| تاريخ الإنشاء. | مرتبط في |
| طابع آخر تحديث الزمني. | آخر تحديث للمخطط |
| يفتح تأكيداً مدمّراً. | زر حذف هذا المصدر |
حذف هذا المصدر
| النص | العنصر |
|---|---|
| حذف مصدر SQL هذا؟ | العنوان |
| سيُزيل هذا الاتصال وكل مصطلح دلاليّ. ستُسقطه جلسات الدردشة التي تشير إلى هذا المصدر بصمت في الدور التالي. لا يمكن التراجع. | النص |
| يغلق الحوار. | زر إلغاء |
| بخلفية اللون المدمّر (الأحمر) ونص أبيض. | زر حذف |
كيف يستخدم دور دردشة مصدر SQL
عندما تطرح على المساعد سؤالاً يخصّ بيانات مرتبطة بـ SQL، تحمل الإجابة شارة SQL ·{اسم المصدر} وتعرض كلاً من SQL المولَّد (كتلة قابلة للطي) والنتيجة (جدول أو مخطط). يُفحص كل SQL في الخادم قبل التشغيل، مع رفض العمليات المدمّرة.أسئلة شائعة
فشل فحص سلسلة اتصالي.
فشل فحص سلسلة اتصالي.
الأسباب الأكثر شيوعاً: عناوين IP خاصة (١٠.x، ١٧٢.١٦-٣١.x، ١٩٢.١٦٨.x)، localhost (١٢٧.٠.٠.١ أو
localhost)، أو نقاط نهاية البيانات الوصفية السحابية (١٦٩.٢٥٤.١٦٩.٢٥٤). هذه محظورة للحماية من تزوير الطلبات في الخادم. استخدم اسم مستضيف عام أو بوابة VPN يستطيع حسابك الوصول إليها.تبويب المخطط فارغ بعد ربطي.
تبويب المخطط فارغ بعد ربطي.
انقر تحديث المخطط في أعلى التبويب. أول فحص قد يستغرق لحظة لقواعد البيانات الكبيرة. بعد هبوطه، يظهر كل جدول كبطاقة.
أعاد المساعد اسم عمود خاطئاً.
أعاد المساعد اسم عمود خاطئاً.
أضف مصطلحاً دلالياً يطابق العبارة الطبيعية بالعمود الصحيح. مثلاً مصطلح عربي العمر مع تعبير SQL
employees.age ونوع بُعد يمنع المساعد من اختراع عمود.تغيّرت قاعدة بياناتي (عمود مضاف أو مُعاد تسميته).
تغيّرت قاعدة بياناتي (عمود مضاف أو مُعاد تسميته).
انقر تحديث المخطط في تبويب المخطط. يلتقط المساعد الشكل الجديد في الدور التالي. SQL القديم الذي خزّنه المساعد يُعاد بناؤه من المخطط الطازج.
هل يستطيع المساعد تعديل بياناتي؟
هل يستطيع المساعد تعديل بياناتي؟
لا. كل استعلام للقراءة فقط. يرفض الفحص في الخادم
INSERT، UPDATE، DELETE، DROP، CREATE، وأي عملية مدمّرة أخرى. يمكن أيضاً حظر الأعمدة الحسّاسة.تبويب سجل الاستعلامات فارغ.
تبويب سجل الاستعلامات فارغ.
يأتي مسار التدقيق في تحديث لاحق. اليوم، يحمل التبويب رسالة قريباً. لا يوجد بديل مؤقت لتنزيل السجل.
هل يمكنني ربط نفس قاعدة البيانات بصلاحيات مختلفة لكل مشروع؟
هل يمكنني ربط نفس قاعدة البيانات بصلاحيات مختلفة لكل مشروع؟
نعم. كل مشروع يملك مصادر SQL الخاصة به. اربط قاعدة البيانات في كل مشروع بالصلاحيات التي يجب أن يستخدمها ذلك المشروع، فالصلاحيات مشفّرة بشكل مستقل لكل مصدر.
اتصالي أصبح قديماً.
اتصالي أصبح قديماً.
تنقلب شارة الحالة إلى قديم عندما لا يُحدَّث المخطط لفترة طويلة. انقر إلى المصدر، ثم تحديث المخطط لإعادتها إلى حيّ.
إلى أين بعد ذلك
قواعد المعرفة
اقرن SQL باسترجاع المستندات.
المحادثات
ابدأ محادثة تستخدم هذا المصدر.
لوحة الدردشة
أجبر الأداة إلى SQL فقط، أو اختر تلقائي لكل دور.
إعدادات المشروع
ميزات الاسترجاع ومنطقة الخطر.

