Modelo de recursos para la característica de restauración a un momento dado de Azure Cosmos DB

Artículo
08/15/2024

SE APLICA A: NoSQL MongoDB Gremlin Table

En este artículo se explica el modelo de recursos para la característica de restauración a un momento dado de Azure Cosmos DB. Se explican los parámetros que admiten los recursos y la copia de seguridad continua que se pueden restaurar. Esta característica se admite en la API de Azure Cosmos DB para SQL, la API de Azure Cosmos DB para Gremlin, la API de Table y la API de Azure Cosmos DB para MongoDB.

Modelo de recursos de la cuenta de base de datos

El modelo de recursos de la cuenta de base de datos se actualiza con algunas propiedades adicionales a fin de admitir los escenarios de restauración nuevos. Dichas propiedades son BackupPolicy, CreateMode y RestoreParameters.

BackupPolicy

Una propiedad nueva en la directiva de copia de seguridad en el nivel de la cuenta denominada Type bajo el parámetro backuppolicy habilita la copia de seguridad continua y la restauración a un momento dado. Este modo se conoce como copia de seguridad continua. Se puede establecer este modo al crear la cuenta o al migrar una cuenta de modo periódico a continuo. Una vez habilitado el modo continuo, todos los contenedores y las bases de datos que se creen en esta cuenta tendrán habilitadas copia de seguridad continua y restauración a un momento dado de manera predeterminada. El nivel de copia de seguridad continua se puede establecer en Continuous7Days o Continuous30Days. De forma predeterminada, si no se proporciona ningún nivel, Continuous30Days se aplica en la cuenta.

Nota:

Actualmente, la característica de restauración a un momento dado está disponible para las cuentas de Azure Cosmos DB for NoSQL, la API de MongoDB, Table y Gremlin. Después de crear una cuenta con el modo continuo, no se puede cambiar a un modo periódico. El nivel Continuous7Days está en versión preliminar.

CreateMode

Esta propiedad indica cómo se creó la cuenta. Los valores posibles son Default y Restore. Para realizar una restauración, establezca este valor en Restore y proporcione los valores adecuados en la propiedad RestoreParameters.

publicNetworkAccess

Esta propiedad debe establecerse en "Deshabilitada" para restaurar la cuenta sin acceso a la red pública. Si no se proporciona esta propiedad, la restauración de la cuenta continuará con publicNetworkAccess como Enabled.

RestoreParameters

El recurso RestoreParameters contiene los detalles de la operación de restauración, los que incluyen el id. de la cuenta, la hora a la que realizar la restauración y los recursos que se deben restaurar.

Nombre de la propiedad	Descripción
`restoreMode`	El modo de restauración debe ser `PointInTime`.
`restoreSource`	El id. de instancia de la cuenta de origen desde la que se iniciará la restauración.
`restoreTimestampInUtc`	Momento dado en UTC para restaurar la cuenta.
`databasesToRestore`	Lista de objetos `DatabaseRestoreResource` para especifica qué bases de datos y contenedores se deben restaurar. Cada recurso representa una base de datos única y todas las colecciones de esa base de datos. Para obtener más información, consulte Recursos SQL restaurables. Si este valor está vacío, se restaura toda la cuenta.
`gremlinDatabasesToRestore`	Lista de objetos `GremlinDatabaseRestoreResource` para especificar qué bases de datos y grafos se deben restaurar. Cada recurso representa una base de datos única y todos los grafos de esa base de datos. Para más información, consulte Recursos de Gremlin restaurables. Si este valor está vacío, se restaura toda la cuenta.
`restoreWithTtlDisabled`	valores de marca booleana (true/false) para deshabilitar el período de vida en la cuenta restaurada tras la finalización de la restauración. (versión preliminar)
`tablesToRestore`	Lista de objetos `TableRestoreResource` para especificar qué tablas se deben restaurar. Cada recurso representa una tabla en esa base de datos. Para obtener más información, consulte Recursos de tabla restaurables. Si este valor está vacío, se restaura toda la cuenta.

Recurso de ejemplo

El JSON siguiente es un recurso de cuenta de base de datos de ejemplo con copia de seguridad continua habilitada:

{
  "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"
      ...
    }
  }
}

Recursos que se pueden restaurar

Hay disponible un conjunto de nuevos recursos y de API para ayudarle a descubrir información crítica sobre los recursos, como por ejemplo:

Dónde se pueden restaurar los recursos
Ubicaciones desde las que se pueden restaurar los recursos
Marcas de tiempo en las que se realizaron operaciones clave en estos recursos.

Nota:

Todas las API que se usan para enumerar estos recursos requieren los permisos siguientes:

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

Cuenta de base de datos que se puede restaurar

Este recurso contiene una instancia de cuenta de base de datos que se puede restaurar. La cuenta de base de datos puede ser una cuenta eliminada o activa. Contiene información que permite encontrar la cuenta de base de datos de origen que desea restaurar.

Nombre de la propiedad	Descripción
`ID`	Identificador único del recurso.
`accountName`	Nombre de la cuenta de base de datos global.
`creationTime`	Hora UTC a la que se creó o migró la cuenta.
`deletionTime`	Hora UTC a la que se eliminó la cuenta. Este valor está vacío si la cuenta está activa.
`apiType`	Tipo de API de la cuenta de Azure Cosmos DB.
`restorableLocations`	Lista de las ubicaciones en las que existía la cuenta.
`restorableLocations: locationName`	Nombre de la región de la cuenta regional.
`restorableLocations: regionalDatabaseAccountInstanceId`	GUID de la cuenta regional.
`restorableLocations: creationTime`	Hora UTC a la que se creó o migró la cuenta regional.
`restorableLocations: deletionTime`	Hora UTC a la que se eliminó la cuenta regional. Este valor está vacío si la cuenta regional está activa.
`OldestRestorableTimeStamp`	La hora más temprana en UTC a la que se puede realizar la restauración. Para el nivel de 30 días, corresponde a un máximo de 30 días desde ahora y para el nivel de 7 días, corresponde a un máximo de 7 días desde ahora.

Si quiere ver una lista de todas las cuentas que se pueden restaurar, consulte los artículos Cuentas de base de datos que se pueden restaurar: lista o Cuentas de base de datos que se pueden restaurar: lista por ubicación.

Base de datos SQL que se puede restaurar

Cada recurso contiene información de un evento de mutación, como su creación y eliminación, que se produjo en la base de datos SQL. Esta información puede ayudar en escenarios en los que la base de datos se eliminó de manera accidental y si es necesario averiguar cuándo se produjo ese evento.

Nombre de la propiedad	Descripción
`eventTimestamp`	Hora UTC a la que se creó o eliminó la base de datos.
`ownerId`	Nombre de la base de datos SQL.
`ownerResourceId`	El id. de recurso de la base de datos SQL.
`operationType`	Tipo de operación de este evento de base de datos.
`database`	Propiedades de la base de datos SQL en el momento del evento.

Nota:

Entre los posibles valores para operationType, hay:

Create: evento de creación de base de datos
Delete: evento de eliminación de base de datos
Replace: evento de modificación de base de datos
SystemOperation: evento de modificación de base de datos desencadenado por el sistema. No es el usuario quien inicia este evento

Si quiere ver una lista de todas las mutaciones de base de datos, consulte el artículo Bases de datos NoSQL que se pueden restaurar: lista.

Contenedor SQL que se puede restaurar

Cada recurso contiene información de un evento de mutación, como su creación y eliminación, que se produjo en el contenedor SQL. Esta información puede ayudar en escenarios en los que se modificó o eliminó el contenedor y si es necesario averiguar cuándo se produjo ese evento.

Nombre de la propiedad	Descripción
`eventTimestamp`	Hora UTC a la que se produjo este evento de contenedor.
`ownerId`	Nombre del contenedor SQL.
`ownerResourceId`	Identificador de recurso del contenedor SQL.
`operationType`	Tipo de operación de este evento de contenedor.
`container`	Propiedades del contenedor SQL en el momento del evento.

Nota:

Entre los posibles valores para operationType, hay:

Create: evento de creación de contenedor
Delete: evento de eliminación de contenedor
Replace: evento de modificación de contenedor
SystemOperation:evento de modificación de contenedor desencadenado por el sistema. No es el usuario quien inicia este evento

Si quiere ver una lista de todas las mutaciones de contenedor en la misma base de datos, consulte el artículo Contenedores NoSQL que se pueden restaurar: lista.

Recursos SQL que se pueden restaurar

Cada recurso representa una base de datos única y todos los contenedores de esa base de datos.

Nombre de la propiedad	Descripción
`databaseName`	Nombre de la base de datos SQL.
`collectionNames`	Lista de los contenedores SQL de esta base de datos.

Si quiere ver una lista de las combinaciones de base de datos y contenedor SQL que existen en la cuenta en una marca de tiempo y ubicación determinadas, consulte el artículo Recursos NoSQL que se pueden restaurar: lista.

Base de datos MongoDB que se puede restaurar

Cada recurso contiene información de un evento de mutación, como su creación y eliminación, que se produjo en la base de datos MongoDB. Esta información puede ayudar en el escenario en el que la base de datos se eliminó de manera accidental y el usuario necesita averiguar cuándo se produjo ese evento.

Nombre de la propiedad	Descripción
`eventTimestamp`	Hora UTC a la que se produjo este evento de base de datos.
`ownerId`	Nombre de la base de datos MongoDB.
`ownerResourceId`	Identificador de recurso de la base de datos MongoDB.
`operationType`	Tipo de operación de este evento de base de datos.

Nota:

Entre los posibles valores para operationType, hay:

Create: evento de creación de base de datos
Delete: evento de eliminación de base de datos
Replace: evento de modificación de base de datos
SystemOperation: evento de modificación de base de datos desencadenado por el sistema. No es el usuario quien inicia este evento

Si quiere ver una lista de todas las mutaciones de base de datos, consulte el artículo Bases de datos MongoDB que se pueden restaurar: lista.

Colección de MongoDB que se puede restaurar

Cada recurso contiene información de un evento de mutación, como su creación y eliminación, que se produjo en la colección de MongoDB. Esta información puede ayudar en escenarios en los que se modificó o eliminó la colección y si el usuario necesita averiguar cuándo se produjo ese evento.

Nombre de la propiedad	Descripción
`eventTimestamp`	Hora UTC a la que se produjo este evento de colección.
`ownerId`	Nombre de la colección de MongoDB.
`ownerResourceId`	Identificador de recurso de la colección de MongoDB.
`operationType`	Tipo de operación de este evento de colección.

Nota:

Entre los posibles valores para operationType, hay:

Create: evento de creación de colección
Delete: evento de eliminación de colección
Replace: evento de modificación de colección
SystemOperation: evento de modificación de contenedor desencadenado por el sistema. No es el usuario quien inicia este evento

Si quiere ver una lista de todas las mutaciones de contenedor en la misma base de datos, consulte Recursos de MongoDB que se pueden restaurar: lista.

Recursos de MongoDB que se pueden restaurar

Cada recurso representa una base de datos única y todas las colecciones de esa base de datos.

Nombre de la propiedad	Descripción
`databaseName`	Nombre de la base de datos MongoDB.
`collectionNames`	Lista de las colecciones de MongoDB en esta base de datos.

Si quiere ver una lista de las combinaciones de base de datos y colección de MongoDB que existen en la cuenta en una marca de tiempo y ubicación determinadas, consulte Recursos MongoDB que se pueden restaurar: lista.

Recursos de grafo que se pueden restaurar

Cada recurso representa una base de datos única y todos los grafos de esa base de datos.

Nombre de propiedad	Descripción
`gremlinDatabaseName`	Nombre de la base de datos de grafos.
`graphNames`	Lista de grafos de esta base de datos.

Si quiere ver una lista de las combinaciones de base de datos y grafos de Gremlin que existen en la cuenta en una marca de tiempo y ubicación determinadas, consulte el artículo Restorable Graph Resources - List.

Base de datos de grafos que se puede restaurar

Cada recurso contiene información sobre un evento de mutación, como su creación y eliminación, que se produjo en la base de datos de grafos. Esta información puede ayudar en el escenario en el que la base de datos se eliminó de manera accidental y el usuario necesita averiguar cuándo se produjo ese evento.

Nombre de la propiedad	Descripción
`eventTimestamp`	Hora UTC a la que se produjo este evento de base de datos.
`ownerId`	Nombre de la base de datos de grafos.
`ownerResourceId`	Identificador de recurso de la base de datos de grafos.
`operationType`	Tipo de operación de este evento de base de datos.

Nota:

Entre los posibles valores para operationType, hay:

Create: evento de creación de base de datos
Delete: evento de eliminación de base de datos
Replace: evento de modificación de base de datos
SystemOperation: evento de modificación de base de datos desencadenado por el sistema. No es el usuario quien inicia este evento.

Para obtener una fuente de eventos de todas las mutaciones de la base de datos de Gremlin, consulte Bases de datos de grafos que se pueden restaurar: lista.

Grafos que se pueden restaurar

Cada recurso contiene información de un evento de mutación, como su creación y eliminación, que se produjo en el grafo. Esta información puede ayudar en escenarios en los que se modificó o eliminó el grafo y si es necesario averiguar cuándo se produjo ese evento.

Nombre de propiedad	Descripción
`eventTimestamp`	Hora UTC a la que se produjo este evento de colección.
`ownerId`	Nombre de la colección de grafos.
`ownerResourceId`	Identificador de recurso de la colección de grafos.
`operationType`	Tipo de operación de este evento de colección.

Nota:

Entre los posibles valores para operationType, hay:

Create: evento de creación del grafo
Delete: evento de eliminación del grafo
Replace: evento de modificación del grafo
SystemOperation: evento de modificación de contenedor desencadenado por el sistema. No es el usuario quien inicia este evento.

Si quiere ver una lista de todas las mutaciones de contenedor en la misma base de datos, consulte el artículo Restorable Graphs - List.

Recursos de tabla que se pueden restaurar

Enumera todas las tablas disponibles de Azure Cosmos DB que se pueden restaurar para una cuenta de base de datos específica en una ubicación y un momento determinados. Tenga en cuenta que la API de Table no especifica una base de datos explícita.

Nombre de propiedad	Descripción
`TableNames`	Lista de los contenedores de tablas de esta cuenta.

Si quiere ver una lista de las tablas que existen en la cuenta en una marca de tiempo y ubicación determinadas, consulte el artículo Restorable Table Resources - List.

Tabla que se puede restaurar

Cada recurso contiene información de un evento de mutación, como su creación y eliminación, que se produjo en la tabla. Esta información puede ayudar en escenarios en los que se modificó o eliminó la tabla y si es necesario averiguar cuándo se produjo ese evento.

Nombre de propiedad	Descripción
`eventTimestamp`	Hora UTC a la que se produjo este evento de base de datos.
`ownerId`	Nombre de la base de datos de tabla.
`ownerResourceId`	Identificador del recurso de tabla.
`operationType`	Tipo de operación de este evento de tabla.

Nota:

Entre los posibles valores para operationType, hay:

Create: evento de creación de la tabla
Delete: evento de eliminación de la tabla
Replace: evento de modificación de la tabla
SystemOperation: evento de modificación de base de datos desencadenado por el sistema. No es el usuario quien inicia este evento

Si quiere ver una lista de todas las mutaciones de tabla en la misma base de datos, consulte el artículo Restorable Table - List.

Pasos siguientes

Aprovisione la copia de seguridad continua mediante Azure Portal, PowerShell, la CLI o Azure Resource Manager.
Restaure una cuenta mediante Azure Portal, PowerShell, la CLI o Azure Resource Manager.
Realice la migración a una cuenta desde una copia de seguridad periódica a una copia de seguridad continua.
Administre los permisos necesarios para restaurar datos con el modo de copia de seguridad continua.

Compartir a través de

Modelo de recursos para la característica de restauración a un momento dado de Azure Cosmos DB

Modelo de recursos de la cuenta de base de datos

BackupPolicy

CreateMode

publicNetworkAccess

RestoreParameters

Recurso de ejemplo

Recursos que se pueden restaurar

Cuenta de base de datos que se puede restaurar

Base de datos SQL que se puede restaurar

Contenedor SQL que se puede restaurar

Recursos SQL que se pueden restaurar

Base de datos MongoDB que se puede restaurar

Colección de MongoDB que se puede restaurar

Recursos de MongoDB que se pueden restaurar

Recursos de grafo que se pueden restaurar

Base de datos de grafos que se puede restaurar

Grafos que se pueden restaurar

Recursos de tabla que se pueden restaurar

Tabla que se puede restaurar

Pasos siguientes

Comentarios

Recursos adicionales