1C Database copier (cpdb)

Библиотека и приложение для получения информации о базах 1С, копирования баз 1C и развертывания на целевой системе.

Зависимости
Команды приложения
Библиотека
Запуск тестов

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

Команды приложения

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

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


database	Группа команд работы с СУБД
	create	- Создание базы MS SQL
	backup	- Создание резервной копии базы MS SQL
	restore	- Восстановление базы MS SQL из резервной копии
	compress	- Выполнить компрессию страниц таблиц и индекстов в базе MS SQL
	drop	- Удаление базы MS SQL
	script	- Выполнить произвольный скрипт на сервере MS SQL
infobase	Группа команд работы с информационными базами 1С
	create-srv-ib	- Создать информационную базу на сервере 1С
	create-file-ib	- Создать файловую информационную базу 1С
	dump	- Выгрузить информационную базу в файл
	restore	- Загрузить информационную базу из файла
	clearcache	- Очистить локальный кэш информационных баз 1С
	uconstorage	- Отключить информационную базу от хранилища конфигураций
	constorage	- Подключить информационную базу к хранилищу конфигураций
file	Группа команд работы с файлами
	copy	- Копировать/переместить файлы
	split	- Архивировать файл с разбиением на части указанного размера (используется 7-Zip)
	merge	- Разархивировать файл (используется 7-Zip)
	mapdrive	- Подключить сетевой диск
	umapdrive	- Отключить сетевой диск
yadisk	Группа команд работы с сервисом Yandex-Диск
	put	- Помещение файла на Yandex-Диск
	get	- Получение файла из Yandex-Диска
nextcloud	Группа команд работы с сервисом NextCloud
	put	- Помещение файла в сервис NextCloud
	get	- Получение файла из сервиса NextCloud
sftp	Группа команд работы с SFTP-сервером
	put	- Помещение файла на сервер SFTP
	get	- Получение файла с сервера SFTP
batch	- Последовательное выполнение команд по сценариям, заданным в файлах (json)

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

database - Группа команд работы с СУБД

Общие параметры для команд группы:
--srvr	- Адрес сервера MS SQL
--user	- Пользователь сервера
--pwd	- Пароль пользователя сервера

create - Создание базы MS SQL

Параметры:
--params	- Файлы JSON содержащие значения параметров, могут быть указаны несколько файлов разделенные ";" (параметры командной строки имеют более высокий приоритет)
--db	- Имя базы для восстановления
--db-recovery	- Установить модель восстановления (RECOVERY MODEL), возможные значения "FULL", "SIMPLE", "BULK_LOGGED"

Пример

cpdb database --srvr MySQLName --user sa --pwd 12345 create --db MyDatabase --db-recovery SIMPLE

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

Параметры:
--params	- Файлы JSON содержащие значения параметров, могут быть указаны несколько файлов разделенные ";" (параметры командной строки имеют более высокий приоритет)
--db	- Имя базы для восстановления
--bak-path	- Путь к резервной копии

Пример

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

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

Параметры:
--params	- Файлы JSON содержащие значения параметров, могут быть указаны несколько файлов разделенные ";" (параметры командной строки имеют более высокий приоритет)
--db	- Имя базы для восстановления
--bak-path	- Путь к резервной копии
--create-db	- Создать базу в случае отсутствия
--db-owner	- Имя владельца базы после восстановления
--compress-db	- Включить компрессию страниц таблиц и индексов после восстановления
--shrink-db	- Сжать файлы данных после восстановления
--shrink-log	- Сжать файлы журнала транзакций после восстановления
--db-path	- Путь к каталогу файлов данных базы после восстановления
--db-logpath	- Путь к каталогу файлов журнала после восстановления
--db-recovery	- Установить модель восстановления (RECOVERY MODEL), возможные значения "FULL", "SIMPLE", "BULK_LOGGED"
--db-changelfn	- Изменить логические имена файлов (LFN) базы, в соответствии с именем базы
--delsrc	- Удалить файл резервной копии после восстановления

Пример

cpdb database --srvr MyNewSQLServer --user SQLUser --pwd 123456 restore --db MyDatabase_copy --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

Параметры:
--params	- Файлы JSON содержащие значения параметров, могут быть указаны несколько файлов разделенные ";" (параметры командной строки имеют более высокий приоритет)
--db	- Имя базы для восстановления
--shrink-db	- Сжать базу после выполнения компрессии
--shrink-log	- Сжать файлы журнала транзакций после восстановления

Пример

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

drop - Удаление базы MS SQL

Параметры:
--params	- Файлы JSON содержащие значения параметров, могут быть указаны несколько файлов разделенные ";" (параметры командной строки имеют более высокий приоритет)
--db	- Имя базы для восстановления

Пример

cpdb database --srvr MySQLName --user sa --pwd 12345 drop --db MyDatabase

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

Параметры:
--params	- Файлы JSON содержащие значения параметров, могут быть указаны несколько файлов разделенные ";" (параметры командной строки имеют более высокий приоритет)
--files	- Файлы SQL, содержащие текст скрипта, могут быть указаны несколько файлов, разделённые ";"
--vars	- Строка значений переменных (без пробелов) для скриптов SQL в виде "<Имя>=<Значение>", разделенные ";"

Пример

cpdb database --srvr MyNewSQLServer --user SQLUser --pwd 123456 script --params "./JSON/cpdb_env.json" --files "./tools/config_error.sql;./tools/print_message.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)'

infobase - Группа команд работы с информационной базой 1С

Общие параметры для команд группы:
--v8version	- маска версии платформы 1С (например: 8.3.8, 8.3.17.1851)

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

Параметры:
--params	- Файлы JSON содержащие значения параметров, могут быть указаны несколько файлов разделенные ";" (параметры командной строки имеют более высокий приоритет)
--ib-srvr	- Адрес кластера серверов 1С ([<протокол>://]<адрес>[:<порт>])
--ib-ref	- Имя базы в кластере 1С
--err-if-exist	- Сообщить об ошибке если ИБ в кластере 1С существует
--dbms	- Тип сервера СУБД (MSSQLServer <по умолчанию>; PostgreSQL; IBMDB2; OracleDatabase)
--db-srvr	- Адрес/имя сервера СУБД
--db-user	- Пользователь сервера СУБД"
--db-pwd	- Пароль пользователя сервера СУБД"
--db-name	- Имя базы на сервере СУБД (если не указано, используется имя базы 1С)"
--sql-offs	- Смещение дат на сервере MS SQL (0; 2000 <по умолчанию>)
--create-db	- Создавать базу данных в случае отсутствия
--allow-sch-job	- Разрешить регламентные задания
--allow-lic-dstr	- Разрешить выдачу лицензий сервером 1С
--cadm-user	- Имя администратора кластера
--cadm-pwd	- Пароль администратора кластера
--name-in-list	- Имя в списке баз пользователя (если не задано, то ИБ в список не добавляется)
--tmplt-path	- Путь к шаблону для создания информационной базы (.cf; .dt). Если шаблон не указан, то будет создана пустая ИБ

Пример

cpdb infobase --v8version 8.3.8 create-srv-ib --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

create-file-ib - Создать файловую информационную базу 1С

Параметры:
--params	- Файлы JSON содержащие значения параметров, могут быть указаны несколько файлов разделенные ";" (параметры командной строки имеют более высокий приоритет)
--ib-path	- Путь к каталогу базы 1С
--err-if-exist	- Сообщить об ошибке если ИБ в кластере 1С существует
--name-in-list	- Имя в списке баз пользователя (если не задано, то ИБ в список не добавляется)
--tmplt-path	- Путь к шаблону для создания информационной базы (.cf; .dt). Если шаблон не указан, то будет создана пустая ИБ

Пример

cpdb infobase --v8version 8.3.8 create-file-ib --ib-path "D:\1cbases\My1CBase" --name-in-list "My test base" --err-if-exist

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

Параметры:
--params	- Файлы JSON содержащие значения параметров, могут быть указаны несколько файлов разделенные ";" (параметры командной строки имеют более высокий приоритет)
--ib-path	- Строка подключения к ИБ
--ib-user	- Пользователь ИБ
--ib-pwd	- Пароль пользователя ИБ
--dt-path	- Путь к файлу для выгрузки ИБ
--uccode	- Ключ разрешения запуска ИБ

Пример

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

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

Параметры:
--params	- Файлы JSON содержащие значения параметров, могут быть указаны несколько файлов разделенные ";" (параметры командной строки имеют более высокий приоритет)
--ib-path	- Строка подключения к ИБ
--ib-user	- Пользователь ИБ
--ib-pwd	- Пароль пользователя ИБ
--dt-path	- Путь к файлу для загрузки в ИБ
--jobs-count	- Количество заданий загрузки файла (для клиент-серверной базы, начиная с версии платформы 8.3.19)
--uccode	- Ключ разрешения запуска ИБ
--delsrc	- Удалить файл после загрузки

Пример

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

clearcache - Очистить локальный кэш информационных баз 1С

Параметры:
--params	- Файлы JSON содержащие значения параметров, могут быть указаны несколько файлов разделенные ";" (параметры командной строки имеют более высокий приоритет)
--ib-path	- Строка подключения к ИБ (если не указан то удаляются локальные кэши всех информационных баз)

Пример

cpdb infobase clearcache --ib-path "/FD:/data/MyDatabase"

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

Параметры:
--params	- Файлы JSON содержащие значения параметров, могут быть указаны несколько файлов разделенные ";" (параметры командной строки имеют более высокий приоритет)
--ib-path	- Строка подключения к ИБ");
--ib-user	- Пользователь ИБ");
--ib-pwd	- Пароль пользователя ИБ");
--extension	- Имя отключаемого расширения конфигурации
--uccode	- Ключ разрешения запуска ИБ");

Пример

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

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

Параметры:
--params	- Файлы JSON содержащие значения параметров, могут быть указаны несколько файлов разделенные ";" (параметры командной строки имеют более высокий приоритет)
--ib-path	- Строка подключения к ИБ
--ib-user	- Пользователь ИБ
--ib-pwd	- Пароль пользователя ИБ
--extension	- Имя подключаемого расширения конфигурации
--storage-path	- Адрес хранилища конфигурации
--storage-user	- Пользователь хранилища конфигурации
--storage-pwd	- Пароль пользователя хранилища конфигурации
--update-ib	- Выполнить обновление ИБ (применить полученную из хранилища конфигурацию к ИБ)
--uccode	- Ключ разрешения запуска ИБ

Пример

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

file - Группа команд работы с файлами

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

Параметры:
--params	- Файлы JSON содержащие значения параметров, могут быть указаны несколько файлов разделенные ";" (параметры командной строки имеют более высокий приоритет)
--src	- Файл источник
--dst	- Файл/каталог приемник (если оканчивается на "", то каталог)
--move	- Выполнить перемещение файлов (удалить источник после копирования)
--lastonly	- Копирование файлов, измененных не ранее текущей даты

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

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

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

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

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

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

Параметры:
--params	- Файлы JSON содержащие значения параметров, могут быть указаны несколько файлов разделенные ";" (параметры командной строки имеют более высокий приоритет)
--src	- Путь к исходному локальному файлу для разбиения
--arch	- Имя файла архива (не обязательный, по умолчанию <имя исходного файла>.7z)
--list	- Имя файла, списка томов архива (не обязательный, по умолчанию <имя исходного файла>.split)
--vol-size	- Размер части {<g>, <m>, <b>} (по умолчанию 50m)
--compress-level	- Уровень сжатия частей архива {0 - 9} (по умолчанию 0 - не сжимать)
--delsrc	- Удалить исходный файл после выполнения операции

Пример

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

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

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

Параметры:
--params	- Файлы JSON содержащие значения параметров, могут быть указаны несколько файлов разделенные ";" (параметры командной строки имеют более высокий приоритет)
--arch	- Имя первого файла архива
--list	- Имя файла, списка файлов архива (параметр -arch игнорируется)
--delsrc	- Удалить исходные файлы после выполнения операции

Пример

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

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

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

Параметры:
--params	- Файлы JSON содержащие значения параметров, могут быть указаны несколько файлов разделенные ";" (параметры командной строки имеют более высокий приоритет)
--drive	- Имя устройства (буква диска)
--res	- Путь к подключаемому ресурсу
--user	- Пользователь для подключения
--pwd	- Пароль для подключения

Пример

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

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

Параметры:
--params	- Файлы JSON содержащие значения параметров, могут быть указаны несколько файлов разделенные ";" (параметры командной строки имеют более высокий приоритет)
--drive	- Имя устройства (буква диска)

Пример

cpdb file umapdrive --drive N

yadisk - Группа команд работы с сервисом Yandex-Диск

Общие параметры для команд группы:
--token	- Token авторизации

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

Параметры:
--params	- Файлы JSON содержащие значения параметров, могут быть указаны несколько файлов разделенные ";" (параметры командной строки имеют более высокий приоритет)
--file	- Путь к локальному файлу для помещения на Yandex-Диск
--list	- Путь к локальному файлу со списком файлов, которые будут помещены на Yandex-Диск (параметр --file игнорируется)
--path	- Путь к каталогу на Yandex-Диск, куда помещать загружаемые файлы
--replace	- Перезаписать файл на Yandex-диске при загрузке
--delsrc	- Удалить исходные файлы после отправки

Пример

// Помещает файл "MyDatabase_copy.bak" на Yandex-диск
cpdb yadisk --token XXXXXXXXXXXXXXXXXXXXXXXXXXXXX put --file "d:\MSSQL\Backup\MyDatabase_copy.bak" --path "/transfer" --delsrc

// Помещает файлы, указанные в списке "MyDatabase_copy.split" на Yandex-диск
cpdb yadisk --token XXXXXXXXXXXXXXXXXXXXXXXXXXXXX put --list "d:\MSSQL\Backup\MyDatabase_copy.split" --path "/transfer" --delsrc

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

Параметры:
--params	- Файлы JSON содержащие значения параметров, могут быть указаны несколько файлов разделенные ";" (параметры командной строки имеют более высокий приоритет)
--path	- Путь к локальному каталогу для сохранения загруженных файлов
--file	- Путь к файлу на Yandex-Диск для загрузки
--list	- Путь к файлу на Yandex-Диск со списком файлов, которые будут загружены (параметр --file игнорируется)
--delsrc	- Удалить файлы из Yandex-Диск после получения

Пример

// Получает файл "MyDatabase_copy.bak" из Yandex-диска
cpdb yadisk --token XXXXXXXXXXXXXXXXXXXXXXXXXXXXX get --path "d:\MSSQL\Backup\MyDatabase_copy.bak" --file "/transfer/MyDatabase_copy.bak" --delsrc

// Получает файлы, указанные в списке "MyDatabase_copy.split" из Yandex-диска
cpdb yadisk --token XXXXXXXXXXXXXXXXXXXXXXXXXXXXX get --path "d:\MSSQL\Backup\" --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 запрашивает доступ к вашим данным на Яндексе" ответить "Разрешить": после этого на экране появится сформированный токен

nextcloud - Группа команд работы с сервисом NextCloud

Общие параметры для команд группы:
--srvr	- Адрес сервиса NextCloud
--user	- Имя пользователя сервиса NextCloud
--pwd	- Пароль пользователя сервиса NextCloud

put - Помещение файла в сервис NextCloud

Параметры:
--params	- Файлы JSON содержащие значения параметров, могут быть указаны несколько файлов разделенные ";" (параметры командной строки имеют более высокий приоритет)
--file	- Путь к локальному файлу для помещения в сервис NextCloud
--list	- Путь к локальному файлу со списком файлов, которые будут помещены в сервис NextCloud (параметр --file игнорируется)
--path	- Путь к каталогу в сервисе NextCloud, куда помещать загружаемые файлы
--replace	- Перезаписать файл в сервисе NextCloud при загрузке
--delsrc	- Удалить исходные файлы после отправки

Пример

// Помещает файл "MyDatabase_copy.bak" в сервис NextCloud
cpdb nextcloud --service "http://MyNextCloud" --user "admin" --pwd "P@$$w0rd" put --file "d:\MSSQL\Backup\MyDatabase_copy.bak" --path "/transfer" --delsrc

// Помещает файлы, указанные в списке "MyDatabase_copy.split" в сервис NextCloud
cpdb nextcloud --service "http://MyNextCloud" --user "admin" --pwd "P@$$w0rd" put --list "d:\MSSQL\Backup\MyDatabase_copy.split" --path "/transfer" --delsrc

get - Получение файла из сервиса NextCloud

Параметры:
--params	- Файлы JSON содержащие значения параметров, могут быть указаны несколько файлов разделенные ";" (параметры командной строки имеют более высокий приоритет)
--path	- Путь к локальному каталогу для сохранения загруженных файлов
--file	- Путь к файлу в сервисе NextCloud для загрузки
--list	- Путь к файлу в сервисе NextCloud со списком файлов, которые будут загружены (параметр --file игнорируется)
--delsrc	- Удалить файлы из сервиса NextCloud после получения

Пример

// Получает файл "MyDatabase_copy.bak" из сервиса NextCloud
cpdb nextcloud --service "http://MyNextCloud" --user "admin" --pwd "P@$$w0rd" get --path "d:\MSSQL\Backup\MyDatabase_copy.bak" --file "/transfer/MyDatabase_copy.bak" --delsrc

// Получает файлы, указанные в списке "MyDatabase_copy.split" из сервиса NextCloud
cpdb nextcloud --service "http://MyNextCloud" --user "admin" --pwd "P@$$w0rd" get --path "d:\MSSQL\Backup\" --list "/transfer/MyDatabase_copy.split" -delsrc

sftp - Группа команд работы с SFTP-сервером

Общие параметры для команд группы:
--srvr	- Адрес сервера SFTP в виде `<адрес>:<порт>`
--port	- Порт сервера SFTP
--user	- Имя пользователя сервера SFTP
--pwd	- Пароль пользователя сервера SFTP, если указан параметр --key-file, то используется как пароль для доступа к закрытому ключу
--key-file	- Путь к файлу закрытого ключа, если указано, то параметр --pwd интерпретируется как пароль к закрытому ключу

put - Помещение файла на сервер SFTP

Параметры:
--params	- Файлы JSON содержащие значения параметров, могут быть указаны несколько файлов разделенные ";" (параметры командной строки имеют более высокий приоритет)
--file	- Путь к локальному файлу для помещения на сервер SFTP
--list	- Путь к локальному файлу со списком файлов, которые будут помещены на сервер SFTP (параметр --file игнорируется)
--path	- Путь к каталогу на сервере SFTP, куда помещать загружаемые файлы
--replace	- Перезаписать файл на сервере SFTP при загрузке
--delsrc	- Удалить исходные файлы после отправки

Пример

// Помещает файл "MyDatabase_copy.bak" на сервере SFTP
cpdb sftp --server "sftp.myServer.org" --port 22 --user "admin" --pwd "P@$$w0rd" put --file "d:\MSSQL\Backup\MyDatabase_copy.bak" --path "/transfer" --delsrc

// Помещает файлы, указанные в списке "MyDatabase_copy.split" на сервере SFTP
cpdb sftp --server "sftp.myServer.org" --port 22 --user "admin" --pwd "P@$$w0rd" put --list "d:\MSSQL\Backup\MyDatabase_copy.split" --path "/transfer" --delsrc

get - Получение файла с сервера SFTP

Параметры:
--params	- Файлы JSON содержащие значения параметров, могут быть указаны несколько файлов разделенные ";" (параметры командной строки имеют более высокий приоритет)
--path	- Путь к локальному каталогу для сохранения загруженных файлов
--file	- Путь к файлу на сервере SFTP для загрузки
--list	- Путь к файлу на сервере SFTP со списком файлов, которые будут загружены (параметр --file игнорируется)
--delsrc	- Удалить файлы с сервера SFTP после получения

Пример

// Получает файл "MyDatabase_copy.bak" с сервера SFTP
cpdb sftp --server "sftp.myServer.org" --port 22 --user "user" --pwd "P@$$w0rd" get --path "d:\MSSQL\Backup\MyDatabase_copy.bak" --file "/transfer/MyDatabase_copy.bak" --delsrc

// Получает файлы, указанные в списке "MyDatabase_copy.split" с сервера SFTP
cpdb sftp --server "sftp.myServer.org" --port 22 --user "user" --pwd "P@$$w0rd" get --path "d:\MSSQL\Backup\" --list "/transfer/MyDatabase_copy.split" -delsrc

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

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

Параметры:
<Сценарии>	- Файлы JSON содержащие команды и значения параметров, могут быть указаны несколько файлов разделенные "";"" (обработка файлов выполняется в порядке следования)

Пример

cpdb batch "./rest_TST_DB_MyDomain.json"

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

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

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

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

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

Переменные окружения конвейера
src_db_cred	- Идентификатор credentials для доступа к MS SQL в системе, где расположена база-источник
src_agent_label	- Метка агента Jenkins в системе, где расположена база-источник
src_server_name	- Имя сервера MS SQL в системе-источнике
src_db_name	- Имя базы-источника
src_bak_path	- Путь к каталогу резервной копии в системе-источнике

bak_file_name	- Имя файла резервной копии
list_file_name	- Имя файла списка томов архива

storage_token	- Token для доступа к Yandex-Диску
storage_path	- Путь к каталогу на Yandex-Диск для передачи файлов в систему-приемник

dst_db_cred	- Идентификатор credentials для доступа к MS SQL в системе-приемнике
dst_agent_label	- Метка агента Jenkins в системе, где расположена база-приемник
dst_bak_path	- Путь к каталогу резервной копии в системе-приемнике, в который будут загружены файлы из Yandex-Диска
dst_server_name	- Имя сервера MS SQL в системе-приемнике
dst_db_name	- Имя базы-приемника
dst_dbo	- Имя пользователя-владельца базы в системе-приемнике (dbowner)
dst_db_path	- Путь к каталогу размещения файлов данных базы-приемника
dst_log_path	- Путь к каталогу размещения файлов журнала базы-приемника
dst_ib_agent_label	- Метка агента Jenkins в системе, где выполняется подключение к хранилищу конфигурации
dst_ib_con_string	- Строка подключения к информационной базе, подключаемой к хранилищу
dst_ib_cred	- Идентификатор credentials для доступа к информационной базе
dst_ib_storage_adr	- Адрес хранилища конфигурации
dst_ib_storage_cred	- Идентификатор credentials для подключения к хранилищу конфигурации

Прграммный интерфейс библиотеки (API)

Класс РаботаССУБД

Подключение = Новый ПодключениеMSSQL("MyServer", "user", "P@ssw0rd);
РаботаССУБД = Новый РаботаССУБД(Подключение);

Функция БазаСуществует() - проверяет существование базу на сервере СУБД

Параметры:
База	Строка	имя базы данных

Возвращаемое значение: Булево - Истина - база существует

Функция СписокБаз() - получает список баз с сервера СУБД

Параметры:
ФильтрБазПоИмени	Строка	имя базы данных
ФильтрПоТаблице	Строка	имя таблицы базы данных
ВключаяСистемные	Строка	имя таблицы базы данных

Возвращаемое значение: Соответствие Из Структура - список баз на сервере СУБД

* Имя                   - Строка    - имя базы данных
* Ид                    - Число     - идентификатор базы данных
* ИдСоздателя           - Число     - идентификатор пользователя, создавшего базу
* Статус1               - Число     - флаги состояния базы данных
* Статус2               - Число     - флаги состояния базы данных
* ДатаСоздания          - Дата      - дата создания базы данных
* РежимСовместимости    - Число     - версия режима совместимости базы
* ФайлДанных            - Строка    - путь к файлу данных

Функция ТаблицаСуществует() - проверяет существование таблицы в базе на сервере СУБД

Параметры:
База	Строка	имя базы данных
Таблица	Строка	имя таблицы базы данных

Возвращаемое значение: Булево - Истина - таблица существует в базе данных

Процедура СоздатьБазуДанных() - создает базу данных

Параметры:
База	Строка	имя базы данных
МодельВосстановления	Строка	модель восстановления (FULL, SIMPLE, BULK_LOGGED)
ПутьККаталогу	Строка	путь к каталогу для размещения файлов базы данных если не указан, то файлы размещаются в каталоге по умолчанию SQL Server

Процедура УдалитьБазуДанных() - удаляет базу данных

Параметры:
База	Строка	имя базы данных

Процедура ВыполнитьрезервноеКопирование() - выполняет резервное копирование базы

Параметры:
База	Строка	имя базы данных
ПутьКРезервнойКопии	Строка	путь к файлу резервной копии

Процедура ВыполнитьВосстановление() - выполняет восстановление базы из резервной копии

Параметры:
База	Строка	имя базы данных
ПутьКРезервнойКопии	Строка	путь к файлу резервной копии
ПутьКФайлуДанных	Строка	путь к файлу данных базы
ПутьКФайлуЖурнала	Строка	путь к файлу журнала транзакций базы
СоздаватьБазу	Булево	Истина - создать базу в случае отсутствия

Функция ПолучитьОписание() - получает описание базы данных

Параметры:
База	Структура	описание базы данных

Возвращаемое значение: Структура - описание базы данных

* Имя                                   - Строка  - имя базы данных (name)
* Ид                                    - Число   - числовой идентификатор базы (database_id)
* ФизическоеИмя                         - Строка  - физическое имя базы (physical_database_name)
* Владелец                              - Строка  - пользователь - владелец базы (db owner)
* ДатаСоздания                          - Дата    - дата создания базы (create_date)
* РежимСовместимости                    - Число   - режим совместимости базы (версия MS SQL)
                                                    (compatibility_level)
* ЯзыковыеУстановки                     - Строка  - используемые языковые установки (collation_name)
* РежимДоступа                          - Булево  - режим пользовательского доступа к базе
                                                    (SINGLE_USER, MULTI_USER) (user_access_desc)
* ТолькоДляЧтения                       - Булево  - флаг режима только для чтения (is_read_only)
* Состояние                             - Строка  - состояние базы (ONLINE, OFFLINE) (state_desc)
* РежимОжидания                         - Булево  - флаг нахождения базы в режиме ожидания (is_in_standby)
* РежимИзоляцииСнимков                  - Булево  - флаг использования режима изоляции снимков
                                                    (snapshot_isolation_state)
* РежимФиксированногоЧтенияСнимков      - Булево  - флаг использования фиксированного чтения снимков
                                                    (is_read_committed_snapshot_on)
* МодельВосстановления                  - Строка  - модель восстановления базы (FULL, SIMPLE, BULK_LOGGED)
                                                    (recovery_model_desc)
* АвтоСозданиеСтатистики                - Булево  - флаг автоматического создания статистики
                                                    (is_auto_create_stats_on)
* АвтоСозданиеСтатистикиИнкрементально  - Булево  - флаг автоматического инкрементального создания статистики
                                                    (is_auto_create_stats_incremental_on)
* АвтоОбновлениеСтатистики              - Булево  - флаг автоматического обновления статистики
                                                    (is_auto_update_stats_on)
* АвтоОбновлениеСтатистикиАсинх         - Булево  - флаг автоматического асинхронного обновления статистики
                                                    (is_auto_update_stats_async_on)
* ПолнотекстовыйПоиск                   - Булево  - флаг использования полнотекстового поиска
                                                    (is_fulltext_enabled)
* Шифрование                            - Булево  - флаг использования шифрования базы (is_encrypted)

Процедура УстановитьОднопользовательскийРежимБазы() - переводит базу данных в однопользовательский режим

Параметры:
База	Строка	имя базы данных

Процедура УстановитьМногопользовательскийРежимБазы() - переводит базу данных в многопользовательский режим

Параметры:
База	Строка	имя базы данных

Функция ПолучитьВладельца() - получает текущего владельца базы

Параметры:
База	Строка	имя базы данных

Возвращаемое значение: Строка - имя текущего владельца базы

Процедура ИзменитьВладельца() - устанавливает нового владельца базы

Параметры:
База	Строка	имя базы данных
ВладелецБазы	Строка	новый владелец базы

Процедура ПолучитьМодельВосстановления() - получает модель восстановления базы (FULL, SIMPLE, BULK_LOGGED)

Параметры:
База	Строка	имя базы данных

Возвращаемое значение: Строка - текущая модель восстановления базы

Процедура ИзменитьМодельВосстановления() - устанавливает модель восстановления базы (FULL, SIMPLE, BULK_LOGGED)

Параметры:
База	Строка	имя базы данных
МодельВосстановления	Строка	новая модель восстановления (FULL, SIMPLE, BULK_LOGGED)

Функция ПолучитьЛогическоеИмяФайла() - получает логическое имя файла в базе

Параметры:
База	Строка	имя базы данных
ТипФайла	Строка	ROWS - файл базы; LOG - файл журнала транзакций

Возвращаемое значение: Строка - логическое имя файла в базе данных

Процедура ИзменитьЛогическоеИмяФайла() - устанавливает новое логическое имя файла базы

Параметры:
База	Строка	имя базы данных
Имя	Строка	логическое имя файла для изменения
НовоеИмя	Строка	новое логическое имя файла

Процедура УстановитьЛогическиеИменаФайлов() - устанавливает логические имена файлов в формате

<НовоеИмя> - для файла данных

<НовоеИмя>_log - для файла журнала транзакций

Параметры:
База	Строка	имя базы данных
НовоеИмя	Строка	новое имя файлов, если не указано, то используется имя базы

Процедура ВключитьКомпрессию() - включает компрессию данных базы на уровне страниц

Параметры:
База	Строка	имя базы данных

Процедура СжатьБазу() - выполняет сжатие базы (shrink)

Параметры:
База	Строка	имя базы данных

Процедура СжатьФайлЖурналаТранзакций() - выполняет сжатие файла журнала транзакций (shrink)

Параметры:
База	Строка	имя базы данных

Функция ВыполнитьСкрипты() - выполняет указанные скрипты

Параметры:
СкриптыВыполнения	Строка	пути к файлам скриптов, разделенные ";"
СтрокаПеременных	Строка	набор значений переменных в виде "<Имя>=<Значение>", разделенные ";"

Возвращаемое значение: Строка - результат выполнения скриптов

Функция ВыполнитьЗапрос() - выполняет запрос к СУБД

Параметры:
ТекстЗапроса	Строка	текст исполняемого запроса
Разделитель	Строка	символ - разделитель колонок результата
УбратьПробелы	Булево	Истина - будут убраны выравнивающие пробелы из результата

Возвращаемое значение: Строка - результат выполнения запроса

Модуль РаботаСИБ

Процедура ВыгрузитьИнформационнуюБазуВФайл() - выполняет выгрузку информационной базы в DT-файл

Параметры:
ПараметрыИБ	Структура	параметры подключения к базе 1С
*СтрокаПодключения	Строка	строка подключения к базе 1С
*Пользователь	Строка	имя пользователя базы 1С
*Пароль	Строка	пароль пользователя базы 1С
ПутьКФайлу	Строка	путь к DT-файлу для выгрузки базы 1С
ИспользуемаяВерсияПлатформы	Строка	маска версии 1С
КлючРазрешения	Строка	ключ разрешения входа в заблоrированную серверную базу 1С (/UC)

Процедура ЗагрузитьИнформационнуюБазуИзФайла() - выполняет загрузку информационной базы из DT-файла

Параметры:
ПараметрыИБ	Структура	параметры подключения к базе 1С
*СтрокаПодключения	Строка	строка подключения к базе 1С
*Пользователь	Строка	имя пользователя базы 1С
*Пароль	Строка	пароль пользователя базы 1С
ПутьКФайлу	Строка	путь к DT-файлу для загрузки в базу 1С
КоличествоЗаданий	Число	количество заданий загрузки файла (для клиент-серверной базы, начиная с версии платформы 8.3.19))
ИспользуемаяВерсияПлатформы	Строка	маска версии 1С
КлючРазрешения	Строка	ключ разрешения входа в заблоrированную серверную базу 1С (/UC)

Процедура ОчиститьЛокальныйКэшИнформационнойБазы() - выполняет очистку локального кэша информационной базы 1С

Параметры:
СтрокаПодключения	Строка	строка подключения к базе 1С

Процедура ОчиститьВсеЛокальныеКэшиИнформационныхБаз() - выполняет очистку всех локальных кэшей информационных баз 1С

Параметры:
нет

Процедура ОтключитьОтХранилища() - выполняет отключение информационной базы от хранилища конфигурации

Параметры:
ПараметрыИБ	Структура	параметры подключения к базе 1С
*СтрокаПодключения	Строка	строка подключения к базе 1С
*Пользователь	Строка	имя пользователя базы 1С
*Пароль	Строка	пароль пользователя базы 1С
ИспользуемаяВерсияПлатформы	Строка	маска версии 1С
ИмяРасширения	Строка	имя расширения, отключаемого от хранилища (если не указано, отключается основная конфигурация)
КлючРазрешения	Строка	ключ разрешения входа в заблоrированную серверную базу 1С (/UC)

Процедура ПодключитьКХранилищу() - выполняет подключение информационной базы к хранилищу конфигурации

Параметры:
ПараметрыИБ	Структура	параметры подключения к базе 1С
*СтрокаПодключения	Строка	строка подключения к базе 1С
*Пользователь	Строка	имя пользователя базы 1С
*Пароль	Строка	пароль пользователя базы 1С
ПараметрыХранилища	Структура	параметры подключения к хранилищу конфигурации
*Адрес	Строка	адрес хранилища конфигурации
*Пользователь	Строка	имя пользователя хранилища конфигурации
*Пароль	Строка	пароль пользователя хранилища конфигурации
ИспользуемаяВерсияПлатформы	Строка	маска версии 1С
ИмяРасширения	Строка	имя расширения, отключаемого от хранилища (если не указано, отключается основная конфигурация)
ОбновитьИБ	Булево	Истина - после обновления обновить конфигурацию базы данных
КлючРазрешения	Строка	ключ разрешения входа в заблоrированную серверную базу 1С (/UC)

Процедура СоздатьСервернуюБазу() - создание серверной информационной базы 1С

Параметры:
Параметры1С	Структура	параметры создания базы 1С
*Сервер1С	Строка	адрес кластера серверов 1С ([<протокол>://]<адрес>[:<порт>])
*ИмяИБ	Строка	имя информационной базы на сервере 1С
*РазрешитьВыдачуЛицензий	Булево	Истина - разрешить выдачу лицензий сервером 1С (по умолчанию: Истина)
*РазрешитьРегЗадания	Булево	Истина - разрешить запуск рег. заданий (по умолчанию: Ложь)
ПараметрыСУБД	Структура	параметры подключения к СУБД
*ТипСУБД	Строка	тип сервера СУБД ("MSSQLServer" <по умолчанию>, "PostgreSQL", "IBMDB2", "OracleDatabase")
*СерверСУБД	Строка	адрес сервера СУБД
*ПользовательСУБД	Строка	пользователь сервера СУБД
*ПарольСУБД	Строка	пароль пользователя сервера СУБД
*ИмяБД	Строка	имя базы на сервере СУБД (если не указано будет использовано имя ИБ 1С)
*СмещениеДат	Число	смещение дат на сервере MS SQL (0; 2000 <по умолчанию>)
*СоздаватьБД	Булево	Истина - будет создана база на сервере СУБД в случае отсутствия
АвторизацияВКластере	Структура	параметры авторизации в кластере 1С
*Имя	Строка	имя администратора кластера 1С
*Пароль	Строка	пароль администратора кластера 1С
ИспользуемаяВерсияПлатформы	Строка	маска версии 1С
ОшибкаЕслиСуществует	Булево	Истина - вызвать исключение если ИБ в кластере 1С существует (по умолчанию: Ложь)
ПутьКШаблону	Строка	путь к шаблону для создания информационной базы (.cf; .dt). Если шаблон не указан, то будет создана пустая ИБ
ИмяВСпискеБаз	Строка	имя в списке баз пользователя (если не задано, то ИБ в список не добавляется)

Процедура СоздатьФайловуюБазу() - создание файловой информационной базы 1С

Параметры:
ПутьКБазе	Строка	путь к каталогу базы 1С
ИспользуемаяВерсияПлатформы	Строка	маска версии 1С
ПутьКШаблону	Строка	путь к шаблону для создания информационной базы (.cf; .dt). Если шаблон не указан, то будет создана пустая ИБ
ИмяВСпискеБаз	Строка	имя в списке баз пользователя (если не задано, то ИБ в список не добавляется)

Модуль РаботаСФайлами

Процедура КомандаСистемыКопироватьФайл() - выполняет копирование/перемещение указанных файлов с использованием команд системы (xcopy)

Параметры:
Источник	Строка	копируемые файлы
Приемник	Строка	назначение копирования, каталог или файл
Перемещение	Булево	выполнить перемещение файлов (удалить источник после копирования)
ТолькоСегодня	Булево	копирование файлов, измененных не ранее текущей даты (параметр /D для xcopy)

Процедура КомандаСистемыУдалитьФайл() - выполняет удаление указанных файлов с использованием команды системы (del)

Параметры:
ПутьКФайлу	Строка	путь к удаляемому файлу
ИсключениеПриОшибке	Булево	Истина - вызывать исключение при ошибке удаления

Функция ПрочитатьСписокФайлов() - читает список файлов из файла

Параметры:
ПутьКСписку	Строка	путь к удаляемому файлу
ДобавитьПутьКИсходномуФайлу	Булево	Истина - при чтении добавлять к результату путь к исходному файлу списка
ДобавитьИсходныйФайл	Булево	Истина - добавить исходный файл в список

Возвращаемое значение: Массив из Строка - прочитанный список файлов

Процедура ЗапаковатьВАрхив() - выполняет архиваци указанного файла с разбитием на части указанного размера

Параметры:
ПутьКФайлу	Строка	путь к файлу, который будет архивироваться
ИмяАрхива	Строка	имя файла-архива
ИмяСпискаФайлов	Строка	имя файла-списка (содержащего все чати архива)
РазмерТома	Строка	размер части {, , } (по умолчанию 50m)
СтепеньСжатия	Число	уровень сжатия частей архива {0 - 9} (по умолчанию 0 - не сжимать)
УдалитьИсточник	Булево	Истина - после архивации исходный файл будет удален

Процедура РаспаковатьАрхив() - выполняет выполняет распаковку архива

Параметры:
ПутьКАрхиву	Строка	путь к файлу архива, который будет распаковываться
ЭтоСписокФайлов	Булево	Истина - передан список файлов; Ложь - передан первый том архива
УдалитьИсточник	Булево	Истина - после распаковки исходный файл будет удален

Процедура ПодключитьДиск() - подключает указанный сетевой диск

Параметры:
ИмяУстройства	Строка	имя (буква) подключаемого диска
ИмяРесурса	Строка	сетевой путь к подключаемому ресурсу
Пользователь	Строка	пользователь от имени которого выполняется подключение
ПарольПользователя	Строка	пароль пользователя от имени которого выполняется подключение

Процедура ОтключитьДиск() - отключает указанный сетевой диск

Параметры:
ИмяУстройства	Строка	имя (буква) отключаемого диска

Класс РаботаСЯндексДиск

РаботаСЯндексДиск = Новый РаботаСЯндексДиск(<Токен>);

Параметры:
_Токен	Строка	токен авторизации Yandex-диска

Функция Соединение() - возвращает соединение с Yandex-диском

Параметры:
нет

Возвращаемое значение: ЯндексДиск - соединение с Yandex-диском

Процедура УстановитьПараметрыСоединения() - создает соединение с Yandex-диском с указанными параметрами

Параметры:
_Токен	Строка	токен авторизации Yandex-диска

Процедура СоздатьКаталог() - создает каталог на Yandex-диске

Параметры:
ЦелевойПуть	Строка	путь на yandex-диске к создаваемому каталогу

Процедура ОтправитьФайл() - отправляет файл на Yandex-Диск

Параметры:
ПутьКФайлу	Строка	путь к отправляемому файлу
ЦелевойПуть	Строка	путь на yandex-диске, куда будет загружен файл
Перезаписывать	Булево	перезаписать файл на Яндекс-диске при загрузке

Функция ПолучитьФайл() - получает файл из Yandex-Диска

Параметры:
ПутьКФайлу	Строка	расположение файла на yandex-диске
ЦелевойПуть	Строка	путь, куда будет загружен файл
УдалитьИсточник	Булево	Истина - удалить файл после загрузки

Возвращаемое значение: Число - код возврата команды

Функция Существует() - проверка существования файла / каталога на Yandex-Диске

Не реализовано

Параметры:
ПутьКФайлу	Строка	расположение файла на yandex-диске

Возвращаемое значение: Булево - Истина - файл / каталог существует

Процедура Удалить() - удаляет файл из Yandex-Диска

Параметры:
ПутьКФайлу	Строка	расположение файла на yandex-диске

Класс РаботаСNextCloud

РаботаСNextCloud = Новый РаботаСNextCloud("http://MyNextCloudServer:8080", "user", "P@ssw0rd");

Функция Адрес() - возвращает адрес сервера NextCloud

Возвращаемое значение: Строка - адрес сервера NextCloud

Функция Пользователь() - возвращает имя пользователя сервера NextCloud

Возвращаемое значение: Строка - имя пользователя сервера NextCloud

Функция Соединение() - возвращает соединение с сервером NextCloud

Возвращаемое значение: ПодключениеNextCloud - соединение с сервером NextCloud

Процедура УстановитьПараметрыСоединения() - создает соединение с сервером NextCloud с указанными параметрами

Параметры:
_Адрес	Строка	адрес сервера NextCloud
_Пользователь	Строка	имя пользователя сервера NextCloud
Пароль	Строка	пароль пользователя сервера NextCloud

Процедура СоздатьКаталог() - создает каталог в сервисе NextCloud

Параметры:
ЦелевойПуть	Строка	путь к создаваемому каталогу

Процедура ОтправитьФайл() - отправляет файл в сервис NextCloud

Параметры:
ПутьКФайлу	Строка	путь к отправляемому файлу
ЦелевойПуть	Строка	путь к каталогу в сервисе NextCloud, куда будет загружен файл
Перезаписывать	Булево	перезаписать файл в сервисе NextCloud при загрузке

Функция ПолучитьФайл() - получает файл из сервиса NextCloud

Параметры:
ПутьКФайлу	Строка	расположение файла на сервисе NextCloud
ЦелевойКаталог	Строка	путь к каталогу, куда будет загружен файл
УдалитьИсточник	Булево	Истина - удалить файл после загрузки

Возвращаемое значение: Строка - путь к полученному файлу

Функция Существует() - проверяет существование файла / каталога в сервиса NextCloud

Параметры:
ПутьНаДиске	Строка	расположение файла на сервисе NextCloud

Возвращаемое значение: Булево - Истина - файл / каталог существует

Процедура Удалить() - удаляет файл из сервиса NextCloud

Параметры:
ПутьНаДиске	Строка	расположение файла на сервисе NextCloud

Класс РаботаСSFTP

РаботаСSFTP = Новый РаботаСSFTP("MySFTPServer:2222", "user", "P@ssw0rd");

Функция Адрес() - возвращает адрес сервера SSH

Возвращаемое значение: Строка - адрес сервера SSH

Функция Пользователь() - возвращает имя пользователя сервера SSH

Возвращаемое значение: Строка - имя пользователя сервера SSH

Функция Соединение() - возвращает соединение с сервером SSH

Возвращаемое значение: КлиентSSH - соединение с сервером SSH

Процедура УстановитьПараметрыСоединения() - создает соединение с сервером SSH с указанными параметрами

Параметры:
_Адрес	Строка	адрес сервера SSH
_Пользователь	Строка	имя пользователя сервера SSH
ПутьККлючу	Строка	путь к файлу закрытого ключа сервера SSH

Процедура СоздатьКаталог() - каталог на сервере SFTP

Параметры:
ЦелевойПуть	Строка	путь к создаваемому каталогу

Процедура ОтправитьФайл() - отправляет файл в сервис NextCloud

Параметры:
ПутьКФайлу	Строка	путь к отправляемому файлу
ЦелевойПуть	Строка	путь к каталогу на сервере SFTP, куда будет загружен файл
Перезаписывать	Булево	перезаписать файл на сервере SFTP при загрузке

Функция ПолучитьФайл() - получает файл с сервера SFTP

Параметры:
ПутьКФайлу	Строка	расположение файла на сервере SFTP
ЦелевойКаталог	Строка	путь к каталогу, куда будет загружен файл
УдалитьИсточник	Булево	Истина - удалить файл после загрузки

Возвращаемое значение: Строка - путь к полученному файлу

Функция Существует() - проверяет существование файла / каталога на сервере SFTP

Параметры:
ПутьНаДиске	Строка	расположение файла на сервере SFTP

Возвращаемое значение: Булево - Истина - файл / каталог существует

Процедура УдалитьФайл() - удаляет файл с сервера SFTP

Параметры:
ПутьНаДиске	Строка	расположение файла на сервере SFTP

Процедура УдалитьКаталог() - удаляет каталог с сервера SFTP

Параметры:
ПутьНаДиске	Строка	расположение каталога на сервере SFTP

Класс СтруктураХраненияИБ

СтруктураИБ = Новый СтруктураХраненияИБ();

Функция ВерсияФорматаКонфигурации() - возвращает версию формата конфигурации

Параметры:
нет

Возвращаемое значение: Структура - информация о версии формата конфигурации

* Версия                      - Число     - номер версии формата конфигурации
* ТребуемаяВерсияПлатформы    - Строка    - минимальная версия платформы 1С

Функция ОписаниеКонфигурации() - возвращает описание конфигурации

Параметры:
нет

Возвращаемое значение: Структура - описание конфигурации

* Имя                             - Строка    - имя конфигурации
* Синоним                         - Строка    - синоним конфигурации
* Версия                          - Строка    - версия конфигурации
* РежимСовместимости              - Строка    - версия режима совместимости конфигурации
* КраткаяИнформация               - Строка    - краткая информация о конфигурации
* ПодробнаяИнформация             - Строка    - подробная информация о конфигурации
* Поставщик                       - Строка    - поставщик конфигурации
* АвторскиеПрава                  - Строка    - данные об авторских правах
* АдресИнформацииОПоставщике      - Строка    - адрес сайта с информацией о поставщике
* АдресИнформацииОКонфигурации    - Строка    - адрес сайта с информацией о конфигурации
* АдресКаталогаОбновлений         - Строка    - адрес сайта с каталогом обновлений

Функция ОписаниеМетаданныхОбъектаБД1С() - возвращает описание метаданных 1С для объекта СУБД по его имени

Параметры:
ИмяОбъекта	Строка	имя таблицы или поля таблицы СУБД

Возвращаемое значение: Структура - описание метаданных 1С по имени объекта СУБД

* Владелец               - Структура    - структура описания объекта владельца
* Тип                    - Строка       - тип объекта или коллекция
                                          (например: Справочник, Документ, ТабличнаяЧасть, Поле)
* ТипАнгл                - Строка       - тип объекта или коллекция на английском
                                          (например: Reference, Document, TabularSection, Field)
* Назначение             - Строка       - назначение таблицы БД (например: Основная, Итоги, Обороты)
* Имя                    - Строка       - имя объекта в БД (Префикс + Индекс)
* Префикс                - Строка       - префикс объекта (например: Reference, Document, VT, Fld))
* Индекс                 - Число        - числовой индекс объекта
* Суффикс                - Строка       - дополнительный суффикс имени объекта (например: "_RRef")
* Ид                     - Строка       - UUID объекта 1С
* ИмяМетаданных          - Строка       - имя метаданных 1С
* ПолноеИмяМетаданных    - Строка       - имя метаданных 1С

Функция ОписаниеМетаданныхОбъектовБД1С() - возвращает описание метаданных 1С для таблиц и полей таблиц СУБД

Параметры:
ДобавлятьКолонки	Булево	Истина - будет добавлена информация для колонок таблиц

Возвращаемое значение: Соответствие - соответствия имен таблиц СУБД и полных имен метаданных 1С описаниям объектов метаданных (см. ОписаниеМетаданныхОбъектаБД1С)

Функция ЗанимаемоеМесто() - возвращает описание занимаеиого места в базе MS SQL Server

Параметры:
нет

Возвращаемое значение: Структура - описание занимаего места

* РазмерБазы         - Число    - размер текущей базы данных в байтах, включает файлы данных и журналов
* Свободно           - Число    - место в базе данных, не зарезервированное для объектов базы данных
* Зарезервировано    - Число    - общий объем, выделенный объектам в базе данных
* Данные             - Число    - зарезервированный объем, используемый данными
* Индексы            - Число    - зарезервированный объем, используемый индексами
* НеИспользуется     - Число    - объем, зарезервированный для объектов в базе данных,
                                  но пока не используемый
* ЖурналВсего        - Число    - полный объем журнала транзакций
* ЖурналИспользуется - Число    - используемый объем журнала транзакций

Функция ПоказателиИспользованияТаблицБазы() - возвращает список таблиц в базе MS SQL Server и их показатели использования

Параметры:
ФильтрТаблицПоИмени	Строка	фильтр имен таблиц в формате для оператора "LIKE"
СтатистикаОпераций	Булево	Истина - в результат будет включена статистика по операциям с таблицами (для больших баз - может занять много времени)

Возвращаемое значение: Массив из Структура - таблицы и показатели использования

* Таблица                 - Строка    - имя таблицы
* КоличествоСтрок         - Число     - количество строк в таблице
* ВсегоЗанято             - Число     - общий объем заниаемого места (байт)
* Используется            - Число     - объем, используемый данными (байт)
* НеИспользуется          - Число     - не используемый объем (байт)
* ОперацийЧтения          - Число     - количество операций чтения (read)
* ОперацийВыборки         - Число     - количество операций выборки (select)
* ОперацийСканирования    - Число     - количество операций сканирования (scan)
* ОперацийПоиска          - Число     - количество операций поиска (seek)
* ОперацийЗаписи          - Число     - количество операций записи (write)

Запуск тестов

Необходимые настройки

Для тестирования подключения / отключения сетевого диска требуются дополнительные настройки.

В реестре в ключе HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters указать:

BasicAuthLevel : 0x00000002 (2)

В реестре в ключе HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Session Manager указать:

ProtectionMode : 0x00000000 (0)

Для тестирования работы с базами MS SQL пользователю, под которым выполняется вход на сервер необходимо назначить роль sysadmin

Выполнение тестов

Запуск и остановка окружения выполняются автоматически.

./tools/runtests.bat

Запуск окружения

Для выполнения отладки

./tools/startenv.bat

Остановка окружения

После выполнения отладки

./tools/stopenv.bat

Name		Name	Last commit message	Last commit date
Latest commit History 473 Commits
.github/workflows		.github/workflows
.vscode		.vscode
scripts		scripts
src		src
tasks		tasks
tests		tests
tools		tools
.gitattributes		.gitattributes
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
lib.config		lib.config
packagedef		packagedef
sonar-project.properties		sonar-project.properties

License

Borisskin/cpdb

Folders and files

Latest commit

History

Repository files navigation

1C Database copier (cpdb)

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

Команды приложения

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

database - Группа команд работы с СУБД

create - Создание базы MS SQL

Пример

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

Пример

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

Пример

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

Пример

drop - Удаление базы MS SQL

Пример

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

Пример

Пример config_error.sql

Пример print_message.sql

infobase - Группа команд работы с информационной базой 1С

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

Пример

create-file-ib - Создать файловую информационную базу 1С

Пример

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

Пример

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

Пример

clearcache - Очистить локальный кэш информационных баз 1С

Пример

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

Пример

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

Пример

file - Группа команд работы с файлами

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

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

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

Пример

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

Пример

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

Пример

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

Пример

yadisk - Группа команд работы с сервисом Yandex-Диск

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

Пример

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

Пример

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

nextcloud - Группа команд работы с сервисом NextCloud

put - Помещение файла в сервис NextCloud

Пример

get - Получение файла из сервиса NextCloud

Пример

sftp - Группа команд работы с SFTP-сервером

put - Помещение файла на сервер SFTP

Пример

get - Получение файла с сервера SFTP

Пример

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

Пример

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

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

Прграммный интерфейс библиотеки (API)

Класс РаботаССУБД

Функция БазаСуществует() - проверяет существование базу на сервере СУБД

Функция СписокБаз() - получает список баз с сервера СУБД

Функция ТаблицаСуществует() - проверяет существование таблицы в базе на сервере СУБД

Процедура СоздатьБазуДанных() - создает базу данных

Процедура УдалитьБазуДанных() - удаляет базу данных

Процедура ВыполнитьрезервноеКопирование() - выполняет резервное копирование базы

Процедура ВыполнитьВосстановление() - выполняет восстановление базы из резервной копии