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

> Пошаговое руководство по настройке Amazon DocumentDB в качестве источника для ClickPipes

# Руководство по настройке Amazon DocumentDB как источника

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

<div id="supported-documentdb-versions">
  ## Поддерживаемые версии DocumentDB
</div>

ClickPipes поддерживает версию 5.0 DocumentDB.

<div id="configure-change-stream-log-retention">
  ## Настройка срока хранения журнала change stream
</div>

По умолчанию в Amazon DocumentDB срок хранения журнала change stream составляет 3 часа, тогда как начальная загрузка может занять значительно больше времени в зависимости от объема имеющихся данных в DocumentDB. Мы рекомендуем установить срок хранения журнала change stream на 72 часа или более, чтобы журнал не был обрезан до завершения начального снимка.

<div id="update-change-stream-log-retention-via-aws-console">
  ### Обновление срока хранения журнала change stream в консоли AWS
</div>

1. В левой панели нажмите `Parameter groups`, затем найдите группу параметров, используемую вашим кластером DocumentDB (если вы используете группу параметров по умолчанию, сначала потребуется создать новую, чтобы можно было вносить изменения).

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/mongodb/docdb-select-parameter-group.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=eca21e67647b7536a207fa6ab631c3a5" alt="Выбор группы параметров" size="lg" border width="2534" height="1266" data-path="images/integrations/data-ingestion/clickpipes/mongodb/docdb-select-parameter-group.png" />

2. Найдите `change_stream_log_retention_duration`, выберите этот параметр и измените его значение на `259200` (72 часа)

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/mongodb/docdb-modify-parameter-group.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=88974ade78f332d1d4a671d3dd59e377" alt="Изменение группы параметров" size="lg" border width="2524" height="1332" data-path="images/integrations/data-ingestion/clickpipes/mongodb/docdb-modify-parameter-group.png" />

3. Нажмите `Apply Changes`, чтобы немедленно применить изменённую группу параметров к кластеру DocumentDB. Статус группы параметров должен сначала измениться на `applying`, а после применения изменения — на `in-sync`.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/mongodb/docdb-apply-parameter-group.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=76a6d71e46c40ae881a2287298acb350" alt="Применение группы параметров" size="lg" border width="2520" height="1596" data-path="images/integrations/data-ingestion/clickpipes/mongodb/docdb-apply-parameter-group.png" />

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/mongodb/docdb-parameter-group-status.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=9e7ffbde823e858ea739ee8752f8f350" alt="Статус группы параметров" size="lg" border width="2538" height="694" data-path="images/integrations/data-ingestion/clickpipes/mongodb/docdb-parameter-group-status.png" />

<div id="update-change-stream-log-retention-via-aws-cli">
  ### Обновление срока хранения журнала change stream через AWS CLI
</div>

Кроме того, это можно настроить через AWS CLI.

Чтобы проверить текущий срок хранения журнала change stream:

```shell theme={null}
aws docdb describe-db-cluster-parameters --db-cluster-parameter-group-name <PARAMETER_GROUP_NAME> --query "Parameters[?ParameterName=='change_stream_log_retention_duration'].{Name:ParameterName,Value:ParameterValue}"
```

Чтобы установить срок хранения журнала change stream на 72 часа:

```shell theme={null}
aws docdb modify-db-cluster-parameter-group --db-cluster-parameter-group-name <PARAMETER_GROUP_NAME> --parameters "ParameterName=change_stream_log_retention_duration,ParameterValue=259200,ApplyMethod=immediate"
```

<div id="configure-database-user">
  ## Настройка пользователя базы данных
</div>

Подключитесь к своему кластеру DocumentDB под учетной записью администратора и выполните следующую команду, чтобы создать пользователя базы данных для MongoDB CDC ClickPipes:

```javascript theme={null}
db.getSiblingDB("admin").createUser({
    user: "clickpipes_user",
    pwd: "some_secure_password",
    roles: ["readAnyDatabase", "clusterMonitor"],
})
```

<Note>
  Обязательно замените `clickpipes_user` и `some_secure_password` на нужные вам имя пользователя и пароль.
</Note>

<div id="whats-next">
  ## Что дальше?
</div>

Теперь вы можете [создать ClickPipe](/ru/integrations/clickpipes/mongodb/index) и начать приём данных из экземпляра DocumentDB в ClickHouse Cloud.
Обязательно сохраните сведения о подключении, которые вы использовали при настройке кластера DocumentDB, так как они понадобятся вам в процессе создания ClickPipe.