الاتصال بمجموعة مع psql - Azure Cosmos DB ل PostgreSQL

ينطبق على: Azure Cosmos DB ل PostgreSQL (مدعوم بملحق قاعدة بيانات Citus إلى PostgreSQL)

يوضح لك هذا التشغيل السريع كيفية استخدام سلسلة الاتصال psql في Azure Cloud Shell للاتصال بمجموعة Azure Cosmos DB لنظام مجموعة PostgreSQL.

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

اتصال

تحتوي مجموعتك على قاعدة بيانات افتراضية تسمى citus. للاتصال بقاعدة البيانات، يمكنك استخدام سلسلة الاتصال وكلمة مرور المسؤول.

  1. في مدخل Microsoft Azure، في صفحة نظام المجموعة، حدد عنصر القائمة سلاسل الاتصال، ثم انسخ سلسلة الاتصال psql.

    لقطة شاشة تعرض نسخ سلسلة الاتصال psql.

    سلسلة psql هي من النموذج psql "host=c-<cluster>.<uniqueID>.postgres.cosmos.azure.com port=5432 dbname=citus user=citus password={your_password} sslmode=require". لاحظ أن اسم المضيف يبدأ ب c.، على سبيل المثال c-mycluster.12345678901234.postgres.cosmos.azure.com. تشير هذه البادئة إلى عقدة المنسق لنظام المجموعة. الإعداد الافتراضي dbname هو citus ويمكن تغييره فقط في وقت توفير نظام المجموعة. user يمكن أن يكون أي دور Postgres صالح على مجموعتك.

  2. افتح Azure Cloud Shell عن طريق تحديد أيقونة Cloud Shell في شريط القوائم العلوي.

    لقطة شاشة تعرض أيقونة Cloud Shell.

    عند المطالبة، اختر اشتراك Azure الذي تريد تخزين بيانات Cloud Shell فيه.

  3. الصق سلسلة الاتصال psql في shell.

  4. في سلسلة الاتصال، استبدل {your_password} بكلمة مرور نظام المجموعة، ثم اضغط على مفتاح الإدخال Enter.

    لقطة شاشة تعرض تشغيل psql في Cloud Shell.

    عندما يتصل psql بنجاح بقاعدة البيانات، سترى مطالبة جديدة citus=> (أو الاسم المخصص لقاعدة البيانات الخاصة بك):

    psql (14.2, server 14.5)
    SSL connection (protocol: TLSv1.2, cipher: ECDHE-RSA-AES256-GCM-SHA384, bits: 256, compression: off)
    Type "help" for help.
    
    citus=>
    
  5. شغّل استعلام اختبار. الصق الأمر التالي في موجه psql، ثم اضغط على Enter.

    SHOW server_version;
    

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

     server_version
    ----------------
     14.5
    (1 row)
    

الخطوات التالية

الآن بعد أن قمت بالاتصال بالمجموعة، فإن الخطوة التالية هي إنشاء جداول وتقسيمها للتحجيم الأفقي.