Exportar instantánea de copia de seguridad en la nube

Nota

Esta función no está disponible para M0 Clústeres gratuitos y clústeres Flex. Para obtener más información sobre las funciones que no están disponibles, consulte Límites de Atlas M0 (clúster libre).

Atlas le permite exportar sus instantáneas de copia de seguridad en la nube a un servicio de almacenamiento de objetos.

Para saber cómo administrar políticas y programaciones de copias de seguridad automatizadas, consulte Administrar políticas de copia de seguridad.

Servicios de almacenamiento compatibles

Atlas actualmente admite los siguientes servicios de almacenamiento de objetos:

AWS CubosS3
Almacenamiento de blobs de Azure
Depósitos de Google Cloud Storage

Además, Atlas admite la exportación de instantáneas a buckets de AWS S3 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 respaldo que establece un programa de instantáneas semanal y mensual
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, es posible que vea 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.

Archivos Atlas Uploads

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

Una vez que Atlas termina de exportar, carga 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 predeterminada, 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, configure el useOrgAndGroupNamesInExportPrefix indicador en true mediante la API. Atlas reemplaza los espacios con_ guiones bajos () y elimina los caracteres que requieran un manejo especial y los caracteres que se deben evitar en los nombres de organización y proyecto de la ruta.

El .complete archivo de metadatos 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 Atlas.
`groupId`	Cadena de dígitos hexadecimales 24única que identifica el proyecto en la organización Atlas.
`groupName`	Nombre del proyecto de Atlas.
`clusterUniqueId`	Cadena de dígitos hexadecimales 24única que identifica el clúster Atlas.
`clusterName`	Nombre del proyecto de Atlas.
`snapshotInitiationDate`	Fecha en que se tomó la instantánea.
`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, si los hay, que especificó al crear el trabajo 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 carga el archivo metadata.json para cada colección en la siguiente ruta en su almacén de objetos:

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

Nota

De forma predeterminada, 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, configure useOrgAndGroupNamesInExportPrefix el indicador en la API como verdadero. Atlas reemplaza los espacios con_ guiones bajos () y elimina los caracteres que requieran un manejo especial y los caracteres que se deben evitar en los nombres de organización y proyecto de 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 de 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 solo se admite para colecciones de series temporales con un valor de `timeseries`. No configure este campo para 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 carga gzip documentos JSON Extendido2 (v) comprimidos. Atlas no carga estos documentos en orden. La siguiente es la ruta a los archivos en su almacén de objetos:

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

Donde:

`<orgName>`	Nombre de tu organización en Atlas.
`<projectName>`	Nombre de su proyecto Atlas.
`<clusterName>`	Nombre de su clúster Atlas.
`<initiationDateOfSnapshot>`	Fecha en que se tomó la instantánea.
`<timestamp>`	Marca de tiempo cuando se creó el trabajo 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>`	Recuento que se incrementa a medida que se cargan 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 instantánea.
Exportar colecciones de vistas o colecciones del sistema, con excepción de <database>.system.js colecciones.
Exporte instantáneas de clústeres en un proyecto Atlas con cifrado en reposo restringido por IP habilitado.
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 administrar sus instantáneas de Cloud Backup, debe Project Backup Manager tener o Project Owner acceso al proyecto.

Los usuarios con acceso deben agregarse Organization Owner como Project Backup Manager o Project Owner al proyecto antes de poder administrar instantáneas de Cloud Backup.

Para descargar y exportar instantáneas de Cloud Backup, debe tener acceso al Project Backup Export Operator proyecto.

Requisitos previos

Gestión de exportaciones

Proveedor de nube

Tipo de conexión

Interfaz

Volver

Restaurar usando cifrado en reposo

Restaurar fuentes