Modelo de recursos para la característica de restauración a un momento dado de Azure Cosmos DB
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 datosDelete
: evento de eliminación de base de datosReplace
: evento de modificación de base de datosSystemOperation
: 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 contenedorDelete
: evento de eliminación de contenedorReplace
: evento de modificación de contenedorSystemOperation
: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 datosDelete
: evento de eliminación de base de datosReplace
: evento de modificación de base de datosSystemOperation
: 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ónDelete
: evento de eliminación de colecciónReplace
: evento de modificación de colecciónSystemOperation
: 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 datosDelete
: evento de eliminación de base de datosReplace
: evento de modificación de base de datosSystemOperation
: 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 grafoDelete
: evento de eliminación del grafoReplace
: evento de modificación del grafoSystemOperation
: 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 tablaDelete
: evento de eliminación de la tablaReplace
: evento de modificación de la tablaSystemOperation
: 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.