> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.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}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

<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-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/mongodb/mongo-atlas-cluster-overview-configuration.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=e4343ee8682a000fe4580869cf883a09" 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.png" />

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

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/mongodb/mongo-atlas-expand-additional-settings.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=f016c2176484c8fed81fb403dfbe11e1" 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.png" />

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-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/mongodb/mongo-atlas-set-retention-hours.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=378050c91cb5838e602fc00433e4f45a" 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.png" />

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-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/mongodb/mongo-atlas-add-new-database-user.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=606061d79e3e8d80ee544b1f74d1bca4" 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.png" />

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-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/mongodb/mongo-atlas-database-user-privilege.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=5bb9ed6dd77abc741dfe3e4978553ee3" 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.png" />

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-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/mongodb/mongo-atlas-restrict-access.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=f9880308eec331478c23820e8d830446" 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.png" />

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

Agora você pode [criar seu ClickPipe](/pt-BR/integrations/clickpipes/mongodb) 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.