Модель ресурсов для функции восстановления Azure Cosmos DB на определенный момент времени

Статья
04/12/2023

ПРИМЕНИМО К: Nosql Mongodb Гремлин Таблица

В этой статье описывается модель ресурсов для функции восстановления Azure Cosmos DB на определенный момент времени. В ней объясняются параметры, поддерживающие непрерывное резервное копирование и ресурсы, которые можно восстановить. Эта функция поддерживается в API Azure Cosmos DB для SQL, API Azure Cosmos DB для Gremlin, API таблиц и API Azure Cosmos DB для MongoDB.

Модель ресурсов учетной записи базы данных

В модель ресурсов учетной записи базы данных добавлены дополнительные свойства для поддержки новых сценариев восстановления: А именно: BackupPolicy, CreateMode и RestoreParameters.

BackupPolicy

Новое свойство, добавленное в политику резервного копирования на уровне учетных записей с именем Type для параметра backuppolicy, позволяет выполнять непрерывное резервное копирование и восстановление до точки во времени. Этот режим называется непрерывным резервным копированием. Этот режим можно задать при создании учетной записи или при переносе учетной записи из периодического в непрерывный режим. После включения непрерывного режима все контейнеры и базы данных, созданные в этой учетной записи, будут по умолчанию поддерживать непрерывное резервное копирование и функции восстановления до точки во времени. Для уровня непрерывного резервного копирования можно задать значение Continuous7Days или Continuous30Days. Если уровень не указан, по умолчанию для учетной записи применяется уровень Continuous30Days.

Примечание

В настоящее время функция восстановления на определенный момент времени доступна для Azure Cosmos DB для NoSQL, API для MongoDB, таблиц и учетных записей Gremlin. Если при создании учетной записи выбран непрерывный режим, его нельзя изменить на периодический. Уровень Continuous7Days предоставляется в предварительной версии.

CreateMode

Это свойство указывает, каким способом была создана учетная запись. Допустимые значения — Default (По умолчанию) и Restore (Восстановление). Чтобы выполнить восстановление, присвойте этому параметру значение Restore и укажите соответствующие значения в свойстве RestoreParameters.

RestoreParameters

Ресурс RestoreParameters содержит сведения об операции восстановления, включая идентификатор учетной записи, время восстановления и ресурсы, которые необходимо восстановить.

Имя свойства	Описание
`restoreMode`	В качестве режима восстановления укажите `PointInTime`.
`restoreSource`	InstanceId исходной учетной записи, из которой будет выполнено восстановление.
`restoreTimestampInUtc`	Момент времени в формате UTC для восстановления учетной записи.
`databasesToRestore`	Список объектов `DatabaseRestoreResource` включает базы данных и контейнеры, которые требуется восстановить. Каждый ресурс представляет отдельную базу данных и все коллекции в этой базе данных. Дополнительные сведения см. в разделе Ресурсы SQL с возможностью восстановления. Если значение пустое, будет восстановлена вся учетная запись.
`gremlinDatabasesToRestore`	Список объектов `GremlinDatabaseRestoreResource` включает базы данных и графы, которые требуется восстановить. Каждый ресурс представляет отдельную базу данных и все графы в этой базе данных. Дополнительные сведения см. в разделе Ресурсы Gremlin с возможностью восстановления. Если значение пустое, будет восстановлена вся учетная запись.
`tablesToRestore`	Список объектов `TableRestoreResource` включает таблицы, которые требуется восстановить. Каждый ресурс представляет таблицу в такой базе данных. Дополнительные сведения см. в разделе Ресурсы таблиц с возможностью восстановления. Если значение пустое, будет восстановлена вся учетная запись.

Пример ресурса

Следующий код JSON представляет собой пример ресурса учетной записи базы данных с включенным непрерывным резервным копированием:

{
  "location": "westus",
  "properties": {
    "databaseAccountOfferType": "Standard",
    "locations": [
      {
        "failoverPriority": "0",
        "locationName": "southcentralus",
        "isZoneRedundant": "false"
      }
    ],
    "createMode": "Restore",
    "restoreParameters": {
      "restoreMode": "PointInTime",
      "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"
      ....
    }
  }
}

Ресурсы с поддержкой восстановления

Набор новых ресурсов и API поможет вам узнать важную информацию о ресурсах, в том числе следующую:

где можно восстановить ресурсы;
расположения, из которых можно восстановить ресурсы;
метки времени при выполнении ключевых операций с этими ресурсами.

Примечание

Для всех API-интерфейсов, используемых для перечисления этих ресурсов, требуются следующие разрешения:

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

Учетная запись базы данных с поддержкой восстановления

Этот ресурс содержит экземпляр учетной записи базы данных, который можно восстановить. Учетная запись базы данных может быть удаленной или действующей. Она содержит сведения, позволяющие найти учетную запись исходной базы данных, которую требуется восстановить.

Имя свойства	Описание
`ID`	Уникальный идентификатор ресурса.
`accountName`	Имя глобальной учетной записи базы данных.
`creationTime`	Время создания или переноса учетной записи в формате UTC.
`deletionTime`	Время удаления учетной записи в формате UTC. Для действующей учетной записи это значение будет пустым.
`apiType`	Тип API учетной записи Azure Cosmos DB.
`restorableLocations`	Список расположений, где существовала учетная запись.
`restorableLocations: locationName`	Имя региона для региональной учетной записи.
`restorableLocations: regionalDatabaseAccountInstanceId`	GUID региональной учетной записи.
`restorableLocations: creationTime`	Время создания или переноса региональной учетной записи в формате UTC.
`restorableLocations: deletionTime`	Время удаления региональной учетной записи в формате UTC. Для действующей региональной учетной записи это значение будет пустым.
`OldestRestorableTimeStamp`	Самое раннее время в формате UTC, до которого можно выполнить восстановление. Для уровня с 30-дневным хранением это время не может превышать 30 дней с настоящего момента, а для уровня с 7-дневным хранением — 7 дней.

Список всех учетных записей с поддержкой восстановления см. в статьях Учетные записи баз данных с поддержкой восстановления — список или Учетные записи баз данных с поддержкой восстановления — список по расположению.

Базы данных SQL с поддержкой восстановления

Каждый ресурс содержит сведения о событии изменения, например создании или удалении, которые произошли в Базе данных SQL Microsoft Azure. Эта информация может быть полезна в сценариях, где база данных была случайно удалена и необходимо выяснить, когда произошло это событие.

Имя свойства	Описание
`eventTimestamp`	Время создания или удаления базы данных в формате UTC.
`ownerId`	Имя базы данных SQL.
`ownerResourceId`	ИД ресурса базы данных SQL.
`operationType`	Тип операции этого события базы данных.
`database`	Свойства базы данных SQL на момент события.

Примечание

Возможные значения для operationType:

Create — событие создания базы данных.
Delete — событие удаления базы данных.
Replace — событие изменения базы данных.
SystemOperation — событие изменения базы данных, активируемое системой. Это событие не инициируется пользователем

Чтобы получить список всех изменений базы данных, см. статью Восстанавливаемые базы данных NoSQL — список .

Контейнеры SQL с поддержкой восстановления

Каждый ресурс содержит сведения о событии изменения, например создании или удалении, которые произошли в контейнере SQL. Эта информация может быть полезна в сценариях, когда контейнер был изменен или удален и необходимо выяснить, когда произошло это событие.

Имя свойства	Описание
`eventTimestamp`	Время в формате UTC, когда произошло это событие контейнера.
`ownerId`	Имя контейнера SQL.
`ownerResourceId`	Имя контейнера SQL.
`operationType`	Тип операции этого события контейнера.
`container`	Свойства контейнера SQL на момент события.

Примечание

Возможные значения для operationType:

Create — событие создания контейнера.
Delete — событие удаления контейнера.
Replace — событие изменения контейнера.
SystemOperation — событие изменения контейнера, активируемое системой. Это событие не инициируется пользователем

Чтобы получить список всех изменений контейнеров в одной базе данных, см. статью Восстанавливаемые контейнеры NoSQL — список .

Ресурсы SQL с поддержкой восстановления

Каждый ресурс представляет отдельную базу данных и все контейнеры в этой базе данных.

Имя свойства	Описание
`databaseName`	Имя базы данных SQL.
`collectionNames`	Список контейнеров SQL в этой базе данных.

Чтобы получить список со списком базы данных SQL и контейнера, которые существуют в учетной записи в заданной метке времени и расположении, см. статью Восстанавливаемые ресурсы NoSQL — список .

Базы данных MongoDB с поддержкой восстановления

Каждый ресурс содержит сведения о событии изменения, например создании или удалении, которые произошли в базе данных MongoDB. Эта информация может быть полезна в сценариях, когда база данных была случайно удалена и необходимо выяснить, когда произошло это событие.

Имя свойства	Описание
`eventTimestamp`	Время в формате UTC, когда произошло событие базы данных.
`ownerId`	Имя базы данных MongoDB.
`ownerResourceId`	ИД ресурса базы данных MongoDB.
`operationType`	Тип операции этого события базы данных.

Примечание

Возможные значения для operationType:

Create — событие создания базы данных.
Delete — событие удаления базы данных.
Replace — событие изменения базы данных.
SystemOperation — событие изменения базы данных, активируемое системой. Это событие не инициируется пользователем

Чтобы получить список всех изменений базы данных, см. статью Базы данных MongoDB с поддержкой восстановления — список.

Коллекция MongoDB с поддержкой восстановления

Каждый ресурс содержит сведения о событии изменения, например создании или удалении, которые произошли в коллекции MongoDB. Эта информация может быть полезна в сценариях, где коллекция была изменена или удалена и необходимо выяснить, когда произошло это событие.

Имя свойства	Описание
`eventTimestamp`	Время в формате UTC, когда произошло это событие коллекции.
`ownerId`	Имя коллекции MongoDB.
`ownerResourceId`	ИД ресурса коллекции MongoDB.
`operationType`	Тип операции этого события коллекции.

Примечание

Возможные значения для operationType:

Create — событие создания коллекции.
Delete — событие удаления коллекции.
Replace — событие изменения коллекции.
SystemOperation — событие изменения коллекции, активируемое системой. Это событие не инициируется пользователем

Чтобы получить список всех изменений контейнера в одной базе данных, см. статью Ресурсы MongoDB с поддержкой восстановления — список.

Ресурсы MongoDB с поддержкой восстановления

Каждый ресурс представляет отдельную базу данных и все коллекции в этой базе данных.

Имя свойства	Описание
`databaseName`	Имя базы данных MongoDB.
`collectionNames`	Список коллекций MongoDB в этой базе данных.

Чтобы получить список всех сочетаний баз данных и коллекций MongoDB, существующих в учетной записи с заданной меткой времени и расположением, см. статью Ресурсы MongoDB с поддержкой восстановления — список.

Ресурсы Graph с поддержкой восстановления

Каждый ресурс представляет отдельную базу данных и все графы в этой базе данных.

Имя свойства	Описание
`gremlinDatabaseName`	Имя базы данных Graph.
`graphNames`	Список графов в этой базе данных.

Для получения списка всех сочетаний баз данных Graph, существующих в учетной записи с заданной меткой времени и расположением, обратитесь к статье Ресурсы Gremlin с поддержкой восстановления — список.

База данных Graph с поддержкой восстановления

Каждый ресурс содержит сведения о событии изменения, например о событии создания или удаления, которое произошло в базе данных Graph. Эта информация может быть полезна в сценариях, когда база данных была случайно удалена и необходимо выяснить, когда произошло это событие.

Имя свойства	Описание
`eventTimestamp`	Время в формате UTC, когда произошло событие базы данных.
`ownerId`	Имя базы данных Graph.
`ownerResourceId`	Идентификатор ресурса базы данных Graph.
`operationType`	Тип операции этого события базы данных.

Примечание

Возможные значения для operationType:

Create — событие создания базы данных.
Delete — событие удаления базы данных.
Replace — событие изменения базы данных.
SystemOperation — событие изменения базы данных, активируемое системой. Это событие не инициируется пользователем.

Веб-канал событий всех изменений в базе данных Gremlin описан в статье Базы данных Graph с возможностью восстановления — список.

Графы с поддержкой восстановления

Каждый ресурс содержит сведения о событии изменения, например, о событии создания или удаления, которое произошло в Graph. Эта информация может быть полезна в сценариях, когда граф был изменен или удален и необходимо выяснить, когда произошло это событие.

Имя свойства	Описание
`eventTimestamp`	Время в формате UTC, когда произошло это событие коллекции.
`ownerId`	Имя коллекции Graph.
`ownerResourceId`	Идентификатор ресурса коллекции Graph.
`operationType`	Тип операции этого события коллекции.

Примечание

Возможные значения для operationType:

Create — событие создания Graph.
Delete — событие удаления Graph.
Replace — событие изменения Graph.
SystemOperation — событие изменения коллекции, активируемое системой. Это событие не инициируется пользователем.

Для получения списка всех изменений контейнера в одной базе данных, обратитесь к статье Графы с поддержкой восстановления — список.

Табличные ресурсы с поддержкой восстановления

Здесь перечислены все таблицы Azure Cosmos DB с поддержкой восстановления, доступные для определенной учетной записи базы данных в заданное время и в заданном расположении. Обратите внимание, что API для таблицы не указывает явную базу данных.

Имя свойства	Описание
`TableNames`	Список табличных контейнеров в этой учетной записи.

Полный список таблиц, существующих в учетной записи с заданной меткой времени и заданным расположением, приведен в статье Табличные ресурсы с поддержкой восстановления — список.

Таблица с поддержкой восстановления

Каждый ресурс содержит сведения о событии изменения, например, о событии создания или удаления, которое произошло в таблице. Эта информация может быть полезна в сценариях, когда таблица была изменена или удалена и необходимо выяснить, когда произошло это событие.

Имя свойства	Описание
`eventTimestamp`	Время в формате UTC, когда произошло событие базы данных.
`ownerId`	Имя табличной базы данных.
`ownerResourceId`	Идентификатор табличного ресурса.
`operationType`	Тип операции этого события, относящегося к таблице.

Примечание

Возможные значения для operationType:

Create — событие создания таблицы.
Delete — событие удаления таблицы.
Replace — событие изменения таблицы.
SystemOperation — событие изменения базы данных, активируемое системой. Это событие не инициируется пользователем

Для получения списка всех изменений таблицы в одной базе данных обратитесь к статье Таблица с поддержкой восстановления — список.

Дальнейшие действия

Обеспечьте непрерывное резервное копирование с помощью портала Azure, PowerShell, интерфейса командной строки или Azure Resource Manager.
Восстановление учетной записи с помощью портала Azure, PowerShell, CLI и Azure Resource Manager.
Переход на учетную запись с периодического резервного копирования на непрерывное.
Управление разрешениями для восстановления данных в режиме непрерывного резервного копирования.

Модель ресурсов для функции восстановления Azure Cosmos DB на определенный момент времени

Модель ресурсов учетной записи базы данных

BackupPolicy

CreateMode

RestoreParameters

Пример ресурса

Ресурсы с поддержкой восстановления

Учетная запись базы данных с поддержкой восстановления

Базы данных SQL с поддержкой восстановления

Контейнеры SQL с поддержкой восстановления

Ресурсы SQL с поддержкой восстановления

Базы данных MongoDB с поддержкой восстановления

Коллекция MongoDB с поддержкой восстановления

Ресурсы MongoDB с поддержкой восстановления

Ресурсы Graph с поддержкой восстановления

База данных Graph с поддержкой восстановления

Графы с поддержкой восстановления

Табличные ресурсы с поддержкой восстановления

Таблица с поддержкой восстановления

Дальнейшие действия

Дополнительные ресурсы