كيفية إنشاء وإدارة النسخ المتماثلة المقروءة في قاعدة بيانات Azure ل MariaDB باستخدام واجهة برمجة تطبيقات Azure CLI وREST

  • مقالة
  • قراءة خلال 4 دقائق

في هذه المقالة، سوف تتعلم كيفية إنشاء وإدارة النسخ المتماثلة المقروءة في قاعدة بيانات Azure لخدمة MariaDB باستخدام Azure CLI و REST API.

Azure CLI

يمكنك إنشاء نسخ متماثلة للقراءة وإدارتها باستخدام Azure CLI.

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

هام

تتوفر ميزة النسخ المتماثل للقراءة فقط لقاعدة بيانات Azure لخوادم MariaDB في طبقات التسعير للأغراض العامة أو الذاكرة المحسنة. تأكد من أن الخادم المصدر في أحد مستويات التسعير هذه.

إنشاء نسخة متماثلة للقراءة

هام

عندما تقوم بإنشاء نسخة متماثلة لمصدر لا يحتوي على نسخ متماثلة موجودة، فستتم إعادة تشغيل المصدر أولاً لتجهيز نفسه للنسخ المتماثل. ضع ذلك في الاعتبار وقم بإجراء هذه العمليات خلال فترة خارج الذروة.

يمكن إنشاء خادم نسخة متماثلة للقراءة باستخدام الأمر التالي:

az mariadb server replica create --name mydemoreplicaserver --source-server mydemoserver --resource-group myresourcegroup

az mariadb server replica create يتطلب الأمر المعلمات التالية:

إعداد قيمة المثال الوصف
resource-group  myresourcegroup  مجموعة الموارد التي سيتم إنشاء خادم النسخ المتماثلة إليها. 
الاسم mydemoreplicaserver اسم خادم النسخ المتماثلة الجديد الذي تم إنشاؤه.
المصدر الخادم mydemoserver اسم أو معرف الخادم المصدر الموجود للنسخ المتماثل منه.

لإنشاء نسخة متماثلة مقروءة عبر المنطقة، استخدم المعلمة --location .

يقوم مثال CLI أدناه بإنشاء نسخة متماثلة في غرب الولايات المتحدة.

az mariadb server replica create --name mydemoreplicaserver --source-server mydemoserver --resource-group myresourcegroup --location westus

ملاحظة

لمعرفة المزيد حول المناطق التي يمكنك إنشاء نسخة متماثلة فيها، تفضل بزيارة مقالة قراءة مفاهيم النسخ المتماثلة.

ملاحظة

يتم إنشاء النسخ المتماثلة المقروءة بنفس تكوين الخادم مثل الرئيسي. يمكن تغيير تكوين خادم النسخ المتماثلة بعد إنشائه. يوصى بالاحتفاظ بتكوين خادم النسخة المتماثلة بقيم مساوية أو أكبر من المصدر لضمان قدرة النسخة المتماثلة على مواكبة النسخة الرئيسية.

قائمة النسخ المتماثلة لخادم مصدر

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

az mariadb server replica list --server-name mydemoserver --resource-group myresourcegroup

az mariadb server replica list يتطلب الأمر المعلمات التالية:

إعداد قيمة المثال الوصف
resource-group  myresourcegroup  مجموعة الموارد التي سيتم إنشاء خادم النسخ المتماثلة إليها. 
اسم الخادم mydemoserver اسم أو معرف الخادم المصدر.

إيقاف النسخ المتماثل إلى خادم نسخة متماثلة

هام

إيقاف النسخ المتماثل إلى خادم لا رجعة فيه. بمجرد توقف النسخ المتماثل بين المصدر والنسخة المتماثلة ، لا يمكن التراجع عنها. ثم يصبح خادم النسخ المتماثلة خادما مستقلا ويدعم الآن كلا من القراءة والكتابة. لا يمكن جعل هذا الخادم في نسخة متماثلة مرة أخرى.

يمكن إيقاف النسخ المتماثل إلى خادم نسخة متماثلة مقروءة باستخدام الأمر التالي:

az mariadb server replica stop --name mydemoreplicaserver --resource-group myresourcegroup

az mariadb server replica stop يتطلب الأمر المعلمات التالية:

إعداد قيمة المثال الوصف
resource-group  myresourcegroup  مجموعة الموارد حيث يوجد خادم النسخ المتماثلة. 
الاسم mydemoreplicaserver اسم خادم النسخ المتماثل لإيقاف النسخ المتماثل عليه.

حذف خادم نسخة متماثلة

يمكن حذف خادم النسخ المتماثلة المقروء عن طريق تشغيل أمر حذف خادم az mariadb .

az mariadb server delete --resource-group myresourcegroup --name mydemoreplicaserver

حذف خادم مصدر

هام

يؤدي حذف خادم مصدر إلى إيقاف النسخ المتماثل إلى كافة خوادم النسخ المتماثل وحذف الخادم المصدر نفسه. تصبح الخوادم المتماثلة خوادم مستقلة تدعم الآن القراءة والكتابة.

لحذف خادم مصدر، يمكنك تشغيل الأمر az mariadb server delete (حذف خادم az mariadb ).

az mariadb server delete --resource-group myresourcegroup --name mydemoserver

REST API

يمكنك إنشاء نسخ متماثلة مقروءة وإدارتها باستخدام واجهة برمجة تطبيقات Azure REST.

إنشاء نسخة متماثلة للقراءة

يمكنك إنشاء نسخة متماثلة للقراءة باستخدام واجهة برمجة تطبيقات الإنشاء:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{replicaName}?api-version=2017-12-01

{
  "location": "southeastasia",
  "properties": {
    "createMode": "Replica",
    "sourceServerId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{masterServerName}"
  }
}

ملاحظة

لمعرفة المزيد حول المناطق التي يمكنك إنشاء نسخة متماثلة فيها، تفضل بزيارة مقالة قراءة مفاهيم النسخ المتماثلة.

إذا لم تقم بتعيين المعلمة إلى REPLICA على ملقم مصدر "الغرض العام" أو "الذاكرة المحسنة" وقمت بإعادة تشغيل الخادمazure.replication_support، فستتلقى خطأ. أكمل هاتين الخطوتين قبل إنشاء نسخة متماثلة.

يتم إنشاء نسخة متماثلة باستخدام نفس إعدادات الحوسبة والتخزين مثل الرئيسي. بعد إنشاء نسخة متماثلة، يمكن تغيير العديد من الإعدادات بشكل مستقل عن الخادم المصدر: إنشاء الحوسبة و vCores والتخزين وفترة الاحتفاظ بالنسخ الاحتياطي. يمكن أيضا تغيير طبقة التسعير بشكل مستقل ، باستثناء الطبقة الأساسية أو منها.

هام

قبل تحديث إعداد الخادم المصدر إلى قيمة جديدة، قم بتحديث إعداد النسخة المتماثلة إلى قيمة مساوية أو أكبر. يساعد هذا الإجراء النسخة المتماثلة على مواكبة أي تغييرات يتم إجراؤها على السيد.

قائمة النسخ المتماثلة

يمكنك عرض قائمة النسخ المتماثلة لخادم مصدر باستخدام واجهة برمجة تطبيقات قائمة النسخ المتماثلة:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{masterServerName}/Replicas?api-version=2017-12-01

إيقاف النسخ المتماثل إلى خادم نسخة متماثلة

يمكنك إيقاف النسخ المتماثل بين خادم مصدر ونسخة متماثلة مقروءة باستخدام واجهة برمجة تطبيقات التحديث.

بعد إيقاف النسخ المتماثل إلى خادم مصدر ونسخة متماثلة مقروءة، لا يمكن التراجع عنها. تصبح النسخة المتماثلة المقروءة خادما مستقلا يدعم كل من القراءة والكتابة. لا يمكن تحويل الخادم المستقل إلى نسخة متماثلة مرة أخرى.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{masterServerName}?api-version=2017-12-01

{
  "properties": {
    "replicationRole":"None"  
   }
}

حذف مصدر أو خادم نسخة متماثلة

لحذف مصدر أو خادم نسخة متماثلة، يمكنك استخدام واجهة برمجة تطبيقات الحذف:

عند حذف خادم مصدر، يتم إيقاف النسخ المتماثل لكافة النسخ المتماثلة المقروءة. تصبح النسخ المتماثلة للقراءة خوادم مستقلة تدعم الآن كل من القراءة والكتابة.

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{serverName}?api-version=2017-12-01

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