مشاركة عبر

كيفية إعداد Azure CLI لخدمة الترحيل في قاعدة بيانات Azure لخادم PostgreSQL المرن

Azure CLI هو مجموعة من الأوامر المستخدمة عبر خدمات Azure لإنشاء الموارد وإدارتها. يوفر نفس قدرات مدخل Microsoft Azure ولكنه محسن للمستخدمين الذين يفضلون العمل ضمن بيئة سطر الأوامر. لبدء الترحيل باستخدام Azure CLI، تحتاج إلى تثبيت Azure CLI على جهازك المحلي.

Prerequisites

  • تثبيت Azure CLI: اعتمادا على نظام التشغيل الخاص بك، قم بتنزيل Azure CLI وتثبيته. وهي متوفرة ل Windows وmacOS وLinux.

  • دليل تثبيت Azure CLI: اتبع الإرشادات الواردة في وثائق Azure الرسمية لتثبيت Azure CLI - كيفية تثبيت Azure CLI.

  • تحقق من إصدار Azure CLI: تأكد من أن إصدار Azure CLI الخاص بك هو 2.56.0 على الأقل أو أعلى، لأن هذا مطلوب لخدمة الترحيل. استخدم الأمر az --version للتحقق من الإصدار الحالي.

  • تسجيل الدخول إلى Azure: بعد التثبيت، نفذ az login للمصادقة. يؤدي ذلك إلى فتح المستعرض الافتراضي لإكمال عملية تسجيل الدخول باستخدام بيانات اعتماد Azure.

تعد هذه الخطوات بيئتك لاستخدام Azure CLI لإدارة خدمة الترحيل في قاعدة بيانات Azure ل PostgreSQL بشكل فعال. راجع دائما أحدث وثائق Azure للحصول على أي تحديثات أو تغييرات على عملية التثبيت.

إعداد أوامر CLI لخدمة الترحيل

تبدأ جميع أوامر CLI بـ az postgres flexible-server migration. هناك أيضا عبارات تعليمات مقدمة لمساعدتك في فهم الخيارات المختلفة وتأطير بناء الجملة الصحيح لأوامر CLI.

خطوات إعداد أوامر واجهة سطر الأوامر (CLI)

  1. تثبيت Azure CLI: اتبع الإرشادات الواردة في وثائق Azure الرسمية لتثبيت Azure CLI - كيفية تثبيت Azure CLI.

  2. تحقق من إصدار Azure CLI: تأكد من أن إصدار Azure CLI هو 2.56.0 على الأقل أو أعلى. استخدم الأمر az --version للتحقق من الإصدار الحالي.

  3. تسجيل الدخول إلى Azure: بعد التثبيت، نفذ az login للمصادقة. يؤدي ذلك إلى فتح المستعرض الافتراضي لإكمال عملية تسجيل الدخول باستخدام بيانات اعتماد Azure.

بمجرد تثبيت واجهة سطر الأوامر، افتح موجه الأوامر وقم بتسجيل الدخول إلى حساب Azure باستخدام الأمر التالي.

az login

ترحيل الأوامر

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

أمر التعليمات

--help يعد الأمر في Azure CLI خيارا قيما يوفر وثائق مفصلة حول الأوامر والأوامر الفرعية الخاصة بها، بما في ذلك الأفعال المطلوبة للعمليات. –-helpيعرض الأمر الأوامر الضرورية والإجراءات المقترنة بها لخدمة الترحيل في قاعدة بيانات Azure ل PostgreSQL.

az postgres flexible-server migration –-help

يرشدك الإخراج خلال الخطوات والمعلمات اللازمة المطلوبة لإدارة عمليات ترحيل قاعدة البيانات الخاصة بك بفعالية باستخدام Azure CLI.

إنشاء أمر

az postgres flexible-server migration create يتم استخدام الأمر في Azure CLI لبدء سير عمل ترحيل جديد. يسهل ترحيل قواعد البيانات من مثيل PostgreSQL المصدر إلى قاعدة بيانات Azure المستهدفة لمثيل الخادم المرن PostgreSQL. يقوم هذا الأمر بإعداد المعلمات والتكوينات الضرورية لضمان عملية ترحيل سلسة وفعالة.

لمزيد من المعلومات، راجع az postgres flexible-server migration create

أمر القائمة

az postgres flexible-server migration list يتم استخدام الأمر لسرد جميع محاولات الترحيل التي تم إجراؤها إلى قاعدة بيانات Azure لهدف PostgreSQL. يوفر هذا الأمر نظرة عامة على عمليات الترحيل التي تم بدؤها، مما يسمح لك بتعقب حالة وتفاصيل كل محاولة ترحيل.

لمزيد من المعلومات، راجع az postgres flexible-server migration list

إظهار الأمر

az postgres flexible-server migration show يساعدك الأمر على مراقبة عمليات الترحيل المستمرة ويعطي الحالة والحالة الفرعية الحالية للترحيل. تتضمن هذه التفاصيل معلومات حول الحالة الحالية والحالة الفرعية للترحيل.

لمزيد من المعلومات، راجع az postgres flexible-server migration show

بعض حالات الترحيل المحتملة:

دول الهجرة

State Description
InProgress إعداد البنية الأساسية للترحيل قيد التنفيذ، أو ترحيل البيانات الفعلي قيد التقدم.
Canceled يتم إلغاء الترحيل أو حذفه.
Failed فشل الترحيل.
فشل التحقق من الصحة فشل التحقق من الصحة.
Succeeded نجح الترحيل واكتمل.
WaitingForUserAction ينطبق فقط على الترحيل عبر الإنترنت. في انتظار إجراء المستخدم لإجراء الانتقال.

الدول الفرعية للهجرة

Substate Description
PerformingPreRequisiteSteps يتم الآن إعداد البنية الأساسية لترحيل البيانات.
التحقق من الصحة قيد التقدم التحقق من الصحة قيد التقدم.
MigratingData ترحيل البيانات قيد التقدم.
CompletingMigration الترحيل في المراحل النهائية من الاكتمال.
Completed اكتمل الترحيل.
Failed فشل الترحيل.

الحالات الفرعية للتحقق من الصحة

Substate Description
Failed فشل التحقق من الصحة.
Succeeded التحقق من الصحة ناجح.
Warning التحقق من الصحة في تحذير.

أمر التحديث

يتم استخدام az postgres flexible-server migration update الأمر لإدارة عملية الترحيل إلى قاعدة بيانات Azure لخادم مرن ل PostgreSQL. على وجه التحديد، يمكن استخدامه ل:

  • إجراء انتقال: يؤدي هذا إلى إنهاء عملية الترحيل عن طريق تحويل حركة مرور قاعدة البيانات من الخادم المصدر إلى الخادم المرن الهدف.

    • بعد اكتمال ترحيل البيانات الأساسية، تنتقل مهمة الترحيل إلى الحالة الفرعية WaitingForCutoverTrigger . في هذه الحالة، يمكن للمستخدمين تشغيل الانتقال من المدخل عن طريق تحديد اسم الترحيل في شبكة الترحيل أو من خلال CLI.
    • قبل بدء الانتقال، من المهم التأكد من ما يلي:
      • تم إيقاف عمليات الكتابة إلى المصدر
      • latency القيمة تنخفض إلى 0 أو قريبة من 0
      • latency تشير القيمة إلى وقت آخر مزامنة للهدف مع المصدر. عند هذه النقطة، يمكن إيقاف عمليات الكتابة إلى المصدر وبدء الانتقال. في حالة وجود حركة مرور كثيفة في المصدر ، يجب عليك إيقاف الكتابة أولا بحيث يمكن أن Latency تقترب من 0 ، ثم يتم بدء الانتقال.
      • تطبق عملية الانتقال جميع التغييرات المعلقة من المصدر إلى الهدف وتستكمل الترحيل. إذا قمت بتشغيل "قطع" حتى مع غير صفري Latency، يتوقف النسخ المتماثل حتى تلك النقطة الزمنية. يتم بعد ذلك تطبيق جميع البيانات الموجودة على المصدر حتى نقطة الانتقال على الهدف. لنفترض أن زمن الانتقال كان 15 دقيقة عند نقطة الانتقال، لذلك تنطبق جميع البيانات التي تم تغييرها في آخر 15 دقيقة على الهدف.

  • إلغاء الترحيل: إذا لزم الأمر، يسمح لك هذا الخيار بإيقاف عملية الترحيل.

  • إعداد النسخ المتماثل المنطقي في المصدر: يكون هذا مفيدا عندما يكون الخادم المصدر عبارة عن قاعدة بيانات Azure ل PostgreSQL - خادم واحد، حيث يقوم بإعداد الخادم للنسخ المتماثل للبيانات إلى الخادم المرن.

لمزيد من المعلومات، راجع az postgres flexible-server migration update

Summary

يلخص الجدول التالي المعلمات المستخدمة من قبل أوامر الترحيل:

Parameter الأوامر ذات الصلة Description
subscription إنشاء قائمة، عرض، تحديث معرف الاشتراك لخادم PostgreSQL المرن
resource-group إنشاء قائمة، عرض، تحديث مجموعة موارد خادم PostgreSQL المرن
name إنشاء، قائمة، عرض اسم خادم PostgreSQL المرن
migration-name إنشاء وعرض وتحديث معرف فريد لعمليات الترحيل التي تمت محاولتها إلى خادم مرن. يقبل هذا الحقل الأحرف الأبجدية الرقمية فقط ولا يقبل أي أحرف خاصة باستثناء الواصلة (-). لا يمكن أن يبدأ الاسم ب -، ولا يمكن أن يكون لعمليات ترحيل إلى هدف خادم مرن نفس الاسم.
filter list لتصفية عمليات الترحيل، يتم دعم قيمتين - نشطة و الكل
help إنشاء قائمة، عرض، تحديث يوفر معلومات حول كل أمر.
migration-mode create فهذه معلمة اختيارية. القيم المسموح بها هي - غير متصلة أو متصلة. القيمة الافتراضية: غير متصل.
migration-option create يسمح لك بإجراء عمليات التحقق من الصحة قبل تشغيل الترحيل. الافتراضي هو ValidateAndMigrate. القيم المسموح بها هي - ترحيل، التحقق من الصحة، التحقق من الصحةوالهجرة.
properties create مسار مطلق إلى ملف JSON يحتوي على معلومات حول المصدر، والخادم الهدف، وقواعد البيانات المراد ترحيلها، وأوضاع SSL، وتحديد أنواع المصادر

تفاصيل ملف JSON

az postgres flexible-server migration create يتطلب الأمر مسار ملف JSON كجزء من --properties المعلمة، والتي تحتوي على تفاصيل التكوين للترحيل، مثل معرف مورد خادم قاعدة البيانات المصدر وبيانات اعتماد المسؤول وقواعد البيانات المراد ترحيلها والإعدادات الهامة الأخرى. فيما يلي الخصائص المختلفة:

اسم الخاصية Description
sourceDbServerResourceId تفاصيل الخادم المصدر بتنسيق الأجهزة الظاهرية (VMs) المحلية وخدمة PostgreSQL المستندة إلى السحابة - <<hostname or IP address>>:<<port>>@<<username>>. إذا كان الخادم المصدر هو قاعدة بيانات Azure ل PostgreSQL - خادم واحد، فسيكون معرف المورد بالتنسيق - /subscriptions/<<Subscription ID>>/resourceGroups/<<Resource Group Name>>/providers/Microsoft.DBforPostgreSQL/servers/<<PostgreSQL Single Server name>>
adminCredentials تسرد هذه المعلمة كلمات المرور للمستخدمين المسؤولين لكل من الخادم المصدر وخادم PostgreSQL المرن الهدف. تساعد كلمات المرور هذه على مصادقة الخوادم المصدر والهدف. يتضمن اثنين من الخصائص الفرعية، sourceServerPassword و targetServerPassword
targetServerUserName القيمة الافتراضية هي المستخدم المسؤول الذي تم إنشاؤه أثناء إنشاء الخادم المرن لهدف PostgreSQL، ويتم استخدام كلمة المرور المقدمة للمصادقة مقابل هذا المستخدم.
dbsToMigrate حدد قائمة قواعد البيانات التي تريد ترحيلها إلى خادم مرن. يمكنك تضمين ثمانية أسماء لقواعد بيانات كحد أقصى في المرة الواحدة. توفير قائمة قواعد البيانات بتنسيق المصفوفة.
overwriteDBsInTarget عند التعيين إلى true (افتراضي)، إذا كان الخادم الهدف يحتوي على قاعدة بيانات موجودة بنفس اسم قاعدة البيانات التي تحاول ترحيلها، فإن خدمة الترحيل تستبدل قاعدة البيانات تلقائيا
migrationRuntimeResourceId مطلوب إذا كان خادم وقت التشغيل يحتاج إلى استخدام للترحيل. التنسيق هو - /subscriptions/<<Subscription ID>>/resourceGroups/<<Resource Group Name>>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<<PostgreSQL flexible server name>>
sourceDBServerFullyQualifiedDomainName مطلوب فقط إذا كان المصدر عبارة عن خادم واحد وكان خلف خادم DNS مخصص أو مساحات أسماء DNS مخصصة أو FQDN مخصص أو يحتاج إلى إمكانية الوصول عبر IP.
targetDBServerFullyQualifiedDomainName مطلوب فقط إذا كان الهدف خلف خادم DNS مخصص أو مساحات أسماء DNS مخصصة أو FQDN مخصص أو يحتاج إلى الوصول إليه عبر IP.
sourceType المعلمة المطلوبة. يمكن أن تكون القيم - محلية، AWS_RDS، AWS_AURORA، GCP_CloudSQL، AzureVM، PostgreSQLSingleServer
sslMode أوضاع SSL للترحيل. وضع SSL ل PostgreSQLSingleServer هو VerifyFull وتفضيلات/طلب أنواع المصادر الأخرى.

المحتوى ذو الصلة

  • Last updated on