# Настройка утилиты переноса данных

Для переноса данных предназначена `утилита переноса данных`, которая позволяет:

- перенести данные из базы данных PostgreSQL в пустую базу данных MS Access;
- перенести данные из базы данных MS Access в пустую базу данных PostgreSQL;
- сохранить данные базы данных в дамп
- загрузить данные базы данных из дампа

Исключения:

- двоичные данные не переносятся.

## Скачать дистрибутив утилиты переноса данных [https://rsit.ru/#load-ama](https://rsit.ru/#load-ama) 

## Установка утилиты переноса данных

1. Выбор языка процесса установки
    
    [![image-1736772927658.png](https://support.russianit.ru/uploads/images/gallery/2025-01/scaled-1680-/image-1736772927658.png)](https://support.russianit.ru/uploads/images/gallery/2025-01/image-1736772927658.png)
2. Выбор пути, куда будет установлена утилита переноса данных
    
    [![image-1736772939374.png](https://support.russianit.ru/uploads/images/gallery/2025-01/scaled-1680-/image-1736772939374.png)](https://support.russianit.ru/uploads/images/gallery/2025-01/image-1736772939374.png)
3. Выбор пути до папки, в которой будут расположены ярлыки программы `Утилита переноса данных`, `Перенести данные ПАУ в БД PostgreSQL` и `Перенести данные ПАУ в БД MS Access`
    
    [![image-1736772950522.png](https://support.russianit.ru/uploads/images/gallery/2025-01/scaled-1680-/image-1736772950522.png)](https://support.russianit.ru/uploads/images/gallery/2025-01/image-1736772950522.png)
4. Приготовление к установке
    
    [![image-1736772961188.png](https://support.russianit.ru/uploads/images/gallery/2025-01/scaled-1680-/image-1736772961188.png)](https://support.russianit.ru/uploads/images/gallery/2025-01/image-1736772961188.png)
5. После завершения установки программы требуется нажать `Завершить`, чтобы начать пользоваться `утилитой переноса данных`
    
    [![image-1736776286715.png](https://support.russianit.ru/uploads/images/gallery/2025-01/scaled-1680-/image-1736776286715.png)](https://support.russianit.ru/uploads/images/gallery/2025-01/image-1736776286715.png)

Параметры переноса данных определяются с помощью файла конфигурации `settings.config`, расположенного по пути: `%appdata%\RussianIT\TransferUtil\`

## Конфигурация утилиты переноса данных

Параметры переноса данных определяются с помощью файла конфигурации `settings.config`, расположенного по пути: `%appdata%\RussianIT\TransferUtil\`

### Основные параметры

<table border="1" cellspacing="0" id="bkmrk-%D0%9A%D0%BB%D1%8E%D1%87-%D0%97%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%B8%D1%8F-%D0%BF%D0%BE-%D1%83%D0%BC%D0%BE"><thead><tr><th style="text-align: left;">Ключ</th><th style="text-align: left;">Значения по-умолчанию</th><th style="text-align: left;">Описание</th></tr></thead><tbody><tr><td class="wysiwyg-text-align-center" style="text-align: left;">pg\_server</td><td style="text-align: left;">`127.0.0.1`</td><td style="text-align: left;">Необходимо указать ip адрес сервера, на котором расположена СУБД PostgreSQL, например: `127.0.0.1` или `192.168.0.123`</td></tr><tr><td class="wysiwyg-text-align-center" style="text-align: left;">pg\_port</td><td style="text-align: left;">`5432`</td><td style="text-align: left;">Необходимо указать открытый порт на сервере, на котором расположена СУБД PostgreSQL, например: `5432`</td></tr><tr><td class="wysiwyg-text-align-center" style="text-align: left;">pg\_dbname</td><td style="text-align: left;">`ama`</td><td style="text-align: left;">Наименование БД PostgreSQL на сервере, в которую и из которой будет происходит перенос данных</td></tr><tr><td class="wysiwyg-text-align-center" style="text-align: left;">pg\_dbuser</td><td style="text-align: left;">`ama_user`</td><td style="text-align: left;">Необходимо указать логин пользователя postgresql, из под которого будет совершён перенос данных.</td></tr><tr><td class="wysiwyg-text-align-center" style="text-align: left;">pg\_dbpassword</td><td style="text-align: left;">`12345`</td><td style="text-align: left;">Необходимо указать пароль пользователя СУБД PostgreSQL. В идеале это должен быть сложный пароль, а пароль `12345` представлен лишь для примера.</td></tr><tr><td class="wysiwyg-text-align-center" style="text-align: left;">pg\_ssl</td><td style="text-align: left;">`False`</td><td style="text-align: left;">Для подключения через SSL нужно подставить значение `True`, для подключения без SSL значение `False`</td></tr><tr><td class="wysiwyg-text-align-center" style="text-align: left;">ma\_dbpath</td><td style="text-align: left;">`C:\Users\Public\Documents\ama.mdb`</td><td style="text-align: left;">Путь до базы MS Access, которая будет использоваться при переносе данных.</td></tr><tr><td class="wysiwyg-text-align-center" style="text-align: left;">save\_documentarchive</td><td style="text-align: left;">`False`</td><td style="text-align: left;">Для сохранения содержимого таблицы DocumentArchive (архив документов) нужно подставить значение `True`, а для того чтобы пропустить эту таблицу - значение `False`</td></tr></tbody></table>

```
Пример файла конфигурации<br></br><?xml version="1.0" encoding="utf-8"?><br></br><configuration><br></br><pg_server>localhost</pg_server><br></br><pg_port>5432</pg_port><br></br><pg_dbname>ama</pg_dbname><br></br><pg_dbuser>postgres</pg_dbuser><br></br><pg_dbpassword>12345</pg_dbpassword><br></br><pg_ssl>False</pg_ssl><br></br><ma_dbpath>ama.mdb</ma_dbpath><br></br><save_documentarchive>False</save_documentarchive><br></br></configuration>
```

# Дополнительная информация об утилите переноса данных

## Описание обменного формата

При переносе данных как из БД PostgreSQL, так и из БД MS Access, формируются файлы определенного формата (дампы):

![mceclip0.png](https://support.russianit.ru/uploads/images/gallery/2022-06/360013783719_mceclip0.png)

![mceclip1.png](https://support.russianit.ru/uploads/images/gallery/2022-06/360013792600_mceclip1.png)

Префиксы строк, наименования и типы колонок, а также значения строк, отделяются друг от друга вертикальной чертой |

## Доступные команды

Утилита представляет собой консольное приложение, запускать которое следует с помощью "Командной строки Windows" (cmd.exe).

Пример использования: TransferUtil.exe to-pg

![mceclip2.png](https://support.russianit.ru/uploads/images/gallery/2022-06/360013792680_mceclip2.png)