مشاركة عبر

نموذج المورد لميزة الاسترداد في نقطة زمنية بقاعدة بيانات Azure Cosmos

  • مقالة

ينطبق على: NoSQL MongoDB العفريت الجدول

توضح هذه المقالة نموذج المورد لميزة استرداد في نقطة زمنية في قاعدة بيانات Azure Cosmos. وهو ما يفسر المعلمات التي تدعم النسخ الاحتياطي المستمر والموارد التي يمكن استعادتها. يتم دعم هذه الميزة في Azure Cosmos DB API ل SQL وAzure Cosmos DB API ل Gremlin وTable API وواجهة برمجة تطبيقات Azure Cosmos DB ل MongoDB.

نموذج مورد حساب قاعدة البيانات

يتم تحديث نموذج الموارد لحساب قاعدة البيانات مع خصائص إضافية قليلة لدعم سيناريوهات استعادة جديدة. هذه الخصائص هي BackupPolicy وCreateMode وRestoreParameters.

BackupPolicy

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

إشعار

تتوفر حاليا ميزة الاستعادة في نقطة زمنية لحسابات Azure Cosmos DB ل NoSQL وواجهة برمجة التطبيقات لحسابات MongoDB وTable وGremlin. بعد إنشاء حساب مع الوضع المستمر، لا يمكنك التبديل إلى وضع دوري. المستوى Continuous7Days قيد المعاينة.

CreateMode

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

publicNetworkAccess

يجب تعيين هذه الخاصية إلى "معطل" لاستعادة الحساب دون الوصول إلى الشبكة العامة. إذا لم يتم توفير هذه الخاصية، فستتابع استعادة الحساب مع publicNetworkAccess ك Enabled.

RestoreParameters

RestoreParametersيحتوي المورد على تفاصيل عملية الاستعادة بما في ذلك معرف الحساب ووقت الاستعادة والموارد التي تحتاج إلى استعادة.

اسم الخاصية ‏‏الوصف
restoreMode يجب أن يكون وضع الاستعادة PointInTime.
restoreSource معرف المثيل بحساب المصدر الذي سيتم بدء الاستعادة منه.
restoreTimestampInUtc حدد الوقت بالتوقيت العالمي المتفق عليه لاستعادة الحساب.
databasesToRestore قائمة DatabaseRestoreResource العناصر لتحديد قواعد البيانات والحاويات التي يجب استعادتها. يمثل كل مورد قاعدة بيانات أحادية وكافة المجموعات الموجودة ضمن قاعدة البيانات تلك. لمزيد من المعلومات، راجع موارد SQL القابلة للاستعادة. إذا كانت هذه القيمة فارغة، ثم يتم استعادة الحساب بأكمله.
gremlinDatabasesToRestore قائمة العناصر GremlinDatabaseRestoreResource لتحديد قواعد البيانات والرسوم البيانية التي يجب استعادتها. يمثل كل مورد قاعدة بيانات أحادية وجميع الرسوم البيانية الموجودة ضمن قاعدة البيانات تلك. لمزيد من المعلومات، راجع موارد Gremlin القابلة للاستعادة. إذا كانت هذه القيمة فارغة، ثم يتم استعادة الحساب بأكمله.
restoreWithTtlDisabled قيم العلامة المنطقية (صواب/خطأ) لتعطيل مدة البقاء في الحساب المستعادة عند الانتهاء من الاستعادة. (إصدار أولي)
tablesToRestore قائمة العناصر TableRestoreResource لتحديد الجداول التي يجب استعادتها. يمثل كل مورد جدولًا أسفل قاعدة البيانات هذه. لمزيد من المعلومات، راجع موارد الجدول القابلة للاستعادة. إذا كانت هذه القيمة فارغة، ثم يتم استعادة الحساب بأكمله.

نموذج المورد

يعد JSON التالي نموذج مورد لحساب قاعدة بيانات مع تمكين النسخ الاحتياطي المستمر:

{
  "location": "westus",
  "properties": {
    "databaseAccountOfferType": "Standard",
    "locations": [
      {
        "failoverPriority": "0",
        "locationName": "southcentralus",
        "isZoneRedundant": "false"
      }
    ],
    "createMode": "Restore",
    "publicNetworkAccess":"Disabled",
    "restoreParameters": {
      "restoreMode": "PointInTime",
      "restoreWithTtlDisabled" : "true",
      "restoreSource": "/subscriptions/subid/providers/Microsoft.DocumentDB/locations/westus/restorableDatabaseAccounts/1a97b4bb-f6a0-430e-ade1-638d781830cc",
      "restoreTimestampInUtc": "2020-06-11T22:05:09Z",
      "databasesToRestore": [
        {
          "databaseName": "db1",
          "collectionNames": [
            "collection1",
            "collection2"
          ]
        },
        {
          "databaseName": "db2",
          "collectionNames": [
            "collection3",
            "collection4"
          ]
        }
      ]
    },
    "backupPolicy": {
      "type": "Continuous"
      ...
    }
  }
}

الموارد القابلة للاستعادة

تتوفر مجموعة من الموارد و APIs الجديدة لمساعدتك في اكتشاف المعلومات الهامة حول الموارد، والتي تشمل:

  • حيث يمكن استعادة الموارد
  • المواقع التي يمكن استعادة الموارد منها
  • الطوابع الزمنية عند تنفيذ العمليات الرئيسية على هذه الموارد.

إشعار

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

  • Microsoft.DocumentDB/locations/restorableDatabaseAccounts/*/read
  • Microsoft.DocumentDB/locations/restorableDatabaseAccounts/read

حساب قاعدة بيانات قابلة للاستعادة

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

اسم الخاصية ‏‏الوصف
ID المعرّف الفريد للمورد.
accountName اسم حساب قاعدة البيانات العمومية.
creationTime الوقت في التوقيت العالمي المتفق عليه عند إنشاء الحساب أو ترحيله.
deletionTime الوقت في التوقيت العالمي المتفق عليه عند حذف الحساب. تكون هذه القيمة فارغة إذا كان الحساب مباشراً.
apiType نوع واجهة برمجة التطبيقات حساب قاعدة بيانات Azure Cosmos.
restorableLocations قائمة المواقع التي يوجد بها الحساب.
restorableLocations: locationName اسم المنطقة للحساب الإقليمي.
restorableLocations: regionalDatabaseAccountInstanceId المعرف الفريد العمومي للحساب الإقليمي.
restorableLocations: creationTime الوقت في التوقيت العالمي المتفق عليه عند إنشاء الحساب الإقليمي أو ترحيله.
restorableLocations: deletionTime الوقت في التوقيت العالمي المتفق عليه عند حذف الحساب الإقليمي. تكون هذه القيمة فارغة إذا كان الحساب الإقليمي مباشراً.
OldestRestorableTimeStamp أقرب وقت بالتوقيت العالمي المنسق يمكن إجراء الاستعادة إليه. بالنسبة لمستوى 30 يوما، يمكن أن يكون هذا الوقت 30 يوما كحد أقصى من الآن، بالنسبة إلى طبقة الأيام السبعة، يمكن أن يصل هذا الوقت إلى سبعة أيام من الآن.

للحصول على قائمة بكافة الحسابات القابلة للاستعادة، راجع حسابات قاعدة البيانات القابلة للاستعادة - قائمة أو حسابات قاعدة بيانات قابلة للاستعادة - قائمة حسب مقالات الموقع.

قاعدة بيانات SQL القابلة للاستعادة

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

اسم الخاصية ‏‏الوصف
eventTimestamp الوقت في التوقيت العالمي المتفق عليه عند إنشاء قاعدة البيانات أو حذفها.
ownerId اسم قاعدة بيانات SQL.
ownerResourceId معرف المورد لقاعدة بيانات SQL،
operationType نوع العملية بحدث قاعدة البيانات هذه.
database خصائص قاعدة بيانات SQL في وقت الحدث،

إشعار

القيم المحتملة لـ operationType تشمل:

  • Create: حدث إنشاء قاعدة بيانات
  • Delete: حدث حذف قاعدة البيانات
  • Replace: حدث تعديل قاعدة البيانات
  • SystemOperation: حدث تعديل قاعدة البيانات الذي تم تشغيله عن طريق النظام. لم يبدأ المستخدم هذا الحدث

للحصول على قائمة بجميع طفرات قاعدة البيانات، راجع مقالة قواعد بيانات NoSQL القابلة للاستعادة - القائمة .

حاوية SQL قابلة للاستعادة

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

اسم الخاصية ‏‏الوصف
eventTimestamp الوقت في التوقيت العالمي المتفق عليه عندما وقع حدث الحاوية هذا.
ownerId اسم حاوية SQL.
ownerResourceId معرف المورد بحاوية SQL.
operationType نوع العملية بحدث الحاوية هذا.
container خصائص حاوية SQL في وقت الحدث.

إشعار

القيم المحتملة لـ operationType تشمل:

  • Create: حدث إنشاء حاوية
  • Delete: حدث حذف الحاوية
  • Replace: حدث تعديل الحاوية
  • SystemOperation: حدث تعديل الحاوية الذي تم تشغيله عن طريق النظام. لم يبدأ المستخدم هذا الحدث

للحصول على قائمة بجميع طفرات الحاوية ضمن نفس قاعدة البيانات، راجع مقالة حاويات NoSQL القابلة للاستعادة - القائمة .

نقل موارد SQL القابلة للاستعادة

يمثل كل مورد قاعدة بيانات أحادية وكافة الحاويات الموجودة ضمن قاعدة البيانات تلك.

اسم الخاصية ‏‏الوصف
databaseName اسم قاعدة بيانات SQL.
collectionNames قائمة حاويات SQL ضمن قاعدة البيانات هذه.

للحصول على قائمة بقاعدة بيانات SQL وسرد الحاوية الموجودة على الحساب في الطابع الزمني والموقع المحددين، راجع موارد NoSQL القابلة للاستعادة - مقالة القائمة .

قاعدة بيانات MongoDB القابلة للاستعادة

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

اسم الخاصية ‏‏الوصف
eventTimestamp الوقت في التوقيت العالمي المتفق عليه عندما وقع حدث قاعدة البيانات هذا.
ownerId اسم قاعدة بيانات MongoDB.
ownerResourceId معرف المورد لقاعدة بيانات MongoDB.
operationType نوع العملية بحدث قاعدة البيانات هذه.

إشعار

القيم المحتملة لـ operationType تشمل:

  • Create: حدث إنشاء قاعدة بيانات
  • Delete: حدث حذف قاعدة البيانات
  • Replace: حدث تعديل قاعدة البيانات
  • SystemOperation: حدث تعديل قاعدة البيانات الذي تم تشغيله عن طريق النظام. لم يبدأ المستخدم هذا الحدث

للحصول على قائمة بكافة الطفرات بقاعدة البيانات، راجع قواعد بيانات Mongodb القابلة للاستعادة - مقالة القائمة.

مجموعة MongoDB القابلة للاستعادة

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

اسم الخاصية ‏‏الوصف
eventTimestamp الوقت في التوقيت العالمي المتفق عليه عندما وقع حدث المجموعة هذا.
ownerId اسم مجموعة MongoDB.
ownerResourceId معرف المورد لمجموعة MongoDB.
operationType نوع العملية بحدث المجموعة.

إشعار

القيم المحتملة لـ operationType تشمل:

  • Create: حدث إنشاء مجموعة
  • Delete: حدث حذف مجموعة
  • Replace: حدث تعديل مجموعة
  • SystemOperation: حدث تعديل المجموعة الذي تم تشغيله عبر النظام. لم يبدأ المستخدم هذا الحدث

للحصول على قائمة بجميع طفرات الحاوية ضمن نفس قاعدة البيانات، راجع قائمة موارد MongoDB القابلة للاستعادة.

موارد MongoDB القابلة للاستعادة

يمثل كل مورد قاعدة بيانات أحادية وكافة المجموعات الموجودة ضمن قاعدة البيانات تلك.

اسم الخاصية ‏‏الوصف
databaseName اسم قاعدة بيانات MongoDB.
collectionNames قائمة مجموعات MongoDB ضمن قاعدة البيانات هذه.

للحصول على قائمة بجميع مجموعات قواعد بيانات ومجموعات MongoDB الموجودة على الحساب في الطابع الزمني والموقع المحددين، راجع قائمة موارد MongoDB القابلة للاستعادة.

موارد Graph القابلة للاستعادة

يمثل كل مورد قاعدة بيانات أحادية وجميع الرسوم البيانية الموجودة ضمن قاعدة البيانات تلك.

اسم الخاصية ‏‏الوصف
gremlinDatabaseName اسم قاعدة بيانات Graph.
graphNames قائمة Graphs الموجودة ضمن قاعدة البيانات هذه.

للحصول على قائمة بجميع الرسوم البيانية وقواعد البيانات على Gremlin الموجودة على الحساب في الطابع الزمني والموقع المحددين، اطّلع على مقالة موارد Graph القابلة للاستعادة - القائمة.

قاعدة بيانات Graph القابلة للاستعادة

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

اسم الخاصية ‏‏الوصف
eventTimestamp الوقت في التوقيت العالمي المتفق عليه عندما وقع حدث قاعدة البيانات هذا.
ownerId اسم قاعدة بيانات Graph.
ownerResourceId معرّف المورد لقاعدة بيانات Graph
operationType نوع العملية بحدث قاعدة البيانات هذه.

إشعار

القيم المحتملة لـ operationType تشمل:

  • Create: حدث إنشاء قاعدة بيانات
  • Delete: حدث حذف قاعدة البيانات
  • Replace: حدث تعديل قاعدة البيانات
  • SystemOperation: حدث تعديل قاعدة البيانات الذي تم تشغيله عن طريق النظام. لم يبدأ المستخدم هذا الحدث.

للحصول على موجز الأحداث لجميع الطفرات في قاعدة بيانات Gremlin، راجع قواعد بيانات الرسم البياني القابلة للاستعادة - القائمة.

Graphs القابل للاستعادة

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

اسم الخاصية ‏‏الوصف
eventTimestamp الوقت في التوقيت العالمي المتفق عليه عندما وقع حدث المجموعة هذا.
ownerId اسم مجموعة Graph.
ownerResourceId معرّف المورد لمجموعة Graph.
operationType نوع العملية بحدث المجموعة.

إشعار

القيم المحتملة لـ operationType تشمل:

  • Create: حدث إنشاء Graph
  • Delete: حدث حذف Graph
  • Replace: حدث تعديل Graph
  • SystemOperation: حدث تعديل المجموعة الذي تم تشغيله عبر النظام. لم يبدأ المستخدم هذا الحدث.

للحصول على قائمة بجميع حالات تبديل الحاوية ضمن نفس قاعدة البيانات، اطّلع على مقالة Graphs القابلة للاستعادة - القائمة.

موارد الجدول القابلة للاستعادة

يدرج جميع جداول Azure Cosmos DB القابلة للاستعادة المتوفرة لحساب قاعدة بيانات معين في وقت وموقع محددين. لاحظ أن واجهة برمجة التطبيقات للجدول لا تحدد قاعدة بيانات صريحة.

اسم الخاصية ‏‏الوصف
TableNames قائمة حاويات Table ضمن هذا الحساب.

للحصول على قائمة بالجداول الموجودة على الحساب في الطابع الزمني والموقع المحددين، راجع مقالةRestorable Table Resources - List.

Table القابل للاستعادة

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

اسم الخاصية ‏‏الوصف
eventTimestamp الوقت في التوقيت العالمي المتفق عليه عندما وقع حدث قاعدة البيانات هذا.
ownerId اسم قاعدة بيانات Table.
ownerResourceId معرّف المورد الخاص بمورد Table.
operationType نوع العملية بحدث Table هذا.

إشعار

القيم المحتملة لـ operationType تشمل:

  • Create: حدث انشاء Table
  • Delete: حدث حذف Table
  • Replace: حدث تعديل Table
  • SystemOperation: حدث تعديل قاعدة البيانات الذي تم تشغيله عن طريق النظام. لم يبدأ المستخدم هذا الحدث

للحصول على قائمة بجميع حالات تبديل الجدول ضمن نفس قاعدة البيانات، اطّلع على مقالة Table القابلة للاستعادة - القائمة.

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