مشاركة عبر

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

  • مقالة

ينطبق على: قاعدة بيانات Azure ل MySQL - خادم واحد

هام

قاعدة بيانات Azure لخادم MySQL الفردي على مسار الإيقاف. نوصي بشدة بالترقية إلى قاعدة بيانات Azure لخادم MySQL المرن. لمزيد من المعلومات حول الترحيل إلى خادم Azure Database for MySQL المرن، راجع ما الذي يحدث لقاعدة بيانات Azure لخادم MySQL الفردي؟

في هذه المقالة، ستتعلم كيفية إنشاء وإدارة النسخ المتماثلة للقراءة في خدمة Azure Database for MySQL باستخدام Azure CLI وREST API. لمعرفة المزيد حول قراءة النسخ المتماثلة، راجع نظرة عامة.

Azure CLI

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

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

هام

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

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

هام

إذا لم يكن لدى الخادم المصدر خوادم نسخ متماثلة موجودة، فقد يحتاج الخادم المصدر إلى إعادة تشغيل لإعداد نفسه للنسخ المتماثل اعتمادا على التخزين المستخدم (v1/v2). يرجى مراعاة إعادة تشغيل الخادم وتنفيذ هذه العملية في غير ساعات الذروة. راجع إعادة تشغيل خادم المصدر للمزيد من التفاصيل.

إذا تم تمكين GTID على خادم أساسي (gtid_mode = ON)، فسوف تمكن النسخ المتماثلة التي تم إنشاؤها حديثا GTID وتستخدم النسخ المتماثل المستند إلى GTID. لمعرفة المزيد، راجع مُعرف المعاملة العمومية (GTID)

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

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

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

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

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

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

إشعار

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

إشعار

  • يحتوي الأمر az mysql server replica create على وسيطة --sku-name تسمح لك بتحديد sku ({pricing_tier}_{compute generation}_{vCores}) في أثناء إنشاء نسخة متماثلة باستخدام Azure CLI.
  • يجب أن يكون الخادم الأساسي والنسخة المتماثلة للقراءة على نفس مستوى التسعير (الغرض العام أو الذاكرة المحسنة).
  • يمكن أيضًا تغيير تكوين خادم النسخة المتماثلة بعد إنشائه. يوصى بالاحتفاظ بتكوين خادم النسخة المتماثلة بقيم متساوية أو أكبر من المصدر لضمان قدرة النسخة المتماثلة على مواكبة النسخة الرئيسية.

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

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

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

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

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

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

هام

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

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

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

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

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

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

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

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

احذف خادم مصدر

هام

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

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

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

واجهة برمجة تطبيقات REST

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

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

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

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

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

إشعار

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

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

هام

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

سرد النسخ المتماثلة

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

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

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

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

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

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

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

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

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

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

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

مشكلة معروفة

هناك جيلان من التخزين تستخدمهما الخوادم في الأغراض العامة والذاكرة المحسنة، تخزين الأغراض العامة v1 (يدعم ما يصل إلى 4 تيرابايت) وتخزين الأغراض العامة v2 (يدعم تخزينا يصل إلى 16 تيرابايت). يَجب أن يكون للخادم المصدر وخادم النسخة المتماثلة نفس نوع التخزين. نظرًا لعدم توفر التخزين للأغراض العامة v2 في جميع المناطق، يرجى التأكد من اختيار منطقة النسخ المتماثلة الصحيحة في أثناء استخدام الموقع مع CLI أو REST API لإنشاء النسخة المتماثلة للقراءة. حول كيفية تحديد نوع التخزين للخادم المَصدر، راجع الارتباط كيف يمكنني تحديد نوع التخزين الذي يعمل عليه الخادم.

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

قراءة خطأ cli للنسخة المماثلة.

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