البدء السريع: اتصل واستعلام قاعدة بيانات باستخدام إضافة PostgreSQL لكود فيجوال ستوديو

ملحق PostgreSQL ل Visual Studio Code هو أداة قوية مصممة لتبسيط تطوير وإدارة قواعد بيانات PostgreSQL. يرشدك هذا الدليل خلال الاتصال بقاعدة بيانات PostgreSQL وتنفيذ الاستعلامات داخل بيئة Visual Studio Code.

المتطلبات الأساسية

قبل البدء، تحقق من أن لديك الأدوات والموارد المناسبة التي تم تنزيلها وتثبيتها.

تساعدك هذه الأدوات والموارد على المتابعة مع هذه المقالة و تحقيق أقصى استفادة من تكامل GitHub Copilot لملحق PostgreSQL في Visual Studio Code.

• Visual Studio Code مثبت على جهازك.
• قاعدة بيانات PostgreSQL مثبتة محليا أو مستضافة في السحابة.
• تم تثبيت ملحق PostgreSQL في Visual Studio Code.
• ملحق GitHub Copilot
• تم تثبيت ملحق GitHub Copilot Chat .
• حساب Azure للاتصال بقواعد البيانات المستضافة على السحابة (اختياري).

تثبيت ملحق PostgreSQL

لتثبيت ملحق PostgreSQL:

1. افتح كود Visual Studio واذهب إلى عرض Extensions باختيار أيقونة Extensions في شريط النشاط أو باستخدام أمر View: Extensions .
2. ابحث عن PostgreSQL في سوق الإضافات.
3. حدد ملحق PostgreSQL الذي تم تأليفه بواسطة Microsoft وحدد تثبيت.

عند تثبيت التوسعة، تظهر صفحة PostgreSQL، الممثلة بأيقونة، في شريط Visual Studio Code الجانبي.

إضافة اتصال إلى PostgreSQL

سواء كانت مستضافة محليا أو على خادم بعيد، يعد الاتصال بقاعدة بيانات PostgreSQL خطوة أساسية في إدارة بياناتك والتفاعل معها. تتضمن هذه العملية توفير تفاصيل الاتصال الضرورية، مثل عنوان الخادم والمنفذ وبيانات اعتماد المصادقة، لإنشاء ارتباط آمن بين تطبيق العميل وقاعدة البيانات. باستخدام ملحق PostgreSQL ل Visual Studio Code، يمكنك الاتصال بقاعدة البيانات بسلاسة واستخدام أدوات قوية للاستعلام عن بياناتك وإدارتها واستكشافها بكفاءة.

1. حدد أيقونة على الشريط الجانبي لفتح صفحة ملحق PostgreSQL.

2. حدد الزر إضافة اتصال .

3. أدخل تفاصيل الاتصال يدويا أو استخدم تنسيق سلسلة الاتصال:

     psql -h <server>.postgres.database.azure.com -p 5432 -U
   

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

المصادقة

يدعم الملحق طريقتين للمصادقة:

• اسم المستخدم/كلمة المرور: أدخل بيانات اعتماد قاعدة البيانات الخاصة بك مباشرة في حقول الاتصال.
• مصادقة معرف Microsoft Entra: أضف حساب معرف Microsoft Entra لقواعد البيانات المستضافة على Azure.

اختبار الاتصال وحفظه

1. اختر اختبار الاتصال للتحقق من تفاصيل الاتصال.
2. عند الاختبار الناجح، يعرض مربع الاختبار علامة اختيار.
3. حدد Connect لتأسيس الاتصال.
4. يتم حفظ الاتصال تلقائيا ويظهر في نافذة الاتصالات.

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

يوفر Object Explorer طريقة عرض هرمية لكائنات قاعدة البيانات الخاصة بك:

• قم بتوسيع عنصر قاعدة البيانات لعرض المخططات والجداول وطرق العرض والوظائف والإجراءات المخزنة.
• انقر بزر الفأرة الأيمن على قاعدة البيانات لرؤية الخيارات التالية:
  • اطلق استعلاما جديدا
  • الدردشة مع هذه قاعدة البيانات (يبدأ تجربة دردشة pgsql)
  • اتصل ب PSQL لتشغيل اتصال طرفية psql
• انقر بزر الفأرة الأيمن على جدول واختر اختيار أفضل 1000 لعرض بياناته. يتم فتح الاستعلام في محرر الاستعلام، وتظهر النتائج في علامة التبويب عارض النتائج.

تنفيذ الاستعلامات

استخدم محرر الاستعلام لمسودة استعلامات SQL وتنفيذها:

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

مراجعة نتائج الاستعلام

يقدم عارض النتائج ميزات متقدمة للتفاعل مع نتائج الاستعلام:

• تصدير النتائج إلى تنسيقات CSV أو JSON أو Excel لمزيد من التحليل.
• استخدم خيارات البحث والتصفية والفرز لتحسين بياناتك.
• تحافظ طرق عرض البيانات الثابتة على السياق أثناء التبديل بين علامات التبويب.

استخدام GitHub Copilot للحصول على مساعدة متقدمة

يعزز تكامل GitHub Copilot تجربة تطوير PostgreSQL من خلال توفير اقتراحات التعليمات البرمجية التي تعمل الذكاء الاصطناعي وتلميحات تحسين الاستعلام والمساعدة التفاعلية في قاعدة البيانات. تساعدك هذه الميزة على تبسيط سير العمل، وتقليل وقت التطوير، واكتساب رؤى أعمق حول عمليات قاعدة بياناتك. يرشدك هذا القسم خلال خطوات تفعيل واستخدام Copilot ضمن امتداد PostgreSQL لكود Visual Studio.

تأكد من تثبيت ملحقات GitHub Copilot و Copilot Chat.

سجل الدخول إلى حساب GitHub وقم بتمكين @pgsql عامل Copilot Chat في إعدادات الملحق.

مطالبات قاعدة البيانات التفاعلية

انقر بزر الفأرة الأيمن على قاعدة بيانات واختر الدردشة مع هذه القاعدة للتفاعل مع Copilot.

اكتب محفزات مثل المثال التالي للحصول على رؤى واقتراحات مفصلة.

@pgsql tell me about the tables in the HR schema

لمزيد من المعلومات، راجع تكوين GitHub Copilot.

Connect to Azure Database for PostgreSQL باستخدام Visual Studio Code

اتصل بقاعدة بيانات Azure لنسخة خادم مرنة PostgreSQL باستخدام كود Visual Studio باتباع الخطوات التالية:

1. سجل الدخول إلى مدخل Microsoft Azure وحدد موقع مثيل خادم Azure Database for PostgreSQL المرن.
2. اذهب إلى صفحة النظرة العامة لنسخة الخادم الخاصة بك.

تواصل مع كود فيجوال ستوديو

يبسط خيار "الاتصال ب Visual Studio Code" في مدخل Microsoft Azure الاتصال بقاعدة بيانات Azure لمثيل خادم PostgreSQL المرن. تعمل هذه الميزة على تبسيط الإعداد من خلال إرشادك خلال المتطلبات الأساسية الضرورية وتكوين تفاصيل الاتصال تلقائيا. باستخدام هذا التكامل، يمكنك إنشاء اتصال وإدارة قاعدة البيانات الخاصة بك مباشرة داخل بيئة Visual Studio Code.

• اختر زر الاتصال البارز باستخدام كود فيجوال ستوديو في صفحة النظرة العامة .
• تظهر لوحة جانبية تسرد متطلبات الاتصال باستخدام كود فيجوال ستوديو.

تأكيد المتطلبات

• في اللوحة الجانبية، تأكد من استيفاء جميع المتطلبات المسبقة (كود فيجوال ستوديو وامتداد PostgreSQL) باختيار مربعات الاختيار المناسبة.

• إذا لزم الأمر، قم بتحميل كود Visual Studio والامتداد باستخدام الروابط الموجودة في اللوحة الجانبية.

• اختياريا، املأ معلمات الاتصال مثل اسم قاعدة البيانات الافتراضية وطريقة المصادقة وتجميع الاتصال.

  

فتح في Visual Studio Code

• حدد الزر فتح في Visual Studio Code في الجزء الجانبي.
• إذا استغرق فتح كود فيجوال ستوديو والامتداد أكثر من 40 ثانية، يظهر زر إعادة المحاولة في كود فيجوال ستوديو في اللوحة الجانبية.

تشغيل Visual Studio Code

• إذا كان كود فيجوال ستوديو مثبتا ويعمل، يتم تشغيل مربع حوار الاتصال الخاص بامتداد PostgreSQL تلقائيا.
• إذا كان كود فيجوال ستوديو مثبتا لكنه غير مفتوح، فإنه يطلق خلال حوالي 40 ثانية، يليه مربع حوار الاتصال.

تفاصيل اتصال التعبئة التلقائية

يفتح مربع حوار الاتصال في امتداد PostgreSQL، ويملأ حقل اسم الخادم تلقائيا نقطة نهاية الخادم الخاصة بك.

توفير تفاصيل المصادقة

حدد أسلوب المصادقة المفضل لديك:

• مصادقة كلمة المرور: أدخل اسم المستخدم وكلمة المرور يدويا.
• مصادقة Entra: أدخل بيانات اعتماد حساب Azure الخاص بك.

حدد تفاصيل الاتصال الأخرى مثل اسم الملف الشخصي، اسم قاعدة البيانات (اختياري)، مجموعة الخوادم، ورقم المنفذ.

الحفظ والاتصال

حدد الزر Save & Connect لتأسيس الاتصال. بمجرد الاتصال، قم بتوسيع الخادم في شجرة Object Explorer لعرض قواعد البيانات والمخططات والجداول، أو استخدم أداة الاستعلام المضمنة لإدارة كائنات قاعدة البيانات.

استكشاف الأخطاء وإصلاحها

إذا واجهت مشكلات أثناء عملية الاتصال:

• تحقق من أن كود Visual Studio وإضافة PostgreSQL تم تثبيتهما وتفعلهما.

• تأكد من السماح بعنوان IP في إعدادات جدار الحماية لقاعدة بيانات Azure ل PostgreSQL.

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

التعليقات والدعم

بالنسبة إلى الأخطاء وطلبات الميزات والمشكلات، استخدم أداة الملاحظات المضمنة في Visual Studio Code. يمكنك إكمال هذه العملية من خلال قائمة مساعدة كود فيجوال ستوديو أو لوحة أوامر PGSQL.

• القائمة تعليمات

  • الانتقال إلى مشكلة تقرير التعليمات >

• لوحة الأوامر

  • افتح لوحة الأوامر باستخدام Ctrl + Shift + P وتشغيل: PGSQL: Report Issue

المحتوى ذو الصلة

• ما هو امتداد PostgreSQL لكود Visual Studio؟
• Quickstart: تكوين GitHub Copilot لإضافة PostgreSQL في كود Visual Studio
• ملحق PostgreSQL ل Visual Studio Code