مهام نسخ الحاوية في Azure Cosmos DB (معاينة)

مقالة
11/16/2023

ينطبق على: NoSQL MongoDB كاساندرا

يمكنك إجراء نسخ حاوية دون اتصال داخل حساب Azure Cosmos DB باستخدام مهام نسخ الحاوية.

قد تحتاج إلى نسخ البيانات داخل حساب Azure Cosmos DB الخاص بك إذا كنت تريد تحقيق أي من هذه السيناريوهات:

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

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

الشروع في العمل

للبدء، سجل للحصول على ميزة المعاينة ذات الصلة في مدخل Microsoft Azure.

نسخ الحاوية عبر حسابات Azure Cosmos DB

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

للبدء في نسخة حاوية عبر الحساب دون اتصال لحسابات Azure Cosmos DB لحسابات NoSQL API، قم بالتسجيل للحصول على علامة ميزة معاينة نسخ الحاوية عبر الحسابات دون اتصال (NoSQL) في ميزات المعاينة في مدخل Microsoft Azure. بمجرد اكتمال التسجيل، تكون المعاينة فعالة لجميع حسابات NoSQL API في الاشتراك.

نسخ الحاوية داخل حساب Azure Cosmos DB

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

لبدء استخدام نسخة الحاوية داخل الحساب دون اتصال لحسابات NoSQL وCassandra API، سجل علامة ميزة معاينة نسخة الحاوية داخل الحساب دون اتصال (Cassandra و NoSQL) في ميزات المعاينة في مدخل Microsoft Azure. عند اكتمال التسجيل، تكون المعاينة فعالة لجميع Cassandra وواجهة برمجة التطبيقات لحسابات NoSQL في الاشتراك.

واجهة برمجة التطبيقات لـ MongoDB

لبدء استخدام نسخة الحاوية داخل الحساب دون اتصال لحسابات Azure Cosmos DB لحسابات MongoDB، سجل علامة ميزة معاينة نسخة المجموعة غير المتصلة داخل الحساب (MongoDB) في ميزات المعاينة في مدخل Microsoft Azure. بمجرد اكتمال التسجيل، تكون المعاينة فعالة لجميع واجهة برمجة التطبيقات لحسابات MongoDB في الاشتراك.

نسخ بيانات الحاوية

قم بإنشاء حاوية Azure Cosmos DB الهدف باستخدام الإعدادات التي تريد استخدامها (مفتاح القسم ونقاوة معدل النقل ووحدات الطلب والمفتاح الفريد وما إلى ذلك).
أوقف العمليات على حاوية المصدر عن طريق إيقاف مثيلات التطبيق أو أي عملاء يتصلون بها مؤقتا.
إنشاء مهمة نسخ الحاوية.
راقب تقدم مهمة نسخ الحاوية وانتظر حتى تكتمل.
استأنف العمليات عن طريق توجيه التطبيق أو العميل بشكل مناسب إلى نسخة الحاوية المصدر أو الهدف كما هو مستهدف.

كيف يعمل نسخ الحاوية؟

تؤدي مهام نسخ الحاوية نسخ البيانات دون اتصال باستخدام سجل موجز التغيير المتزايد للحاوية المصدر.

يخصص النظام الأساسي مثيلات الحوسبة من جانب الخادم لحساب Azure Cosmos DB الوجهة.
تُخصص هذه المثيلات عند إنشاء مهمة نسخ حاوية أو أكثر داخل الحساب.
مهام نسخ الحاوية تعمل على هذه المثيلات.
تُنفذ مهمة واحدة عبر جميع المثيلات في أي وقت.
تتم مشاركة المثيلات بواسطة جميع مهام نسخ الحاوية التي تعمل داخل نفس الحساب.
قد يقوم النظام الأساسي بإلغاء تخصيص المثيلات إذا كانت خامدة لأكثر من 15 دقيقة.

إشعار

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

العوامل التي تؤثر على معدل مهمة نسخ الحاوية

تحدد هذه العوامل معدل تقدم مهمة نسخ الحاوية:

حاوية المصدر أو إعداد معدل نقل قاعدة البيانات.
الحاوية الهدف أو إعداد معدل نقل قاعدة البيانات.

تلميح

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

هام

يوفر SKU الافتراضي مثيلين من جانب الخادم 4-vCPU 16 غيغابايت لكل حساب.

القيود

معاينة معايير الأهلية

لا تعمل مهام نسخ الحاوية مع الحسابات التي تم تمكين الإمكانات التالية لها. قم بتعطيل هذه الميزات قبل تشغيل مهام نسخ الحاوية:

تكوينات الحساب

لم يتم ضبط إعداد مدة البقاء (TTL) في حاوية الوجهة. ونتيجة لذلك، إذا لم تنته صلاحية مستند في الحاوية المصدر، فإنه يبدأ العد التنازلي من جديد في الحاوية الوجهة.

الأسئلة المتداولة

هل هناك اتفاقية على مستوى الخدمة لمهام نسخ الحاوية؟

يتم دعم مهام نسخ الحاوية حاليا على أساس أفضل جهد. نحن لا نقدم أي ضمانات اتفاقية على مستوى الخدمة (SLA) للوقت الذي يستغرقه انتهاء المهام.

هل يمكنني إنشاء مهام نسخ حاوية متعددة داخل حساب؟

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

هل يمكنني نسخ قاعدة بيانات بأكملها داخل حساب Azure Cosmos DB؟

يجب إنشاء مهمة لكل حاوية في قاعدة البيانات.

لدي حساب Azure Cosmos DB مع مناطق متعددة. في أي منطقة سيتم تشغيل مهمة نسخ الحاوية؟

يتم تشغيل مهمة نسخ الحاوية في منطقة الكتابة. في حساب تم تكوينه مع عمليات الكتابة متعددة المناطق، يتم تشغيل المهمة في إحدى المناطق في قائمة مناطق الكتابة.

ماذا يحدث لمهام نسخ الحاوية عند تغيير منطقة كتابة الحساب؟

قد تتغير منطقة الكتابة للحساب في السيناريو النادر لحدوث انقطاع في المنطقة أو بسبب تجاوز الفشل اليدوي. في هذا السيناريو، تفشل مهام نسخ الحاوية غير المكتملة التي تم إنشاؤها داخل الحساب. ستحتاج إلى إعادة إنشاء هذه الوظائف الفاشلة. إعادة إنشاء المهام ثم تشغيلها في منطقة الكتابة الجديدة (الحالية).

المناطق المدعومة

نسخ الحاوية مدعوم حالياً في المناطق التالية:

الأمريكتان	أوروبا وأفريقيا	آسيا/المحيط الهادئ
جنوب البرازيل	وسط فرنسا	وسط أستراليا
وسط كندا	جنوب فرنسا	وسط أستراليا 2
شرق كندا	منطقة شمال ألمانيا	شرق أستراليا
Central US	وسط غرب ألمانيا	وسط الهند‬
EUAP بوسط الولايات المتحدة	أوروبا الشمالية	شرق اليابان
شرق الولايات المتحدة	شرق النرويج	وسط كوريا
East US 2	غرب النرويج	جنوب شرق آسيا
شرق الولايات المتحدة 2 EUAP	شمال سويسرا	الإمارات العربية المتحدة، الوسط
وسط شمال الولايات المتحدة	غرب سويسرا	West India
South Central US	جنوب المملكة المتحدة	شرق آسيا
غرب وسط الولايات المتحدة	غرب المملكة المتحدة	جنوب ماليزيا
غرب الولايات المتحدة	أوروبا الغربية	غرب اليابان
West US 2	إسرائيل الوسطى	جنوب شرق أستراليا
غير مدعوم	جنوب أفريقيا	غير مدعوم

المشاكل المعروفة والمشتركة

خطأ - مورد المالك غير موجود.

إذا فشل إنشاء المهمة وعرض مورد مالك الخطأ غير موجود (رمز الخطأ 404)، إما أن الحاوية الهدف لم يتم إنشاؤها بعد أو أن اسم الحاوية المستخدم لإنشاء المهمة لا يتطابق مع اسم حاوية فعلي.

تأكد من إنشاء الحاوية الهدف قبل تشغيل المهمة كما هو محدد في النظرة العامة، وتأكد من تطابق اسم الحاوية في المهمة مع اسم حاوية فعلي.
```
"code": "404",
"message": "Response status code does not indicate success: NotFound (404); Substatus: 1003; ActivityId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx; Reason: (Message: {\"Errors\":[\"Owner resource does not exist\"]
```
خطأ - الطلب غير مصرح به.

إذا فشل الطلب وعرض الخطأ غير مصرح به (رمز الخطأ 401)، فقد يتم تعطيل التخويل المحلي. تعرف على كيفية تمكين التخويل المحلي.

تستخدم مهام نسخ الحاوية المفاتيح الأساسية للمصادقة. إذا تم تعطيل التخويل المحلي، يفشل إنشاء الوظيفة. يجب تمكين التخويل المحلي لكي تعمل مهام نسخ الحاوية.
```
"code": "401",
"message": " Response status code does not indicate success: Unauthorized (401); Substatus: 5202; ActivityId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx; Reason: Local Authorization is disabled. Use an AAD token to authorize all requests."
```
خطأ - خطأ أثناء الحصول على موارد للوظيفة.

قد يحدث هذا الخطأ بسبب مشكلات في الخادم الداخلي. لحل هذه المشكلة، اتصل بدعم Microsoft عن طريق فتح طلب دعم جديد في مدخل Microsoft Azure. بالنسبة إلى نوع المشكلة، حدد ترحيل البيانات. بالنسبة إلى النوع الفرعي المشكلة، حدد نسخة حاوية داخل الحساب.
```
"code": "500"
"message": "Error while getting resources for job, StatusCode: 500, SubStatusCode: 0, OperationId:  xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, ActivityId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
```

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

تعرف على كيفية إنشاء مهام نسخ الحاوية ومراقبتها وإدارتها في حساب Azure Cosmos DB باستخدام أوامر CLI.

مشاركة عبر