مستكشف الكائنات

يوفر مستكشف الكائنات في امتداد PostgreSQL ل تعليمة Visual Studio برمجية عرضا شجريا لخوادم PostgreSQL الخاصة بك، وقواعد البيانات، والمخططات، وكائنات قواعد البيانات الفردية. يمكنك تصفح الجداول، والعروض، والوظائف، وكائنات أخرى، والبحث عبر المخططات، وتوليد سكريبتات SQL، وكل ذلك دون مغادرة المحرر.

نصيحة

استخدم مستكشف الكائنات للتنقل بين الكائنات، والبحث، وتوليد السكريبت. إذا كنت تريد مخططا بصريا لعلاقات الجداول، افتح برنامج Schema visualizer.

مستكشف الكائنات المفتوحة

اختر أيقونة PostgreSQL في شريط النشاط لفتح عرض PostgreSQL . يمكنك أيضا الضغط على Ctrl+Alt+D (Windows/Linux) أو Cmd+Alt+D (macOS).

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

لقطة شاشة لعرض postgreSQL مع خادم متصل موسع في شجرة الاتصالات.

تسلسل الأشجار

ينظم مستكشف الكائنات كائنات قاعدة البيانات في تسلسل هرمي متسق:

قواعد البيانات → الخادم → المخطط → مجموعات الكائنات

افتراضيا، يتم تجميع الكائنات حسب المخطط. تحت كل مخطط تجد مجلدات مجموعات مثل:

  • الجداول: توسيع الجدول لرؤية أعمدته، مفاتيحه، الفهارس، القيود، والمحفزات
  • طرق العرض
  • الإجراءات المخزنة
  • الدوال: تشمل الدوال ذات القيمة القياسية، والقيمة الجدولية، والوظائف المجمعة في مجلدات منفصلة
  • التسلسلات
  • الأنواع: أنواع معرف من قبل المستخدم وأنواع الجداول المعرفة من قبل المستخدم

تعتمد مجموعة مجلدات المجموعات الدقيقة على الكائنات الموجودة في قاعدة البيانات ويتم ملؤها بواسطة خدمة أدوات الواجهة الخلفية.

قم بتوسيع أي مجلد مجموعة لرؤية الكائنات الفردية. بالنسبة للجداول، يمكنك التعمق أكثر في الأعمدة، المفاتيح (الأساسية، الأجنبية، الفريدة)، الفهارس، القيود، والمحفزات.

ملحوظة

الإعداد pgsql.objectExplorer.expandTimeout يتحكم في مدة انتظار الامتداد عند توسيع عقدة. الإعداد الافتراضي هو 45 ثانية. زد هذه القيمة إذا كنت تعمل مع مخططات كبيرة تستغرق وقتا أطول للتحميل.

المجموعة حسب المخطط

عند تفعيل الإعداد pgsql.objectExplorer.groupBySchema (الافتراضي)، تظهر كائنات قاعدة البيانات تحت عقدة المخطط الخاصة بها. لتفعيل هذا السلوك:

  1. افتح لوحة الأوامر (Ctrl+Shift+P / cmd+Shift+P).
  2. شغل تمكين المجموعة حسب المخطط أو تعطيل المجموعة حسب المخطط.

عند تعطيل المجموعات بمخطط، تظهر مجلدات جمع الكائنات مباشرة تحت عقدة قاعدة البيانات بدلا من تحت المخططات الفردية.

الاتصال وإدارة الخوادم

تدير اتصالات الخوادم مباشرة من شجرة الاتصالات . توفر شريط الأدوات في أعلى قسم الاتصالات وقوائم السياق بالنقر بزر الفأرة الأيمن الإجراءات التالية.

إجراءات شريط الأدوات

الزر الأمر الوصف
+ إضافة اتصال جديد يفتح مربع الاتصال لإضافة خادم PostgreSQL موجود.
أيقونة الخادم إنشاء خادم جديد يفتح مركز إنشاء حيث يمكنك نشر خادم مرن جديد لقاعدة بيانات قاعدة بيانات Azure لـ PostgreSQL أو إنشاء خادم قائم على Docker.
أيقونة المجلد إنشاء مجموعة الخوادم ينشئ مجموعة خوادم جديدة لتنظيم اتصالاتك.
أيقونة المرشح فقط عرض الخوادم / المتصلةعرض الخوادم المتصلة وغير المتصلة يقوم بتفعيل رؤية الخوادم غير المتصلة في الشجرة.
أيقونة البحث البحث عن الكائنات يفتح لوحة البحث.

قائمة سياق الخادم

انقر بزر الفأرة الأيمن على عقدة خادم للوصول إلى هذه الأوامر:

  • البحث عن الكائنات: يفتح لوحة البحث المخصصة لهذا الخادم.
  • تعديل الاتصال: يعيد فتح مربع الاتصال باستخدام الإعدادات المحفوظة لهذا الخادم.
  • انقطاع: يغلق الاتصال النشط. يبقى الخادم في الشجرة مع أيقونة حمراء حتى تتمكن من إعادة الاتصال لاحقا.
  • الإزالة: تحذف إدخال الخادم من شجرة الاتصالات بالكامل.
  • التحديث: يعيد تحميل العقد الفرعية للخادم. استخدم هذا بعد تغييرات المخطط التي تجريها خارج VS Code.

ملحوظة

يظهر الانقطاع فقط على الخوادم المتصلة. يتوفر ميزة الإزالة على الخوادم المتصلة وغير المتصلة.

قائمة سياق قاعدة البيانات

انقر بزر الفأرة الأيمن على عقدة قاعدة البيانات للوصول:

  • استعلام جديد: يفتح محرر استعلامات متصل بالفعل بهذه قاعدة البيانات.
  • الاتصال ب PSQL: يفتح جلسة طرفية متكاملة متصلة بهذه قاعدة البيانات باستخدام psql. راجع استخدام psql في الطرفية لمزيد من التفاصيل.
  • Visualize Schema: يفتح أداة Schema visualizer لهذه قاعدة البيانات.
  • البحث عن الكائنات: يفتح لوحة البحث المخصصة لهذه قاعدة البيانات.

انقر بزر الفأرة الأيمن على عقدة المخطط للوصول إلى Visualize Schema (المرتبط بهذا المخطط) والبحث عن الكائنات.

مجموعات الخوادم

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

  1. اختر أيقونة المجلد (إنشاء مجموعة الخوادم) في شريط أدوات الاتصالات ، أو افتح لوحة الأوامر وشغل PGSQL: إنشاء مجموعة الخوادم.
  2. أدخل الاسم، ووصفا اختياريا، ولونا للمجموعة.
  3. حدد موافق.

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

انقر بزر الفأرة الأيمن على مجموعة خوادم لإضافة الاتصالات مباشرة إلى تلك المجموعة باستخدام إضافة اتصال جديد أو إنشاء خادم جديد.

البحث عن الكائنات

عندما تحتاج إلى تحديد موقع كائن معين في قاعدة بيانات كبيرة، استخدم البحث المدمج بدلا من توسيع عقد الشجرة يدويا.

افتح لوحة البحث باختيار أيقونة البحث في شريط أدوات الاتصالات . يمكنك أيضا النقر بزر الفأرة الأيمن على خادم أو قاعدة بيانات أو عقدة مخطط واختيار Search Objects لتعبئة النطاق مسبقا.

توفر لوحة البحث عناصر التحكم التالية:

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

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

لقطة شاشة للوحة البحث في الكائنات مع نتائج البحث.

كائنات قاعدة بيانات السكريبت

يمكنك توليد سكريبتات SQL لكائنات قاعدة البيانات مباشرة من شجرة الاتصالات . انقر بزر الفأرة الأيمن على كائن قابل للبرمجة للوصول إلى أوامر السكريبت.

الأمر متوفر في SQL المولد
اختر أفضل 1000 الطاولة، العرض SELECT استعلام يعيد أول 1000 صف.
النص كإنشاء الجدول، العرض، المخطط، الإجراء المخزن، الدوال، المحفزات، الفهارس، المفاتيح، الأدوار، الأنواع بيان DDL الكامل CREATE .
النص ك Drop نفس البرمجة مثل Create DROP البيان للموضوع.
النص ك Alter العرض، الدوال، الإجراء المخزن ALTER البيان للموضوع.
النص كتنفيذ الإجراء المخزَّن CALL أو SELECT بيان لتنفيذ الروتين.

يفتح كل سكريبت تم إنشاؤه في تبويب محرر استعلامات جديد متصل بنفس قاعدة البيانات التي يربط بها الكائن المصدر. يمكنك مراجعة وتحرير وتشغيل النص فورا.

نصيحة

اختيار أفضل 1000 هو أسرع طريقة لمعاينة بيانات الجدول. انقر بزر الفأرة الأيمن على الجدول واختر اختر أفضل 1000 لفتح وتشغيل الاستعلام في خطوة واحدة.

اسم النسخة

انقر بزر الفأرة الأيمن على أي كائن غير مجلد في شجرة الاتصالات واختر اسم النسخ لنسخ اسمه المؤهل إلى الحافظة. يمكنك أيضا اختيار العقدة والضغط على Ctrl+C (Windows/Linux) أو Cmd+C (macOS).

الاسم المنسوخ يستخدم تنسيق [database].schema.[object] تدوين الأقواس (bracket notation)، جاهز لللصق في استفسارات SQL الخاصة بك.

استعلام جديد من مستكشف الكائنات

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

عقد شجرة الترشيح

بعض مجلدات المجموعات تدعم التصفية لتضييق الكائنات التي تعرضها. عندما تكون العقدة قابلة للتصفية، انقر عليها بزر الفأرة الأيمن واختر التصفية لفتح لوحة التصفية. يمكنك تعيين شروط مثل Contains، Starts With، أو Equals على خصائص الكائنات، ثم اختيار OK لتطبيقها.

العقد المصفاة تظهر (filtered) بعد التصنيف. لإزالة الفلتر، انقر بزر الفأرة الأيمن على العقدة واختر المسح في لوحة الفلتر.

السحب والإفلات

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