> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/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/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/mongodb/mongo-atlas-cluster-overview-configuration.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=3ac8c5cc4cb73d7e38f719bbc966a13f" 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/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/mongodb/mongo-atlas-expand-additional-settings.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=150443728c29ef21fddb6d98224c9ab9" 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/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/mongodb/mongo-atlas-set-retention-hours.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=8e938d3ea5df9edd0cb82b811a5b1420" 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/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/mongodb/mongo-atlas-add-new-database-user.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=a2cc2f5fbe4f7d2195e3e91f25666846" 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/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/mongodb/mongo-atlas-database-user-privilege.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=11a48c0a3379ce5f4b88777b864d37a0" 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/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/mongodb/mongo-atlas-restrict-access.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=34cdb62e74cc6f674a139f0e768d57d8" 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](/docs/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.
