البدء السريع: الاتصال واستعلام PostgreSQL

في هذا البدء السريع، تستخدم إضافة PostgreSQL الخاصة ب تعليمة Visual Studio برمجية للاتصال بخادم PostgreSQL، إنشاء جدول، إدراج صفوف، وتشغيل استعلام، وكل ذلك من داخل VS Code.

ما ستتعلمه

• افتح مربع الاتصال واتصل بخادم PostgreSQL
• إنشاء قاعدة بيانات وجدول باستخدام محرر الاستعلامات
• بيانات الإدراج والاستعلام
• عرض النتائج في لوحة النتائج

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

قبل البدء، تأكد من أن لديك ما يلي:

• تعليمة Visual Studio برمجية مثبت.
• تم تثبيت إضافة PostgreSQL ل تعليمة Visual Studio برمجية من سوق الإضافات.
• الوصول إلى خادم PostgreSQL يعمل. يمكنك استخدام تثبيت محلي، أو حاوية Docker، أو أي نسخة PostgreSQL متوفرة أو متوفرة في السحابة.

الاتصال بخادم

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

2. مرر المؤشر فوق رأس قسم الاتصالات واختر إضافة اتصال جديد (الأيقونة + ). يفتح مربع الاتصال مع اختيار تبويب المعلمات .

   

3. املأ حقول الاتصال لخادم PostgreSQL الخاص بك:

   الميدان	قيمة المثال	الوصف
   اسم الخادم	localhost	اسم المضيف أو عنوان IP الخاص بالخادم.
   نوع المصادقة	كلمة المرور	اختر كلمة المرور، أو مصادقة إنترا، أو AWS IAM (RDS/AURORA)، أو لا شيء.
   اسم المستخدم	postgres	تسجيل الدخول الخاص بك PostgreSQL.
   كلمة المرور	(كلمة المرور)	كلمة المرور الخاصة بالحساب.
   اسم قاعدة البيانات	postgres	قاعدة البيانات للاتصال بها.
   اسم الاتصال	Local dev server	اسم عرض اختياري لهذا الاتصال.

   نصيحة

   اختر خيار حفظ كلمة المرور لتخزين كلمة المرور بأمان في مخزن بيانات اعتماد VS Code حتى لا يتم توجيهك في كل اتصال. للاطلاع على مصادقة Microsoft Entra ID، أو مصادقة AWS IAM، أو أي إعداد هوية آخر، انظر الاتصالات والهوية.

4. حدد حفظ واتصال.

   يظهر الخادم في شجرة الاتصالات مع مؤشر حالة أخضر عند نجاح الاتصال.

إنشاء قاعدة بيانات

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

2. الصق العبارة التالية واضغط على Ctrl+Shift+E (Windows/Linux) أو Cmd+Shift+E (macOS) لتشغيلها:

   CREATE DATABASE tutorialdb;
   

3. انقر بزر الفأرة الأيمن على عقدة الخادم في شجرة الاتصالات واختر Refresh لرؤية قاعدة بيانات tutorialdb الجديدة في الشجرة.

إنشاء جدول

1. غير سياق قاعدة البيانات إلى tutorialdb. استخدم قائمة قاعدة البيانات المنسدلة في شريط أدوات محرر الاستعلام، أو شغل pgsql.changeDatabase من لوحة الأوامر (Change PostgreSQL Database) واختر tutorialdb.

2. الصق العبارة التالية في محرر الاستعلام وشغلها باستخدام Ctrl+Shift+E / Cmd+Shift+E:

   CREATE TABLE customers (
       id SERIAL PRIMARY KEY,
       name VARCHAR(50) NOT NULL,
       email VARCHAR(50) NOT NULL,
       city VARCHAR(50)
   );
   

   تؤكد لجنة الرسائل أن البيان تم إنجاز البيان بنجاح.

إدراج البيانات

استبدل محتويات محرر الاستعلام بالعبارة التالية وشغلها:

INSERT INTO customers (name, email, city)
VALUES
    ('Alice Johnson', 'alice@example.com', 'Seattle'),
    ('Bob Smith', 'bob@example.com', 'Portland'),
    ('Carol Williams', 'carol@example.com', 'San Francisco');

تؤكد لوحة الرسائل أنه تم إدخال ثلاثة صفوف.

الاستعلام عن البيانات

استبدل محتويات محرر الاستعلام بالعبارة التالية وشغلها:

SELECT * FROM customers;

لوحة النتائج تعرض الصفوف الثلاثة التي أدرجتها.

المؤشر

تحقق من النتيجة

للتأكد من استمرار البيانات، قم بتشغيل استعلام مفلتر:

SELECT name, city
FROM customers
WHERE city = 'Seattle';

لوحة النتائج تعيد صفا واحدا لأليس جونسون في سياتل.

استكشاف المشكلات في الاتصالات وإصلاحها

إذا لم تتمكن من الاتصال بالخادم، تحقق من الأسباب الشائعة التالية:

• رفض الاتصال: تحقق من أن PostgreSQL يعمل ويستمع على المضيف والمنفذ المتوقع. بالنسبة للخوادم المحلية، تأكد من بدء الخدمة.
• فشل التحقق من كلمة المرور: تحقق مرتين من قيم اسم المستخدموكلمة المرور . راجع ملف الخادم pg_hba.conf للتأكد من أن طريقة المصادقة تسمح بالاتصال.
• أخطاء SSL: قم بتكوين إعدادات SSL في خيارات الاتصال المتقدمة. للتفاصيل، راجع الاتصالات والهوية: SSL و TLS.

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

• الروابط والهوية
• محرر الاستعلام وIntelliSense
• مستكشف الكائنات