> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-vortex-format.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Guia passo a passo para configurar o MongoDB Atlas como origem no ClickPipes

# Guia de configuração da origem MongoDB Atlas

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

<div id="enable-oplog-retention">
  ## Configurar a retenção do oplog
</div>

Uma retenção mínima do oplog de 24 horas é necessária para a replicação. Recomendamos definir a retenção do oplog para 72 horas ou mais, para garantir que o oplog não seja truncado antes da conclusão do snapshot inicial. Para definir a retenção do oplog pela UI:

1. Acesse a aba `Overview` do seu cluster no console do MongoDB Atlas e clique na aba `Configuration`.

<Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/Kj4wT80mHNH7Aczn/images/integrations/data-ingestion/clickpipes/mongodb/mongo-atlas-cluster-overview-configuration.webp?fit=max&auto=format&n=Kj4wT80mHNH7Aczn&q=85&s=590de7223aca3eb23a9ae25f8fe19436" alt="Acesse a configuração do cluster" size="lg" border width="2496" height="1094" data-path="images/integrations/data-ingestion/clickpipes/mongodb/mongo-atlas-cluster-overview-configuration.webp" />

2. Clique em `Additional Settings` e role a tela para baixo até `More Configuration Options`.

<Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/Kj4wT80mHNH7Aczn/images/integrations/data-ingestion/clickpipes/mongodb/mongo-atlas-expand-additional-settings.webp?fit=max&auto=format&n=Kj4wT80mHNH7Aczn&q=85&s=eb71c2f43b4728cdef7b8bf785f0c826" alt="Expanda as configurações adicionais" size="lg" border width="2106" height="1282" data-path="images/integrations/data-ingestion/clickpipes/mongodb/mongo-atlas-expand-additional-settings.webp" />

3. Clique em `More Configuration Options` e defina a janela mínima do oplog como `72 hours` ou mais.

<Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/Kj4wT80mHNH7Aczn/images/integrations/data-ingestion/clickpipes/mongodb/mongo-atlas-set-retention-hours.webp?fit=max&auto=format&n=Kj4wT80mHNH7Aczn&q=85&s=5f1900c74088162b3278648a4c7d7e6b" alt="Defina as horas de retenção do oplog" size="lg" border width="2102" height="894" data-path="images/integrations/data-ingestion/clickpipes/mongodb/mongo-atlas-set-retention-hours.webp" />

4. Clique em `Review Changes` para revisar as alterações e, em seguida, em `Apply Changes` para aplicá-las.

<div id="configure-database-user">
  ## Configurar um usuário de banco de dados
</div>

Depois de fazer login no console do MongoDB Atlas, clique em `Database Access` na aba Security, na barra de navegação à esquerda. Clique em "Add New Database User".

O ClickPipes exige autenticação por senha:

<Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/Kj4wT80mHNH7Aczn/images/integrations/data-ingestion/clickpipes/mongodb/mongo-atlas-add-new-database-user.webp?fit=max&auto=format&n=Kj4wT80mHNH7Aczn&q=85&s=f5fa5d1e4e874644bdd5de6b04f5ea0b" alt="Adicionar usuário de banco de dados" size="lg" border width="1846" height="1356" data-path="images/integrations/data-ingestion/clickpipes/mongodb/mongo-atlas-add-new-database-user.webp" />

O ClickPipes exige um usuário com as seguintes funções:

* `readAnyDatabase`
* `clusterMonitor`

Você pode encontrá-las na seção `Specific Privileges`:

<Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/Kj4wT80mHNH7Aczn/images/integrations/data-ingestion/clickpipes/mongodb/mongo-atlas-database-user-privilege.webp?fit=max&auto=format&n=Kj4wT80mHNH7Aczn&q=85&s=4ab3222615eeb38f8b95b5cd0b909f3b" alt="Configurar funções do usuário" size="lg" border width="1878" height="1020" data-path="images/integrations/data-ingestion/clickpipes/mongodb/mongo-atlas-database-user-privilege.webp" />

Também é possível especificar os clusters/instâncias aos quais você deseja conceder acesso ao usuário do ClickPipes:

<Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/Kj4wT80mHNH7Aczn/images/integrations/data-ingestion/clickpipes/mongodb/mongo-atlas-restrict-access.webp?fit=max&auto=format&n=Kj4wT80mHNH7Aczn&q=85&s=c6bb6dfa0f4d2a18cb38d65a33e631ed" alt="Restringir acesso a cluster/instância" size="lg" border width="1522" height="730" data-path="images/integrations/data-ingestion/clickpipes/mongodb/mongo-atlas-restrict-access.webp" />

<div id="whats-next">
  ## O que vem a seguir?
</div>

Agora você pode [criar seu ClickPipe](/pt-BR/integrations/clickpipes/mongodb/index) e começar a ingerir dados da sua instância do MongoDB no ClickHouse Cloud.
Anote os detalhes da conexão usados na configuração da sua instância do MongoDB, pois você precisará deles durante o processo de criação do ClickPipe.
