1C Database copier (cpdb)

Типичный сценарий работы:

1. Сформировать резервную копию базы
2. Передать резервную копию на целевую систему
   • Через общую папку / С использованием Yandex-Диск
   • Возможно разбиение больших файлов на части (используется 7-zip)
3. Восстановить резервную копию в новую или существующую базу
4. Подключить базу к хранилищу конфигурации

Требуются следующие библиотеки и инструменты:

• cmdline
• 1commands
• logos
• v8runner
• ReadParams
• yadisk
• 7-zip
• MS Command Line Utilities for SQL Server (sqlcmd)

Для подсказки по конкретной команде наберите help <команда>

backup - Создание резервной копии базы MS SQL

Пример:

cpdb backup -sql-srvr MySQLName MyDatabase -sql-user sa -sql-pwd 12345 -bak-path "d:\MSSQL\Backup\MyDatabase_copy.bak"

restore - Восстановление базы MS SQL из резервной копии

Пример:

cpdb restore -sql-srvr MyNewSQLServer -sql-db MyDatabase_copy -sql-user SQLUser -sql-pwd 123456 -bak-path "d:\data\MyBackUpfile.bak" -create-db -shrink-db -db-owner SQLdbo -db-path "d:\MSSQL\data" -db-logpath "e:\MSSQL\logs" -db-recovery SIMPLE -delsrc

compress - Выполнить компрессию страниц таблиц и индекстов в базе MS SQL

Пример:

cpdb compress -sql-srvr MyNewSQLServer -sql-db MyDatabase_copy -sql-user SQLUser -sql-pwd 123456 -shrink-db

createib - Создать информационную базу на сервере 1С

Пример:

cpdb createib -ib-srvr My1CServer -ib-ref TST_DB_MyDomain -db-srvr MySQLServer -db-user _1CSrvUsr1 -db-pwd p@ssw0rd -db-name TST_DB_MyDomain -createdb -nameinlist "My test base" -errifexist

dumpib - Выгрузить информационную базу в файл

Пример:

cpdb dumpib -ib-path "/FD:/data/MyDatabase" -dt-path "d:\data\1Cv8.dt" -ib-user Администратор -ib-pwd 123456 -v8version 8.3.8 -uccode 1234

restoreib - Загрузить информационную базу из файла

Пример:

cpdb restoreib -ib-path "/FD:/data/MyDatabase" -dt-path "d:\data\1Cv8.dt" -ib-user Администратор -ib-pwd 123456 -v8version 8.3.8 -uccode 1234 -delsrc

putyadisk - Помещение файла на Yandex-Диск

Пример:

cpdb putyadisk -file "d:\MSSQL\Backup\MyDatabase_copy.bak" -ya-token XXXXXXXXXXXXXXXXXXXXXXXXXXXXX -ya-path "/transfer" -delsrc

cpdb putyadisk -list "d:\MSSQL\Backup\MyDatabase_copy.split" -ya-token XXXXXXXXXXXXXXXXXXXXXXXXXXXXX -ya-path "/transfer" -delsrc

getyadisk - Получение файла из Yandex-Диска

Параметры:

Пример:

cpdb getyadisk -path "d:\MSSQL\Backup\MyDatabase_copy.bak" -ya-token XXXXXXXXXXXXXXXXXXXXXXXXXXXXX -ya-file "/transfer/MyDatabase_copy.bak" -delsrc

cpdb getyadisk -path "d:\MSSQL\Backup\MyDatabase_copy.bak" -ya-token XXXXXXXXXXXXXXXXXXXXXXXXXXXXX -ya-list "/transfer/MyDatabase_copy.split" -delsrc

Для получения токена авторизации Яндекс-диска:

• Зарегистрировать приложение: https://oauth.yandex.ru/client/new
  • Название приложения, например "OScript.YaDisk"
  • Платформы "Веб-сервисы"
  • Callback URI #1: https://oauth.yandex.ru/verification_code
• Дать нужные права для приложения
  • Сервис Яндекс.Диск REST API
    • Запись в любом месте на Диске
      • Чтение всего Диска
      • Доступ к информации о Диске
• Нажать "Создать приложение" внизу формы: после этого будет показан ID пароль, прочие параметры созданного приложения
• Получить токен для приложения: перейти по ссылке https://oauth.yandex.ru/authorize?response_type=token&client_id=<ВАШ ID (ID: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX)>
• На вопрос "Приложение OScript.YaDisk запрашивает доступ к вашим данным на Яндексе" ответить "Разрешить": после этого на экране появится сформированный токен

mapdrive - Подключить сетевой диск

Пример:

cpdb mapdrive -map-drive N -map-res "\\MyServer\MyFolder" -map-user superuser -map-pwd P@$$w0rd

umapdrive - Отключить сетевой диск

Пример:

cpdb umapdrive -map-drive N

copy - скопировать/переместить файлы

Простой пример. Копирование файла в каталог:

cpdb copy -src "d:\MSSQL\Backup\MyDatabase_copy.bak" -dst "N:\NewDestination\" -replace -delsrc

Сложный пример. В каталоге-источнике имеется несколько резервных копий с датой в имени файла. Необходимо скопировать только свежий файл (созданный сегодня). Новое имя файла не должно содержать дату:

cpdb copy -src "d:\MSSQL\Backup\MyDatabase_copy*.bak" -dst "N:\NewDestination\MyDatabase_copy.bak*" -replace -delsrc -lastonly

split - Архивировать файл с разбиением на части указанного размера

Используется 7-zip

Пример:

cpdb split "d:\MSSQL\Backup\MyDatabase_copy.bak" -list "d:\MSSQL\Backup\MyDatabase_copy.split" -vol 40m -delsrc

merge - Разархивировать файл

Используется 7-zip

Пример:

cpdb merge -file "d:\MSSQL\Backup\MyDatabase_copy.7z.001" -delsrc

cpdb merge -list "d:\MSSQL\Backup\MyDatabase_copy.split" -delsrc

uconstorage - Отключить информационную базу от хранилища конфигурации

cpdb uconstorage -ib-path "/FD:/data/MyDatabase" -ib-user Администратор -ib-pwd 123456 -v8version 8.3.8 -uccode 1234

constorage - Подключить информационую базу к хранилищу конфигурации

cpdb constorage -ib-path "/FD:/data/MyDatabase" -ib-user Администратор -ib-pwd 123456 -storage-path "tcp://MyServer/MyRepository" -storage-user MyDatabase_usr1 -storage-pwd 123456 -v8version 8.3.8 -uccode 1234

batch - Выполнить сценарий

Последовательно выполняет команды указнные в файле JSON

Пример:

cpdb batch "./rest_TST_DB_MyDomain.json"

Пример сценария:

{
    "params": {},
    "stages": {
        "Восстановление": {
            "description": "Восстановление из резервной копии",
            "tool": "cpdb",
            "command": "restore",
            "params": {
                "-sql-srvr": "MySQLServer",
                "-sql-user": "_1CSrvUsr1",
                "-sql-pwd": "p@ssw0rd",
                "-bak-path": "d:\\tmp\\PRD_DB_MyDomain.bak",
                "-sql-db": "TST_DB_MyDomain",
                "-db-owner": "_1CSrvUsr1",
                "-db-path": "D:\\sqldata",
                "-db-logpath": "D:\\sqldata",
                "-db-recovery": "SIMPLE",
                "-db-changelfn": true
            }
        },
        "Отключение": {
            "description": "Отключение от хранилища",
            "tool": "cpdb",
            "command": "uconstorage",
            "params": {
                "-ib-path": "/SSport1\\TST_DB_MyDomain",
                "-ib-user": "\"1C User\"",
                "-ib-pwd": "p@ssw0rd"
            }
        },
        "Сжатие": {
            "description": "Сжатие базы данных",
            "tool": "cpdb",
            "command": "compress",
            "params": {
                "-sql-srvr": "Sport1",
                "-sql-user": "_1CSrvUsr1",
                "-sql-pwd": "p@ssw0rd",
                "-sql-db": "TST_DB_MyDomain",
                "-shrink-db": true
            }
        }
    }
}

scripts - Выполнить скрипты из файла(ов)

Пример:

cpdb scripts -params "./JSON/cpdb_env.json" -sql-files "./tools/config_error.sql;./tools/print_message.sql" -sql-vars "varBase=MyDB;message=\"Hello world\""

Пример config_error.sql:

use $(varBase)
go
truncate table [dbo].[ConfigSave]
go
UPDATE SchemaStorage SET Status = 100

Пример print_message.sql:

PRINT N'$(message)'

Использование c Jenkins

В jenkinsfile описан конвейер, выполняющий следующий сценарий:

• Создание резервной копии указанной базы на системе-источнике
• Разбиение резервной копии на части (используется 7-Zip)
• Копирование частей файла на Yandex-Диск (в указанный каталог)
• Получение файла резервной копии из Yandex-Диск на системе-приемнике
• Восстановление указанной базы из резервной копии
• Подключает базу к хранилищу конфигурации