Утилита миграции с БД Microsoft на Postgres

Если в решении содержатся дополнительные SQL-скрипты, процедуры, представления и работы (jobs), необходимо реализовать их альтернативное поведение для Postgres.

Создайте резервную копию рабочей базы.

Оцените размер таблицы dvsys_binaries.

Подготовьте файловое хранилище необходимого объема, больше, чем текущий размер таблицы dvsys_binaries.

Настройте хранение всех несистемных файлов в новом файловом хранилище.

Так как бинарным файлам при вытеснении в файловое хранилище будет присваиваться имя, указанное в столбце Name таблиц dvsys_files (dvsys_files_archive), убедитесь, что строки не содержат недопустимых символов или зеркалированных слов.

Удалите созданные индексы и отключите полнотекстовый поиск, если он использовался в базе-источнике. Полнотекстовый поиск для PostgreSQL может быть установлен позднее, подробнее см. в разделе "Установить систему Elasticsearch".

Запустите скрипт для переноса существующих в базе несистемных файлов в созданное файловое хранилище, используя один из следующих вариантов:

Дождитесь завершения обработки созданной очереди Docsvision 5.5 File Service. Выполните запрос:

select * from dvsys_queue_object where QueueID in (select [ID] from [dvsys_queue_queue] where [Name] = 'MoveFilesToStorage')

После миграции файлов на диск дождитесь удаления старых записей из таблицы dvsys_binaries. Docsvision 5.5 File Service не обрабатывает очереди асинхронно. За это отвечает SQL работа DV:Binary_<имя бд>_DeleteBinaryInner.
В противном случае старые файлы будут экспортированы в .csv файлы, что приведёт к заполнению дополнительного места на диске и потребует дополнительного времени.

Если в базе было включено и использовалось внешнее хранилище FileStream, и после вытеснения файлов на диск внешнего хранилища остались файлы, их необходимо вытеснить с FileStream в основную БД.
Для проверки наличия файлов в хранилище FileStream можно использовать следующий запрос:

select top 1 * from dvsys_binaries where [StreamData] is not null

update b set [Data] = [StreamData], [StreamData] = null from dvsys_binaries b where b.[StreamData] is not null;
update f set [StorageState] = 0 from dvsys_files f where [StorageState] = 1;

Выполните аналогичные действия для архивной части.

Перед продолжением убедитесь, что выполнены все указанные выше требования.

Сгенерируйте в рабочей БД вспомогательные объекты (таблицы и представления). Пример команды приведён ниже:

CloneDbUtil.exe /ms:"Initial Catalog= source_db; Data Source=server; Integrated Security = SSPI;" /install

Создайте папку для экспорта таблицы в .csv файлы на сервере Microsoft SQL.
Экспорт выполняется на сервере СУБД утилитой bcp.exe, входящей в состав Microsoft SQL Server. Использование команды из примера ниже вызовет bcp.exe:

CloneDbUtil.exe /ms:"Initial Catalog= source_db; Data Source=server; Integrated Security = SSPI;" /p:"D:\clone_db_data" /export /l:10

  -- To allow advanced options to be changed.
EXECUTE sp_configure 'show advanced options', 1;
GO
-- To update the currently configured value for advanced options.
RECONFIGURE;
GO
-- To enable the feature.
EXECUTE sp_configure 'xp_cmdshell', 1;
GO
-- To update the currently configured value for this feature.
RECONFIGURE;
GO
-- To set "show advanced options" back to false
EXECUTE sp_configure 'show advanced options', 0;
GO
-- To update the currently configured value for advanced options.
RECONFIGURE;
GO

  -- To allow advanced options to be changed.
EXECUTE sp_configure 'show advanced options', 1;
GO
-- To update the currently configured value for advanced options.
RECONFIGURE;
GO
-- To disable the feature.
EXECUTE sp_configure 'xp_cmdshell', 0;
GO
-- To update the currently configured value for this feature.
RECONFIGURE;
GO
-- To set "show advanced options" back to false
EXECUTE sp_configure 'show advanced options', 0;
GO
-- To update the currently configured value for advanced options.
RECONFIGURE;
GO

Измените кодировку .csv файлов.
Файлы выгружаются с кодировкой Юникод в то время как нативная кодировка PostgreSQL — UTF8, поэтому у файлов потребуется сменить кодировку и нормализовать определенные символы. Для этого предусмотрен следующий этап и режим работы утилиты.

CloneDbUtil.exe /f /infolder:"C:\clone_db_data" /outfolder:"C:\clone_db_data2"

CloneDbUtil.exe /f /in:"C:\clone_db_data\dvsys_instances.cvs" /out:"C:\clone_db_data2\dvsys_instances.cvs"

Создайте структуры БД PostgreSQL для импорта таблиц.
Утилита использует метаданные из базы-источника для генерации скриптов библиотек карточек и сгенерирует таблицы необходимой структуры в базе PostgreSQL.

CloneDbUtil.exe /ms:"Initial Catalog= source_db; Data Source=server; Integrated Security = SSPI;" /pg:"Server=127.0.0.1; Port=5432; Database=target_db; User ID=postgres; Password=password;" /clone

Выполните импорт .csv файлов:

CloneDbUtil.exe /ms:"Initial Catalog= source_db; Data Source=server; Integrated Security = SSPI;" /pg:"Server=127.0.0.1; Port=5432; Database=target_db; User ID=postgres; Password=password;" /import /p:"C:\clone_db_data2" /l:25

Выполните полное обновление базы Postgres через консоль настройки Docsvision.

update dvsys_globalinfo set "Version" =  4350;
update dvsys_libraries set "SysVersion" = 4350 where "SysVersion" = 4352;
update dvsys_carddefs set "SysVersion" = 4350 where "SysVersion" = 4352;

Назначьте PostgreSQL базу основной и отключите базу Microsoft SQL в Консоли настройки Docsvision.

Заново выполните настройки модуля Управление процессами, настройки почты см. в документации модуля Управление процессами версии 5.5.3. Также выполните настройки почты и подключения к БД в Консоли управления Docsvision, см. "Настройка соединения с почтовым сервером".

Запустите все остановленные сервисы.

При повторном экспорте, например в другую папку потребуется сменить статус БД:

(update [alias_migrationpg].[dbo].[dvexport_commands] set [status] = 0)

Открытие клиента.

Открытие различных папок.

Открытие всех видов карточек.

Открытие файлов приложенных к карточкам.

Создание различных файлов.

Прикладывание файлов.

Запуск и работу БП.