التشغيل السريع: الاتصال والاستعلام باستخدام Azure CLI مع خادم مرن قاعدة بيانات Azure لـ PostgreSQL

يوضح هذا التشغيل السريع كيفية الاتصال بخادم مرن قاعدة بيانات Azure لـ PostgreSQL باستخدام Azure CLI مع az postgres flexible-server connect. كما يوضح كيفية تنفيذ استعلام واحد أو ملف SQL باستخدام الأمر az postgres flexible-server execute . يساعدك هذا الأمر على اختبار الاتصال بخادم قاعدة البيانات وتشغيل الاستعلامات. يمكنك أيضا تشغيل عدة استعلامات باستخدام الوضع التفاعلي.

Prerequisites

  • حساب Azure مع اشتراك نشط. إذا لم يكن لديك واحد، فاحصل على نسخة تجريبية مجانية.
  • تثبيت أحدث إصدار من Azure CLI.
  • تسجيل الدخول باستخدام Azure CLI مع az login الأمر.
  • (اختياري) قم بتشغيل استمرار معلمة تجريبية باستخدام az config param-persist on. يساعدك استمرار المعلمة على استخدام السياق المحلي دون الحاجة إلى تكرار العديد من الوسيطات مثل مجموعة الموارد أو الموقع.

إنشاء قاعدة بيانات Azure لمثيل PostgreSQL

أولا، إنشاء خادم مرن مدار قاعدة بيانات Azure لـ PostgreSQL. في Azure Cloud Shell، قم بتشغيل السكربت التالي. سجل اسم الخادم، واسم المستخدم، وكلمة المرور التي تم إنشاؤها من هذا الأمر.

az postgres flexible-server create --public-access <your-ip-address>

لتخصيص الأمر، قم بتوفير المزيد من الوسيطات. راجع جميع الوسيطات الخاصة بإنشاء az postgres flexible-server create.

عرض كل الوسيطات

يمكنك عرض جميع الوسائط الخاصة بهذا الأمر باستخدام الوسيط.--help

az postgres flexible-server connect --help

اختبار اتصال خادم قاعدة البيانات

يمكنك اختبار الاتصال بقاعدة البيانات والتحقق من صحته من بيئة التطوير الخاصة بك باستخدام الأمر az postgres flexible-server connect .

az postgres flexible-server connect \
    -n <servername> -u <username> -p "<password>" -d <databasename>

مثال:

az postgres flexible-server connect \
    -n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres

ترى إخراجا مشابها إذا كان الاتصال ناجحا.

Successfully connected to server372060240.

إذا فشل الاتصال، فتحقق من النقاط التالية:

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

تشغيل عدة استعلامات باستخدام الوضع التفاعلي

يمكنك تشغيل عدة استعلامات باستخدام الوضع التفاعلي . لتمكين الوضع التفاعلي، قم بتشغيل الأمر التالي.

az postgres flexible-server connect \
    -n <servername> -u <username> -p "<password>" -d <databasename> \
    --interactive

مثال:

az postgres flexible-server connect \
    -n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres --interactive

ترى تجربة psql shell مشابهة للإخراج التالي:

Password for starchylapwing9:
Server: PostgreSQL 13.14
Version: 4.0.1
Home: http://pgcli.com
postgres> SELECT 1;
+----------+
| ?column? |
|----------|
| 1        |
+----------+
SELECT 1
Time: 0.167s
postgres>

تنفيذ استعلامات مفردة

استخدم az postgres flexible-server execute لتشغيل استعلامات مفردة مقابل قاعدة بيانات Postgres.

az postgres flexible-server execute \
    -n <servername> -u <username> -p "<password>" -d <databasename> \
    -q <querytext> --output table

مثال:

az postgres flexible-server execute \
    -n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres \
    -q "SELECT 1" --output table

ترى إخراجا كما هو موضح في المثال التالي:

Successfully connected to server372060240.
Ran Database Query: 'SELECT 1'
Retrieving first 30 rows of query output, if applicable.
Closed the connection to server372060240
?column?
----------
1

تشغيل ملف SQL

استخدم الأمر az postgres flexible-server execute مع الوسيطة --file-path ، -fلتنفيذ ملف SQL.

az postgres flexible-server execute \
    -n <server-name> -u <username> -p "<password>" -d <database-name> \
    --file-path "<file-path>"

مثال: إعداد test.sql ملف. يمكنك استخدام البرنامج النصي للاختبار التالي مع استعلامات بسيطة SELECT :

SELECT 1;
SELECT 2;
SELECT 3;

احفظ المحتوى إلى test.sql الملف في الدليل الحالي. ثم قم بتشغيل الأمر التالي لتنفيذ الملف.

az postgres flexible-server execute \
    -n server372060240 -u starchylapwing9 -p "dbpassword" -d postgres \
    -f "test.sql"

ترى إخراجا كما هو موضح في المثال التالي:

Running sql file 'test.sql'...
Successfully executed the file.
Closed the connection to server372060240