Exportar snapshot de copia de seguridad en la nube

Nota

Esta funcionalidad no está disponible para clústeres gratuitos ni flexibles. Para aprender más sobre qué funcionalidades no están disponibles, consulte 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

Actualmente, Atlas admite los siguientes servicios de almacenamiento de objetos:

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

Además, Atlas admite la exportación de instantáneas a AWS S3 buckets utilizando PrivateLink.

Cómo Atlas exporta instantáneas

Nota

Si exportas copias de seguridad a AWS S3, puedes habilitar Bloqueo de objetos AWS S3 para garantizar la inmutabilidad de tus archivos de copia de seguridad, requeridos para el cumplimiento normativo y la seguridad. Las bloqueos de objetos evitan la eliminación y modificación de archivos de copia de seguridad exportados.

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 copia de seguridad instantánea que tenga un tipo de frecuencia que coincida con la frecuencia de exportación. El resultado exportado es una copia de seguridad completa de esa snapshot.

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

Supón que, al final del mes, las snapshots semanales y mensuales ocurren el mismo día. Habría 4 instantáneas, de las cuales 3 serían instantáneas semanales, y la cuarta instantánea, aunque Atlas la trate como una instantánea semanal, también sería la instantánea mensual porque ocurre el mismo día. Atlas exportará solo 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, actualiza la política de exportación para exportar también instantáneas semanales. Si la frecuencia de exportación está configurada en semanal, Atlas exportará las 4 snapshots.

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

Atlas almacena documentos en snapshots independientemente de la configuración de Time to Live. Se puede acceder a estos documentos desde el snapshot una vez superado el plazo de Time to Live.

Para aprender sobre los precios de exportación de snapshots, consulta Costos de exportación de snapshots.

Subidas de archivos de Atlas

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

Agregue un nuevo almacen 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 sube el archivo de metadatos denominado .complete en la siguiente ruta de tu objeto store:

/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`	string ú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 aprender más sobre UUID, se puede consultar 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 se produce un error en una tarea de exportación:

Atlas no intenta exportar de nuevo automáticamente.
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 tu 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 set de réplicas. Para las colecciones particionadas, este es el nombre de la partición primaria.
`<increment>`	Conteo que aumenta a medida que se suben fragmentos. Comienza en `0`.

Limitaciones

No puedes realizar las siguientes acciones:

Exporta instantáneas de respaldo.
Tener más de una exportación activa por cada snapshot.
Exportar ver colecciones, o colecciones del sistema, con la excepción de las colecciones <database>.system.js.
Exporta instantáneas desde clústeres en un proyecto de Atlas con la función cifrado en reposo activada y restringida por IP.
Exporta snapshots a través de nodos privados (exportaciones privadas) para los clústeres de Azure o Google Cloud.

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 exportación

Proveedor de nube

Tipo de conexión

Interfaz

Volver

Restaurar usando cifrado en reposo

Restaurar fuentes