Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.
Menu Docs

Exportar snapshots de backup em nuvem para armazenamento de objetos

Observação

Esta funcionalidade não está disponível para clusters gratuitos e clusters flexíveis. Para aprender mais sobre quais recursos não estão disponíveis, consulte Limites de cluster gratuito do Atlas.

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

Para aprender como restaurar um snapshot exportado de volta para um cluster Atlas, consulte Importar snapshots arquivados para o Atlas.

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

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 utilizando PrivateLink.

Você pode exportar manualmente snapshots individuais ou configurar uma política de exportação para exportação automática de seus snapshots. Para etapas específicas do seu serviço de armazenamento de objetos, consulte a página de exportação do seu provedor de nuvem.

Para configurar exportações automáticas, adicione uma política de exportação ao seu agendamento de backups em nuvem e defina seu tipo de frequência como daily, weekly, monthly ou yearly. Quando um item de política de backup com o mesmo tipo de frequência cria um snapshot, o Atlas exporta esse snapshot para o armazenamento de objetos especificado.

O Atlas carrega um arquivo vazio para o caminho /exported_snapshots/.permissioncheck em seu armazenamento de objeto quando você adiciona um novo armazenamento de objeto para exportação e quando você inicia uma exportação. À 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.

Cada tarefa de exportação de snapshot de backups em nuvem carrega os dados do snapshot para o armazenamento de objetos em documentos JSON estendido v2 compactados com gzip. Esses arquivos não são carregados em nenhuma ordem específica. Cada arquivo contém uma parte de documentos de uma única coleção no snapshot. Para clusters sharded, o Atlas cria uma tarefa de exportação separada por conjunto de réplicas (shard) e especifica o nome do conjunto de réplicas no caminho dos arquivos carregados.

Importante

À medida que a exportação avança, você poderá ver resultados parciais em seu serviço de armazenamento de objeto . 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 .

O Atlas carrega cada arquivo de dados para o seguinte caminho em seu armazenamento de objeto:

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

O Atlas substitui cada espaço reservado no caminho por estes valores:

<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.

Depois que o Atlas concluir a exportação dos dados do snapshot para o armazenamento de objetos, o Atlas também fará o upload de um arquivo de metadados chamado .complete e de um arquivo de metadados chamado metadata.json para cada coleção:

Arquivo de metadados exportado que contém informações sobre a tarefa de exportação e o snapshot exportado.

Para cada coleção na tarefa de exportação de snapshot, o Atlas carrega um arquivo de metadados chamado .complete para o 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 do corpo da solicitação
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"
}
]
}

Arquivo de metadados exportado que contém informações sobre a coleção exportada, incluindo seus índices e opções.

Para cada coleção na tarefa de exportação de snapshot, o Atlas carrega um arquivo de metadados chamado metadata.json para o 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 do corpo da solicitação
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"
}

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

  • Para criar ou gerenciar um agendamento de exportação do backups em nuvem ou configurar um bucket de exportação do backups em nuvem no Atlas, você deve ter Project Backup Manager ou Project Owner para o projeto.

  • Para criar ou gerenciar uma tarefa de exportação de backup em nuvem, você deve ter acesso Project Backup Export Operator ou Project Owner ao projeto.

  • Para criar ou gerenciar um endpoint privado de armazenamento de objeto dos backups em nuvem, você deve ter Project Owner acesso ao projeto.

As etapas para exportar snapshots de backups em nuvem dependem do seu serviço de armazenamento de objeto . Para configurar o acesso do Atlas, configurar um bucket de exportação e exportar snapshots, consulte a página do seu provedor de nuvem:

Exporte snapshots para buckets AWS S3, inclusive por PrivateLink.

Amazon Web Services S3

Exporte snapshots para contêineres do Azure Blob Storage.

Armazenamento de blobs Azure

Exportar snapshots para buckets do Google Cloud Armazenamento.

Google Cloud Platform Armazenamento do Google Cloud Platform