cpdb

1C Database copier (cpdb)

<a id="dependencies"></a> Требуются следующие библиотеки и инструменты

<a id="application"></a> Команды приложения

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

<a id="database"></a> database - Группа команд работы с СУБД

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

Пример

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

Пример

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

Пример

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

Пример

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

Пример

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

Пример

Пример config_error.sql

Пример print_message.sql

<a id="infobase"></a> infobase - Группа команд работы с информационной базой 1С

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

Пример

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

Пример

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

Пример

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

Пример

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

Пример

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

Пример

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

Пример

<a id="file"></a> file - Группа команд работы с файлами

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

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

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

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

Пример

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

Пример

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

Пример

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

Пример

<a id="yadisk"></a> yadisk - Группа команд работы с сервисом Yandex-Диск

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

Пример

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

Пример

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

<a id="nextcloud"></a> nextcloud - Группа команд работы с сервисом NextCloud

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

Пример

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

Пример

<a id="sftp"></a> sftp - Группа команд работы с SFTP-сервером

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

Пример

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

Пример

<a id="batch"></a> batch - Выполнить сценарий

Пример

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

<a id="jenkins"></a> Использование c Jenkins

<a id="library"></a> Прграммный интерфейс библиотеки (API)

<a id="lib-database"></a> Класс РаботаССУБД

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

<a id="lib-infobase"></a> Модуль РаботаСИБ

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

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

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

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

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

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

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

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

<a id="lib-file"></a> Модуль РаботаСФайлами

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

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

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

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

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

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

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

<a id="lib-yadisk"></a> Класс РаботаСЯндексДиск

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

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

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

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

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

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

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

<a id="lib-nextcloud"></a> Класс РаботаСNextCloud

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

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

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

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

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

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

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

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

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

<a id="lib-sftp"></a> Класс РаботаСSFTP

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

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

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

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

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

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

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

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

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

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

<a id="lib-dbstoragestructure"></a> Класс СтруктураХраненияИБ

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

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

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

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

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

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

<a id="testing"></a> Запуск тестов

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

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

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

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