إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
إضافة PostgreSQL ل تعليمة Visual Studio برمجية (ms-ossdata.vscode-pgsql) تجلب أدوات تطوير قواعد البيانات مباشرة إلى محررك. يمكنك الاتصال بخوادم PostgreSQL المحلية أو المحلية أو السحابية، وكتابة استعلامات باستخدام IntelliSense، واستكشاف كائنات قاعدة البيانات، وتصور خطط الاستعلامات والمخططات، وإدارة موارد خوادم قاعدة بيانات Azure لـ PostgreSQL المرنة، وكل ذلك دون مغادرة VS Code. كما يتكامل الامتداد مع مساعدي الذكاء الاصطناعي لتأليف الاستعلامات بمساعدة الذكاء الاصطناعي وتحليلها وسير العمل المدفوع بالوكلاء.
ملحوظة
كما يعمل الامتداد في كورسور. تدعم ميزات PostgreSQL AI في كلا المحررين وتتبع تجربة الذكاء الاصطناعي الأصلي لكل محرر: تعليمة Visual Studio برمجية يتضمن المشارك في الدردشة @pgsql إلى جانب وضع الوكيل وتسجيل خادم MCP، بينما يستخدم Cursor Connect AI (وضع الوكيل) أو تسجيل خادم MCP.
بدء الاستخدام
إذا كنت جديدا على التوسعة، ابدأ بأحد هذه الأدلة:
| Goal | دليل |
|---|---|
| قم بتشغيل أول استفسار لك | البدء السريع: الاتصال واستعلام PostgreSQL |
| ابحث عن المقالة المناسبة لمهمتك | سير العمل الشائع |
| تكوين ملفات تعريف الهوية أو TLS أو الملفات المحفوظة | الروابط والهوية |
ثبتالملحق
- فتح تعليمة Visual Studio برمجية.
- افتح عرض الإضافات (
Ctrl+Shift+X، أوCmd+Shift+Xعلى macOS). - ابحث عن postgresql.
- اختر PostgreSQL من Microsoft ثم اختر التثبيت.
نصيحة
بعد التثبيت، تظهر أيقونة PostgreSQL في شريط النشاط. اختر ذلك لفتح عرض PostgreSQL، حيث تدير الاتصالات وتستكشف كائنات قاعدة البيانات.
الميزات الأساسية
تلخص الأقسام التالية كل منطقة رئيسية في المعالم الرئيسية. اختر الرابط في نهاية كل قسم للمقال الكامل.
حوار الاتصال
يربطك حوار الاتصال بخوادم PostgreSQL المحلية والمحلية والمحلية والسحابية، مع دعم مصادقة مدمج ل Microsoft Entra ID و AWS IAM (RDS/Aurora). أدخل معلمات الاتصال بشكل فردي، أو الصق سلسلة سلسلة الاتصال، أو تصفح اشتراكات Azure الخاصة بك لاكتشاف خوادم قاعدة بيانات Azure لـ PostgreSQL المرنة وعناقيد Azure HorizonDB (Preview).
- ثلاثة أوضاع إدخال: معلمات للقيم الفردية مثل المضيف، المنفذ، قاعدة البيانات، واسم المستخدم؛ Connection String لسلسلة سلسلة الاتصال كاملة؛ أو Browse Azure للتنقل بين أصول Azure واختيار مورد بنقطة نهاية PostgreSQL.
- الاتصالات المحفوظة والحديثة: تظهر الملفات الشخصية المحفوظة في قائمة الاتصالات لإعادة الاستخدام السريع؛ الاتصالات المستخدمة حديثا متاحة دائما.
- مجموعات الخوادم: نظم الاتصالات في مجموعات مسماة مع ترميز لوني لتحديد الاتصالات بسرعة في شجرة الاتصالات .
للتفاصيل، راجع خيارات الاتصالات والهويةوالاتصال المتقدم.
مستكشف الكائنات
يوفر مستكشف الكائنات عرضا شجريا قابلا للتنقل لخوادم PostgreSQL المتصلة لديك. قم بتوسيع الخوادم وقواعد البيانات والمخططات لفحص الجداول، والعرض، والوظائف، والتسلسلات، والأنواع، والامتدادات، والأدوار، ومساحات الجداول، ومحفزات الأحداث.
- البحث: ابحث عن الكائنات بالاسم عبر جميع أنواع الكائنات المدعومة باستخدام البحث المدمج.
-
البرمجة النصية: انقر بزر الفأرة الأيمن على أي كائن لتوليد
SELECT،CREATE،ALTER،DROPأوEXECUTEسكريبتات تفتح في محرر الاستعلام. - تحديث عميق: تحديث أي عقدة لتحديث جميع الفروع الموسعة بشكل متكرر، مع عكس تغييرات المخطط دون الانفصال.
للتفاصيل، راجع مستكشف الكائنات.
محرر الاستعلام وIntelliSense
يوفر محرر الاستعلامات سطح تحرير غني ل PostgreSQL SQL. يقدم IntelliSense إكمالات واعية للسياق لأسماء الجداول، وأسماء الأعمدة، والوظائف، والمخططات، والكلمات المفتاحية، وجمل الانضمام.
- تشغيل الاستعلاموتشغيل البيان الحالي: شغل محتوى المحرر بالكامل أو فقط العبارة على المؤشر.
-
مقتطفات الكود: أدرج أنماط SQL الشائعة مثل
CREATE TABLE،INSERT، وSELECT. - سجل الاستعلام: الوصول إلى الاستعلامات التي تم تشغيلها سابقا من لوحة الأوامر لإعادة تشغيلها أو تعديلها.
لمزيد من التفاصيل، راجع محرر الاستعلامات وIntelliSense.
نتائج الاستعلام
تظهر النتائج في لوحة نتائج الاستعلام PostgreSQL أسفل المحرر. تدعم شبكة النتائج الفرز والتصفية وتغيير حجم الأعمدة.
- التصدير: حفظ النتائج إلى CSV أو JSON أو Excel.
- تصور المخططات: تصور النتائج كخطوط أو خطوط أو شريط أو فطير أو مخططات مبعثرة.
- عرض الرسم البياني: نتائج استعلام الرسوم البيانية في Apache AGE تنتقل تلقائيا إلى عرض عقدة وحافة.
- تبويب الرسائل: راجع عدد الصفوف، أوقات التنفيذ، ورسائل الخادم.
لمزيد من التفاصيل، راجع محرر الاستعلامات وIntelliSense.
Query plan visualizer
يعرض EXPLAIN برنامج مخطط الاستعلام المخرجات بعدة صيغ تفاعلية حتى تتمكن من تحديد عنق الزجاجة في الأداء.
- أربع مشاهد: عرض الشجرة، عرض الثلج، عرض الجدول، وعرض المصدر.
- المقاييس: فحص تقديرات التكلفة، وعدد الصفوف الفعلي، ووقت التنفيذ، واستخدام المخزن المؤقت لكل عقدة.
- استيراد الخطط: تصور ملفات الخطط المحفوظة أو محتوى المحرر بدون اتصال مباشر بقاعدة البيانات.
- تحليل Copilot: اختر تحليل باستخدام Copilot (أو تحليل الذكاء الاصطناعي في Cursor) لشرح الخطة من إنتاج الذكاء الاصطناعي.
للتفاصيل، راجع أداة عرض خطة الاستعلام.
مصور المخطط
يقوم مصور المخطط بإنشاء مخطط تفاعلي بين الكيانات والعلاقات. تظهر الجداول كعقد قابلة للسحب مع أعمدة مدرجة بداخلها، وتظهر علاقات المفاتيح الأجنبية كحواف متصلة.
- المخططات الملونة: يحصل كل مخطط على لون مميز للتعرف السريع.
- تبديل الأسطورة: عرض أو إخفاء أسطورة المخطط لتعظيم مساحة المخططات.
للمزيد من التفاصيل، راجع Schema visualizer.
لوحة تحكم الخادم
تظهر لوحة تحكم الخادم خصائص الاتصال، وإصدار الخادم، وحالة SSL لأي خادم متصل. بالنسبة لخوادم قاعدة بيانات Azure لـ PostgreSQL المرنة، يعرض أيضا مقاييس Azure Monitor. تبويبات التحقيق تتيح لك التعمق في مناطق محددة من نشاط الخادم.
- نظرة عامة: مراقبة وحدة المعالجة المركزية، الذاكرة، التخزين، الاتصالات، IOPS، ومقاييس أخرى مجمعة حسب الفئة.
- الاستعلامات: عرض أعلى عبارات SQL المرتبة حسب وقت التنفيذ، عدد المكالمات، أو مقاييس أخرى، مع التعمق في تفاصيل الاستعلام الفردية.
- الانتظار: تحليل أحداث الانتظار باستخدام جدول تصنيف وجدول الوقت الإضافي.
- الجلسات: افحص الجلسات النشطة، وحظر الأشجار، وقفل النشاط.
- إجراءات شريط الأدوات: الاتصال، الانفصال، فتح محرر استعلامات جديد، تشغيل مصور المخطط، فتح دردشة ذكاء اصطناعي، أو بدء إجراءات إدارة Azure من شريط أدوات لوحة الأدوات.
للتفاصيل، راجع لوحة تحكم الخادم.
إدارة خادم Azure
إدارة موارد الخوادم المرنة في قاعدة بيانات Azure لـ PostgreSQL دون ترك VS Code.
- التشغيل، الإيقاف وإعادة التشغيل: التحكم في دورة حياة الخادم من شجرة الاتصالات أو لوحة التحكم.
- قواعد جدار الحماية: عرض وتحديث قواعد الوصول إلى الشبكة.
- المعلمات: تصفح وتعديل المعلمات.
- استنساخ الخادم: تكرار تكوين خادم موجود.
للتفاصيل، انظر Azure server management.
إنشاء الخادم
توفير خوادم PostgreSQL الجديدة مباشرة من VS Code.
- Docker: إنشاء خادم PostgreSQL محلي في حاوية Docker للتطوير والاختبار.
- خادم قاعدة بيانات Azure لـ PostgreSQL مرن: تصفح إعداد موجه يضبط المنطقة، ومستوى الحوسبة، والتخزين، والمصادقة.
- Azure HorizonDB (معاينة): يوفر عنقود PostgreSQL أصلي للسحابة وقابل للتوسع عالي مع vCores قابلة للتكوين وقدرات ذكاء اصطناعي اختيارية.
للتفاصيل، راجع إنشاء خادم PostgreSQL.
تكامل مساعد الطيار
يتكامل الامتداد مع مساعدي الذكاء الاصطناعي عبر الدردشة، وإجراءات المحرر، وسير عمل الأدوات متعددة الخطوات.
- @pgsql مشارك في الدردشة: اطرح أسئلة بلغة طبيعية عن قواعد بياناتك، أنشئ استعلامات، أو احصل على المساعدة في مفاهيم PostgreSQL في لوحة GitHub Copilot Chat. تعليمة Visual Studio برمجية فقط. لمزيد من التفاصيل، راجع @pgsql المشارك في الدردشة.
- إجراءات المحرر: انقر بزر الفأرة الأيمن على SQL في المحرر لشرح استعلام، أو إعادة كتابته للتحسين، أو تحليل خطة تنفيذه من القائمة الفرعية لإجراءات الاستعلام بالذكاء الاصطناعي . متوفر بكل من تعليمة Visual Studio برمجية وCursor.
- وضع الوكيل: يستدعي وكيل الذكاء الاصطناعي أدوات PostgreSQL مباشرة، حيث يجمع بين التفكير العقلاني وعمليات قاعدة البيانات الحية. متوفر بكل من تعليمة Visual Studio برمجية وCursor. للمزيد من التفاصيل، راجع وضع الوكيل.
للحصول على نظرة عامة على جميع قدرات الذكاء الاصطناعي، راجع تكامل Copilot.
خادم MCP
يقوم الامتداد بتسجيل خادم بروتوكول السياق النموذجي (MCP) الذي يعرض أدوات PostgreSQL، بما في ذلك إدارة الاتصالات، واستكشاف المخطط، وتنفيذ الاستعلامات، وتصور خطط الاستعلام، للمضيفين المدعومين بالذكاء الاصطناعي. يمكن لأدوات الذكاء الاصطناعي الخارجية التفاعل مع اتصالات PostgreSQL الخاصة بك بشكل برمجي من خلال هذا التسجيل.
للمزيد من التفاصيل، راجع خادم MCP.
استخدم psql في المحطة
افتح جلسة طرفية psql متصلة بأي قاعدة بيانات في شجرة الاتصالات ، أو مرر .sql الملفات مباشرة psql من قائمة سياق المحرر. هذا يمنحك وصولا كاملا إلى الميزات الأصلية psql مثل \ أوامر الميتا، COPYوالبرمجة التفاعلية.
للمزيد من التفاصيل، انظر استخدام psql في الطرفية.
ترحيل Oracle إلى PostgreSQL
يساعدك سير العمل الترحيلي المدعوم بالذكاء الاصطناعي في تحويل مخططات وكائنات قاعدة بيانات أوراكل إلى SQL متوافق مع PostgreSQL.
- الترحيل الموجه: الاتصال بمصدر أوراكل، اختيار الكائنات للترحيل، ومراجعة الناتج المحول.
- التحويل بمساعدة الذكاء الاصطناعي: يترجم نموذج Microsoft Foundry صياغة الجملة، وأنواع البيانات، والشيفرة الإجرائية الخاصة ب Oracle إلى مكافئات PostgreSQL.
للتفاصيل، راجع ترحيل Oracle إلى PostgreSQL.
أنظمة التشغيل المدعومة
| نظام التشغيل | Architecture | Notes |
|---|---|---|
| Windows | x64، Arm64 | Arm64 يتطلب Windows 11. |
| ماك أو إس | x64، Arm64 | - |
| ينكس | x64، Arm64 | يتطلب glibc 2.35 أو أكثر. |
التعليقات والدعم
للإبلاغ عن خطأ أو طلب ميزة، قم بتقديم مشكلة في مستودع GitHub الخاص ب vscode-pgsql.