Модель ресурсов для функции восстановления Azure Cosmos DB на определенный момент времени
Область применения: 
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.
publicNetworkAccess
Это свойство должно иметь значение "Отключено", чтобы восстановить учетную запись без доступа к общедоступной сети. Если это свойство не предоставлено, восстановление учетной записи будет продолжаться с publicNetworkAccess как Enabled.
RestoreParameters
Ресурс RestoreParameters содержит сведения об операции восстановления, включая идентификатор учетной записи, время восстановления и ресурсы, которые необходимо восстановить.
| Имя свойства | Description |
|---|---|
restoreMode |
В качестве режима восстановления укажите PointInTime. |
restoreSource |
InstanceId исходной учетной записи, из которой будет выполнено восстановление. |
restoreTimestampInUtc |
Момент времени в формате UTC для восстановления учетной записи. |
databasesToRestore |
Список объектов DatabaseRestoreResource включает базы данных и контейнеры, которые требуется восстановить. Каждый ресурс представляет отдельную базу данных и все коллекции в этой базе данных. Дополнительные сведения см. в разделе Ресурсы SQL с возможностью восстановления. Если значение пустое, будет восстановлена вся учетная запись. |
gremlinDatabasesToRestore |
Список объектов GremlinDatabaseRestoreResource включает базы данных и графы, которые требуется восстановить. Каждый ресурс представляет отдельную базу данных и все графы в этой базе данных. Дополнительные сведения см. в разделе Ресурсы Gremlin с возможностью восстановления. Если значение пустое, будет восстановлена вся учетная запись. |
restoreWithTtlDisabled |
Логические значения флага (true/false) для отключения времени ожидания в восстановленной учетной записи после завершения восстановления. (предварительная версия) |
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/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
"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/*/readMicrosoft.DocumentDB/locations/restorableDatabaseAccounts/read
Учетная запись базы данных с поддержкой восстановления
Этот ресурс содержит экземпляр учетной записи базы данных, который можно восстановить. Учетная запись базы данных может быть удаленной или действующей. Она содержит сведения, позволяющие найти учетную запись исходной базы данных, которую требуется восстановить.
| Имя свойства | Description |
|---|---|
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. Эта информация может быть полезна в сценариях, где база данных была случайно удалена и необходимо выяснить, когда произошло это событие.
| Имя свойства | Description |
|---|---|
eventTimestamp |
Время создания или удаления базы данных в формате UTC. |
ownerId |
Имя базы данных SQL. |
ownerResourceId |
ИД ресурса базы данных SQL. |
operationType |
Тип операции этого события базы данных. |
database |
Свойства базы данных SQL на момент события. |
Примечание.
Возможные значения для operationType:
Create— событие создания базы данных.Delete— событие удаления базы данных.Replace— событие изменения базы данных.SystemOperation— событие изменения базы данных, активируемое системой. Это событие не инициируется пользователем
Чтобы получить список всех изменений базы данных, см. статью "Восстановление без База данных SQL- Список статей".
Контейнеры SQL с поддержкой восстановления
Каждый ресурс содержит сведения о событии изменения, например создании или удалении, которые произошли в контейнере SQL. Эта информация может быть полезна в сценариях, когда контейнер был изменен или удален и необходимо выяснить, когда произошло это событие.
| Имя свойства | Description |
|---|---|
eventTimestamp |
Время в формате UTC, когда произошло это событие контейнера. |
ownerId |
Имя контейнера SQL. |
ownerResourceId |
Имя контейнера SQL. |
operationType |
Тип операции этого события контейнера. |
container |
Свойства контейнера SQL на момент события. |
Примечание.
Возможные значения для operationType:
Create— событие создания контейнера.Delete— событие удаления контейнера.Replace— событие изменения контейнера.SystemOperation— событие изменения контейнера, активируемое системой. Это событие не инициируется пользователем
Чтобы получить список всех изменений контейнеров в одной базе данных, см. статью " Восстановление контейнеров NoSQL — список ".
Ресурсы SQL с поддержкой восстановления
Каждый ресурс представляет отдельную базу данных и все контейнеры в этой базе данных.
| Имя свойства | Description |
|---|---|
databaseName |
Имя базы данных SQL. |
collectionNames |
Список контейнеров SQL в этой базе данных. |
Чтобы получить список базы данных и контейнера SQL, которые существуют в учетной записи в заданной метке времени и расположении, см. статью " Восстановление ресурсов NoSQL — список ".
Базы данных MongoDB с поддержкой восстановления
Каждый ресурс содержит сведения о событии изменения, например создании или удалении, которые произошли в базе данных MongoDB. Эта информация может быть полезна в сценариях, когда база данных была случайно удалена и необходимо выяснить, когда произошло это событие.
| Имя свойства | Description |
|---|---|
eventTimestamp |
Время в формате UTC, когда произошло событие базы данных. |
ownerId |
Имя базы данных MongoDB. |
ownerResourceId |
ИД ресурса базы данных MongoDB. |
operationType |
Тип операции этого события базы данных. |
Примечание.
Возможные значения для operationType:
Create— событие создания базы данных.Delete— событие удаления базы данных.Replace— событие изменения базы данных.SystemOperation— событие изменения базы данных, активируемое системой. Это событие не инициируется пользователем
Чтобы получить список всех изменений базы данных, см. статью Базы данных MongoDB с поддержкой восстановления — список.
Коллекция MongoDB с поддержкой восстановления
Каждый ресурс содержит сведения о событии изменения, например создании или удалении, которые произошли в коллекции MongoDB. Эта информация может быть полезна в сценариях, где коллекция была изменена или удалена и необходимо выяснить, когда произошло это событие.
| Имя свойства | Description |
|---|---|
eventTimestamp |
Время в формате UTC, когда произошло это событие коллекции. |
ownerId |
Имя коллекции MongoDB. |
ownerResourceId |
ИД ресурса коллекции MongoDB. |
operationType |
Тип операции этого события коллекции. |
Примечание.
Возможные значения для operationType:
Create— событие создания коллекции.Delete— событие удаления коллекции.Replace— событие изменения коллекции.SystemOperation— событие изменения коллекции, активируемое системой. Это событие не инициируется пользователем
Чтобы получить список всех изменений контейнера в одной базе данных, см. статью Ресурсы MongoDB с поддержкой восстановления — список.
Ресурсы MongoDB с поддержкой восстановления
Каждый ресурс представляет отдельную базу данных и все коллекции в этой базе данных.
| Имя свойства | Description |
|---|---|
databaseName |
Имя базы данных MongoDB. |
collectionNames |
Список коллекций MongoDB в этой базе данных. |
Чтобы получить список всех сочетаний баз данных и коллекций MongoDB, существующих в учетной записи с заданной меткой времени и расположением, см. статью Ресурсы MongoDB с поддержкой восстановления — список.
Ресурсы Graph с поддержкой восстановления
Каждый ресурс представляет отдельную базу данных и все графы в этой базе данных.
| Имя свойства | Description |
|---|---|
gremlinDatabaseName |
Имя базы данных Graph. |
graphNames |
Список графов в этой базе данных. |
Для получения списка всех сочетаний баз данных Graph, существующих в учетной записи с заданной меткой времени и расположением, обратитесь к статье Ресурсы Gremlin с поддержкой восстановления — список.
База данных Graph с поддержкой восстановления
Каждый ресурс содержит сведения о событии изменения, например о событии создания или удаления, которое произошло в базе данных Graph. Эта информация может быть полезна в сценариях, когда база данных была случайно удалена и необходимо выяснить, когда произошло это событие.
| Имя свойства | Description |
|---|---|
eventTimestamp |
Время в формате UTC, когда произошло событие базы данных. |
ownerId |
Имя базы данных Graph. |
ownerResourceId |
Идентификатор ресурса базы данных Graph. |
operationType |
Тип операции этого события базы данных. |
Примечание.
Возможные значения для operationType:
Create— событие создания базы данных.Delete— событие удаления базы данных.Replace— событие изменения базы данных.SystemOperation— событие изменения базы данных, активируемое системой. Это событие не инициируется пользователем.
Веб-канал событий всех изменений в базе данных Gremlin описан в статье Базы данных Graph с возможностью восстановления — список.
Графы с поддержкой восстановления
Каждый ресурс содержит сведения о событии изменения, например, о событии создания или удаления, которое произошло в Graph. Эта информация может быть полезна в сценариях, когда граф был изменен или удален и необходимо выяснить, когда произошло это событие.
| Имя свойства | Description |
|---|---|
eventTimestamp |
Время в формате UTC, когда произошло это событие коллекции. |
ownerId |
Имя коллекции Graph. |
ownerResourceId |
Идентификатор ресурса коллекции Graph. |
operationType |
Тип операции этого события коллекции. |
Примечание.
Возможные значения для operationType:
Create— событие создания Graph.Delete— событие удаления Graph.Replace— событие изменения Graph.SystemOperation— событие изменения коллекции, активируемое системой. Это событие не инициируется пользователем.
Для получения списка всех изменений контейнера в одной базе данных, обратитесь к статье Графы с поддержкой восстановления — список.
Табличные ресурсы с поддержкой восстановления
Здесь перечислены все таблицы Azure Cosmos DB с поддержкой восстановления, доступные для определенной учетной записи базы данных в заданное время и в заданном расположении. Обратите внимание, что API для таблицы не указывает явную базу данных.
| Имя свойства | Description |
|---|---|
TableNames |
Список табличных контейнеров в этой учетной записи. |
Полный список таблиц, существующих в учетной записи с заданной меткой времени и заданным расположением, приведен в статье Табличные ресурсы с поддержкой восстановления — список.
Таблица с поддержкой восстановления
Каждый ресурс содержит сведения о событии изменения, например, о событии создания или удаления, которое произошло в таблице. Эта информация может быть полезна в сценариях, когда таблица была изменена или удалена и необходимо выяснить, когда произошло это событие.
| Имя свойства | Description |
|---|---|
eventTimestamp |
Время в формате UTC, когда произошло событие базы данных. |
ownerId |
Имя табличной базы данных. |
ownerResourceId |
Идентификатор табличного ресурса. |
operationType |
Тип операции этого события, относящегося к таблице. |
Примечание.
Возможные значения для operationType:
Create— событие создания таблицы.Delete— событие удаления таблицы.Replace— событие изменения таблицы.SystemOperation— событие изменения базы данных, активируемое системой. Это событие не инициируется пользователем
Для получения списка всех изменений таблицы в одной базе данных обратитесь к статье Таблица с поддержкой восстановления — список.
Следующие шаги
- Обеспечьте непрерывное резервное копирование с помощью портала Azure, PowerShell, интерфейса командной строки или Azure Resource Manager.
- Восстановление учетной записи с помощью портала Azure, PowerShell, CLI и Azure Resource Manager.
- Переход на учетную запись с периодического резервного копирования на непрерывное.
- Управление разрешениями для восстановления данных в режиме непрерывного резервного копирования