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

يطبق على: قاعدة بيانات Azure لـ PostgreSQL - الخادم المرن

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

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

• حساب 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>

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

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

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

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

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

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

إدارة الخادم