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

  • Применяется к: ✅ NoSQL, ✅ MongoDB, ✅ Apache Gremlin, ✅ Table

В этой статье описывается модель ресурсов для функции восстановления 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 предоставляется в режиме предварительного просмотра.

Режим создания

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

доступ к публичной сети

Это свойство должно иметь значение "Отключено", чтобы восстановить учетную запись без доступа к общедоступной сети. Если это свойство не предоставлено, восстановление учетной записи будет осуществляться с 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/*/read
  • Microsoft.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 с поддержкой восстановления

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

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

Замечание

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

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

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

Контейнеры 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 Список графов в этой базе данных.

Для получения списка всех сочетаний баз данных и графов 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 — событие создания графа.
  • Delete — событие удаления графа.
  • Replace — событие изменения графа
  • SystemOperation — событие изменения коллекции, активируемое системой. Это событие не инициируется пользователем.

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

Ресурсы таблиц, подлежащие восстановлению

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

Название свойства Description
TableNames Список контейнеров таблиц в данной учетной записи.

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

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

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

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

Замечание

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

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

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

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

  • Last updated on