Exportar Snapshots de Backup em Nuvem

Observação

Este recurso não está disponível para clusters M0 grátis e clusters Flex. Para aprender mais sobre quais recursos não estão disponíveis, consulte Limites do Atlas M0 (cluster grátis).

O Atlas permite exportar seus snapshots do Cloud Backup para um serviço de armazenamento de objeto .

Para saber como gerenciar políticas e agendamentos de backup automatizado, consulte Gerenciar políticas de backup.

Serviços de armazenamento suportados

Atualmente, o Atlas oferece suporte aos seguintes serviços de armazenamento de objeto :

AWS Buckets S3
Armazenamento de blobs Azure
Buckets do Google Cloud Storage

Além disso, o Atlas oferece suporte à exportação de snapshots para AWS S3 buckets usando PrivateLink.

Como o Atlas exporta snapshots

Observação

Se você exportar backups para o Amazon Web Services S3, poderá ativar o bloqueio de objetos do Amazon Web Services S3 para garantir a imutabilidade dos seus arquivos de backup necessários para conformidade e segurança. As travas de objetos impedem exclusões e modificações de arquivos de backup exportados.

Você pode exportar manualmente snapshots individuais ou configurar uma política de exportação para exportação automática de seus snapshots. Para exportações automáticas, você deve especificar uma frequência em sua política de exportação:

Diariamente
Semanalmente
Por mês
Anual

O Atlas exporta automaticamente qualquer snapshot de backup com o tipo de frequência que corresponde à frequência de exportação. O resultado exportado é um backup completo desse snapshot.

Exemplo

Considere o seguinte:

Uma política de backup que define um cronograma semanal e mensal de captura de imagem
Uma política de exportação que define uma frequência de exportação mensal

Suponha que, no final do mês, os snapshots semanais e mensais aconteçam no mesmo dia. Haveria 4 snapshots dos quais 3 seriam semanais e o quarto snapshot, embora tratado como um snapshot semanal pelo Atlas, também seria o snapshot mensal porque aconteceu no mesmo dia. O Atlas exportará o snapshot mensal somente porque a frequência de exportação corresponde à frequência do snapshot para esse snapshot. Para exportar os snapshots semanais também, atualize a política de exportação para exportar snapshots semanais. Se a frequência de exportação for definida como semanal, o Atlas exportará todos os 4 snapshots.

À medida que a exportação avança, você poderá ver resultados parciais em seu serviço de armazenamento de objeto .

O Atlas persiste documentos em snapshots, independentemente das configurações de Time to Live. Você pode acessar esses documentos a partir do seu snapshot após o prazo de vida útil.

Para saber mais sobre os preços de exportação de snapshots, consulte Custos de exportação de snapshots.

Uploads de arquivos do Atlas

O Atlas carrega um arquivo vazio para /exported_snapshots/.permissioncheck quando você:

Adicionar um novo armazenamento de objeto para exportação
Iniciar uma exportação

Depois de concluir a exportação, o Atlas faz o upload de um arquivo de metadados chamado .complete e de um arquivo de metadados chamado metadata.json para cada coleção.

O Atlas carrega o arquivo de metadados chamado .complete no seguinte caminho em seu armazenamento de objeto :

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

Observação

Por padrão, o Atlas usa UUIDs de organização e projeto no caminho dos arquivos de metadados. Para usar nomes de organização e projeto em vez de UUIDs, defina a flag useOrgAndGroupNamesInExportPrefix como true via API. O Atlas substitui quaisquer espaços por underscores (_) e remove quaisquer caracteres que possam exigir tratamento especial e caracteres a serem evitados dos nomes da organização e do projeto no caminho.

O arquivo de metadados .complete está no formato JSON e contém os seguintes campos:

Campo	Descrição
`orgId`	Sequência exclusiva de 24 dígitos hexadecimais que identifica a organização Atlas.
`orgName`	Nome da organização Atlas.
`groupId`	Sequência exclusiva de 24 dígitos hexadecimais que identifica o projeto na organização Atlas.
`groupName`	Nome do projeto Atlas.
`clusterUniqueId`	Sequência exclusiva de 24 dígitos hexadecimais que identifica o cluster Atlas.
`clusterName`	Nome do projeto Atlas.
`snapshotInitiationDate`	Data em que o snapshot foi tirado.
`totalFiles`	Número total de arquivos carregados no armazenamento de objeto .
`labels`	Rótulos do cluster cujo snapshot foi exportado.
`customData`	Dados personalizados, se houver, especificados ao criar a tarefa de exportação.

Exemplo

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

O Atlas carrega o arquivo metadata.json para cada coleção no seguinte caminho em seu armazenamento de objeto :

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

Observação

Por padrão, o Atlas usa UUIDs de organização e projeto no caminho dos arquivos de metadados. Para usar nomes de organização e projeto em vez de UUIDs, defina a flag useOrgAndGroupNamesInExportPrefix como verdadeiro via a API. O Atlas substitui quaisquer espaços por sublinhados (_) e remove quaisquer caracteres que possam exigir manuseio especial e caracteres para evitar dos nomes de organização e projeto no caminho.

O arquivo de metadados está no formato JSON e contém os seguintes campos:

Campo	Descrição
`collectionName`	Etiqueta legível para humanos que identifica a collection.
`indexes`	Lista de todos os índices da coleção no formato retornado pelo comando db.collection.getIndexes.
`options`	Opções de configuração definidas na coleção. Para saber mais sobre as opções, consulte o comando db.createCollection().
`type`	(Opcional) Tipo de coleção. Este campo é suportado somente para coleções de séries temporais, com um valor de `timeseries`. Deixe este campo desmarcado para collections padrão. O Atlas não suporta a exportação de `view` coleções de tipo.
`uuid`	UUID da coleção. Para saber mais sobre o UUID, consulte UUID.

Exemplo

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

Se um trabalho de exportação falhar:

O Atlas não tenta exportar automaticamente novamente.
O Atlas não remove quaisquer dados parciais em seu armazenamento de objeto .

Formato de Dados Exportado

O Atlas gzipfaz o upload de documentos JSON2 estendidos (v) compactados. O Atlas não carrega esses documentos em ordem. A seguir está o caminho para os arquivos em seu armazenamento de objeto :

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

Onde:

`<orgName>`	Nome da sua organização Atlas.
`<projectName>`	Nome do seu projeto Atlas.
`<clusterName>`	Nome do seu agrupamento do Atlas.
`<initiationDateOfSnapshot>`	Data em que o snapshot foi tirado.
`<timestamp>`	Timestamp em que o trabalho de exportação foi criado.
`<dbName>`	Nome do banco de dados no Atlas cluster.
`<collectionName>`	Nome da collection Atlas.
`<shardName>`	Nome do conjunto de réplicas. Para coleções fragmentadas, este é o nome do fragmento primário.
`<increment>`	Contagem que é incrementada à medida que os chunks são carregados. Começa às `0`.

Limitações

Você não pode executar as seguintes ações:

Exporte snapshots substitutos.
Tenha mais de uma exportação ativa por snapshot.
Exporte collections de visualização ou collections do sistema , com exceção das <database>.system.js collections.
Exporte snapshots de clusters em um projeto Atlas com a Encryption at Rest com restrição de IP habilitada.
Exporte snapshots de clusters hospedados no Azure ou no Google Cloud armazenamento em projetos configurados para pontos de extremidade privados.

Acesso necessário

Para gerenciar seus snapshots do Cloud Backup, você deve ter Project Backup Manager ou Project Owner acesso ao projeto.

Os usuários com acesso Organization Owner devem se adicionar como Project Backup Manager ou Project Owner ao projeto antes de poderem gerenciar snapshots do Cloud Backup.

Gerenciamento de Exportação

Provedor de nuvem

Tipo de conexão

Interface

Voltar

Restaurar usando criptografia em repouso

Restaurar fontes