Exportar snapshot de copia de seguridad en la nube

Nota

Esta funcionalidad no está disponible para clústeres gratuitos ni flexibles. Para obtener más información sobre qué funcionalidades no están disponibles, consulta Límites del clúster gratuito de Atlas.

Atlas te permite exportar tus snapshots de copias de seguridad en la nube a un servicio de almacenamiento de objetos.

Para aprender a gestionar las políticas y los cronogramas de las copias de seguridad automáticas, consulte Gestione las políticas de copias de seguridad.

Servicios de almacenamiento compatibles

Atlas actualmente admite los siguientes servicios de almacenamiento de objetos:

AWS cubos S3
Azure Blob Storage
Buckets de almacenamiento de Google Cloud

Además, Atlas admite exportar snapshot a los AWS S3 buckets mediante PrivateLink.

Cómo Atlas exporta instantáneas

Nota

Si exporta copias de seguridad a AWS S,3 puede habilitar Bloqueo de objetos deAWS S para garantizar la inmutabilidad de sus archivos de copia de seguridad, requisito necesario para el cumplimiento normativo y la seguridad. Los bloqueos de objetos evitan la eliminación y modificación de los archivos de copia de seguridad exportados.3

Puedes exportar manualmente snapshots individuales o configurar una política de exportación para la exportación automática de tus snapshots. Para las exportaciones automáticas, debes especificar una frecuencia en tu política de exportación:

Diario
Semanal
Mensual
Anual

Atlas exporta automáticamente cualquier instantánea de copia de seguridad con la frecuencia que coincida con la frecuencia de exportación. El resultado exportado es una copia de seguridad completa de esa instantánea.

Ejemplo

Considere lo siguiente:

Una política de copia de seguridad que establece un cronograma semanal y mensual de snapshots.
Una política de exportación que establece una frecuencia de exportación mensual

Supongamos que al final del mes, las instantáneas semanales y mensuales ocurren el mismo día. Habría 4 snapshots de las cuales 3 serían snapshots semanales y la cuarta snapshot, aunque sea tratada como una snapshot semanal por Atlas, también sería la snapshot mensual porque ocurrió en el mismo día. Atlas exportará únicamente la snapshot mensual porque la frecuencia de exportación coincide con la frecuencia de la snapshot para esa snapshot. Para exportar también las instantáneas semanales, actualice la política de exportación para exportar también las instantáneas semanales. Si la frecuencia de exportación está configurada en semanal, Atlas exportará todas las instantáneas 4.

A medida que avanza la exportación, puede consultar resultados parciales en su servicio de almacenamiento de objetos.

Atlas conserva los documentos en instantáneas, independientemente de la configuración del tiempo de vida. Puede acceder a estos documentos desde su instantánea después de la fecha límite de vida.

Para obtener más información sobre los precios de exportación de instantáneas, consulte Costos de exportación de instantáneas.

Subidas de archivos de Atlas

Atlas carga un archivo vacío en /exported_snapshots/.permissioncheck cuando usted:

Agregar un nuevo almacén de objetos para exportar
Iniciar una exportación

Después de que Atlas termine de exportar, Atlas sube un archivo de metadatos llamado .complete y un archivo de metadatos llamado metadata.json para cada colección.

Atlas carga el archivo de metadatos llamado .complete en la siguiente ruta en su almacén de objetos:

/exported_snapshots/<orgUUID>/<projectUUID>/<clusterName>/<initiationDateOfSnapshot>/<timestamp>/

Nota

De forma por defecto, Atlas utiliza los UUID de organización y proyecto en la ruta de los archivos de metadatos. Para utilizar los nombres de organizaciones y proyectos en lugar de UUIDs, configure la bandera useOrgAndGroupNamesInExportPrefix en true a través de la API. Atlas reemplaza cualquier espacio con guiones bajos (_) y remueve cualquier caracteres que puedan requerir un tratamiento especial y caracteres a evitar de los nombres de la organización y del Proyecto en la ruta.

El archivo de metadatos .complete está en formato JSON y contiene los siguientes campos:

Campo	Descripción
`orgId`	Secuencia única de 24 dígitos hexadecimales que identifica la organización Atlas.
`orgName`	Nombre de la organización de Atlas.
`groupId`	Cadena única de 24 dígitos hexadecimales que identifica el proyecto en la organización Atlas.
`groupName`	Nombre del proyecto de Atlas.
`clusterUniqueId`	string única de 24 dígitos hexadecimales que identifica el clúster de Atlas.
`clusterName`	Nombre del proyecto de Atlas.
`snapshotInitiationDate`	Fecha en que se tomó la snapshot.
`totalFiles`	Número total de archivos cargados en el almacén de objetos.
`labels`	Etiquetas del clúster cuya instantánea fue exportada.
`customData`	Datos personalizados, en su caso, que usted haya especificado al crear la tarea de exportación.

Ejemplo

{
  "orgId": "60512d6f65e4047fe0842095",
  "orgName": "org1",
  "groupId": "60512dac65e4047fe084220f",
  "groupName": "group1",
  "clusterUniqueId": "60512dac65e4047fe0842212",
  "clusterName": "cluster0",
  "snapshotInitiationDate": "2020-04-03T05:50:29.321Z"
  "totalFiles": 23,
  "labels": [
    {
      "key": "key1",
      "value": "xyz"
    },
    {
      "key": "key2",
      "value": "xyzuio"
    }
  ],
  "customData": [
    {
      "key": "key1",
      "value": "xyz"
    },
    {
      "key": "key2",
      "value": "xyzuio"
    }
  ]
}

Atlas sube el archivo metadata.json para cada colección en la siguiente ruta de su almacén de objetos:

/exported_snapshots/<orgUUID>/<projectUUID>/<clusterName>/<initiationDateOfSnapshot>/<timestamp>/<dbName>/<collectionName>/metadata.json

Nota

De forma por defecto, Atlas utiliza los UUID de organización y proyecto en la ruta de los archivos de metadatos. Para usar nombres de organización y proyecto en lugar de UUID, establece el flag useOrgAndGroupNamesInExportPrefix a través de la API en true. Atlas reemplaza cualquier espacio con guiones bajos (_) y remueve cualquier carácter que pueda requerir un manejo especial y caracteres a evitar de los nombres de la organización y del Proyecto en la ruta.

El archivo de metadatos está en formato JSON y contiene los siguientes campos:

Campo	Descripción
`collectionName`	Etiqueta legible por humanos que identifica la colección.
`indexes`	Lista de todos los índices en la colección en el formato devuelto por el comando db.collection.getIndexes.
`options`	Opciones de configuración definidas en la colección. Para aprender más sobre las opciones, consulta el comando db.createCollection().
`type`	(Opcional) Tipo de colección. Este campo sólo se admite para colección de series de tiempo, con un valor de `timeseries`. Deja este campo sin configurar para las colecciones estándar. Atlas no admite la exportación de colecciones de tipo `view`.
`uuid`	UUID de la colección. Para obtener más información sobre UUID,consulte UUID.

Ejemplo

{
  "options":{
    "viewOn":"othercol",
    "pipeline":[{"$project":{"namez":"$name"}}]
  },
  "indexes":[],
  "collectionName":"viewcol",
  "type":"view"
}

{
  "options":{
    "timeseries":{
      "timeField":"timestamp",
      "granularity":"seconds",
      "bucketMaxSpanSeconds":{"$numberInt":"3600"}
    }
  },
  "indexes":[],
  "collectionName":"timeseriescol",
  "type":"timeseries"
}

{
  "indexes": [
    {
      "v":{"$numberInt":"2"},
      "key":{
        "_id":{"$numberInt":"1"}
      },
      "name":"_id_"
    }
  ],
  "uuid":"342c40a937c34c478bab03de8ce44f3e",
  "collectionName":"somecol"
}

Si falla un trabajo de exportación:

Atlas no intenta exportar nuevamente de manera automática.
Atlas no remueve ningún dato parcial en su almacenamiento de objetos.

Formato de datos exportados

Atlas sube los documentos JSON extendido (v2) comprimidos con gzip. Atlas no sube estos documentos en orden. La siguiente es la ruta a los archivos en su almacenamiento de objetos:

/exported_snapshots/<orgName>/<projectName>/<clusterName>/<initiationDateOfSnapshot>/<timestamp>/<dbName>/<collectionName>/<shardName>.<increment>.json.gz

Dónde:

`<orgName>`	Nombre de tu organización en Atlas.
`<projectName>`	Nombre de su proyecto Atlas.
`<clusterName>`	Nombre de tu clúster Atlas.
`<initiationDateOfSnapshot>`	Fecha en que se tomó la snapshot.
`<timestamp>`	Marca de tiempo cuando se creó la tarea de exportación.
`<dbName>`	Nombre de la base de datos en el clúster Atlas.
`<collectionName>`	Nombre de la colección Atlas.
`<shardName>`	Nombre del conjunto de réplicas. En el caso de colecciones fragmentadas, este es el nombre del fragmento principal.
`<increment>`	Conteo que aumenta a medida que se suben fragmentos. Comienza en `0`.

Limitaciones

No puedes realizar las siguientes acciones:

Exportar instantáneas de respaldo.
Tener más de una exportación activa por cada snapshot.
Exportar colecciones de vistas o colecciones del sistema, con excepción de <database>.system.js colecciones.
Exporta instantáneas desde clústeres en un proyecto de Atlas con la función cifrado en reposo activada y restringida por IP.
Exporte instantáneas de clústeres alojados en Azure o Google Cloud Storage en proyectos configurados para puntos de conexión privados.

Acceso requerido

Para gestionar tus snapshots de copias de seguridad en la nube, debes tener Project Backup Manager o Project Owner acceso al Proyecto.

Los usuarios con Organization Owner acceso deben añadirse como Project Backup Manager o Project Owner al proyecto antes de poder gestionar instantáneas de copias de seguridad en la nube.

Para descargar y exportar snapshot de Cloud Backup, debe tener Project Backup Export Operator acceso al Proyecto.

Requisitos previos

Gestión de exportaciones

Proveedor de nube

Tipo de conexión

Interfaz

Volver

Restaurar usando cifrado en reposo

Restaurar fuentes