PowerShell скрипт для быстрой копии рабочей базы 1С в тестовую через MS SQL (выбор базы из списка, список в файле настроек)
База данных - Инструменты администратора БД
Файлы
ВНИМАНИЕ: Файлы из Базы знаний - это исходный код разработки. Это примеры решения задач, шаблоны, заготовки, "строительные материалы" для учетной системы. Файлы ориентированы на специалистов 1С, которые могут разобраться в коде и оптимизировать программу для запуска в базе данных. Гарантии работоспособности нет. Возврата нет. Технической поддержки нет.
Подписка PRO — скачивайте любые файлы со скидкой до 85% из Базы знаний
Оформите подписку на компанию для решения рабочих задач
Оформить подписку и скачать решение со скидкойВы можете заказать платную доработку или адаптацию этой разработки под вашу конфигурацию на «Бирже заказов».
- 0% комиссии — оплата напрямую исполнителю;
- Исполнители любого масштаба — от отдельных специалистов до команд под проект;
- Прямой обмен контактами между заказчиком и исполнителем;
- Безопасная сделка — при необходимости;
- Рейтинги, кейсы и прозрачная система откликов.
Суть
Выбрали базу из списка - Enter - готова тестовая копия.
Имя копии: имябазы + суффикс из настроек (TestSuffix), настройки в файле JSON.
Без простоя рабочей базы: копия через MS SQL (BACKUP / RESTORE).
Зачем
Нужна свежая тестовая база из рабочей. Копия средствами MS SQL быстрая и не отключает пользователей рабочей базы.
Скрипт:
- выбираете копируемую базу из списка;
- имя копии = имябазы + суффикс из настроек (
TestSuffix); BACKUPкопируемой базы (COPY_ONLY+ сжатие) иRESTORE … REPLACEв приёмник;- если база-приёмник уже есть - спрашивает подтверждение и заменяет.
Примеры имени приёмника:
| Копируемая база | TestSuffix |
Результат |
|---|---|---|
baza1 |
_test |
baza1_test |
baza1 |
_Ivanov |
baza1_Ivanov |
ИБ в кластере 1С скрипт не создаёт и не меняет - предполагается, что база-приёмник уже зарегистрирована.
Требования
- Windows, PowerShell 5.1+;
sqlcmdв PATH (обычно есть на сервере SQL / с SSMS);- запуск на машине, где видны пути SQL (как правило, сам SQL-сервер), под учёткой с правами Windows на
BACKUP/RESTORE; - MS SQL Server (проверялось на 2019);
- файл настроек рядом со скриптом.
Пароли SQL в настройках не нужны: используется Windows-аутентификация (sqlcmd -E).
Состав
Clone-1CTestDb.ps1- скриптClone-1CTestDb.cmd- запуск двойным щелчкомClone-1CTestDb.settings.json- сервер, пути, список копируемых баз
Полные тексты файлов:
#Requires -Version 5.1
# Копия SQL-базы в *_test. Настройки: Clone-1CTestDb.settings.json рядом.
param([string]$SettingsPath = (Join-Path $PSScriptRoot "Clone-1CTestDb.settings.json"))
$ErrorActionPreference = "Stop"
function Invoke-Sql([string]$Server, [string]$Query, [switch]$Capture) {
$sql = [IO.Path]::ChangeExtension([IO.Path]::GetTempFileName(), ".sql")
Set-Content $sql $Query -Encoding ASCII
try {
if ($Capture) {
$out = [IO.Path]::GetTempFileName()
try {
& sqlcmd -S $Server -E -b -W -h -1 -u -i $sql -o $out | Out-Null
if ($LASTEXITCODE) { throw "sqlcmd $LASTEXITCODE`n$((Get-Content $out -Encoding Unicode) -join "`n")" }
return @(Get-Content $out -Encoding Unicode | % Trim | ? { $_ })
} finally { Remove-Item $out -Force -EA SilentlyContinue }
}
& sqlcmd -S $Server -E -b -i $sql
if ($LASTEXITCODE) { throw "sqlcmd $LASTEXITCODE" }
} finally { Remove-Item $sql -Force -EA SilentlyContinue }
}
function Test-Db([string]$S, [string]$N) {
$n = $N.Replace("'", "''")
$r = Invoke-Sql $S "SET NOCOUNT ON;SELECT CASE WHEN EXISTS(SELECT 1 FROM sys.databases WHERE name=N'$n') THEN N'1' ELSE N'0' END" -Capture
$r -and $r[0] -eq "1"
}
if (-not (Test-Path $SettingsPath)) { throw "Нет настроек: $SettingsPath" }
$c = Get-Content $SettingsPath -Raw -Encoding UTF8 | ConvertFrom-Json
$srv, $bakDir, $data, $log = [string]$c.SqlServer, [string]$c.BackupPath, [string]$c.DataPath, [string]$c.LogPath
$suf = if ($c.TestSuffix) { [string]$c.TestSuffix } else { "_test" }
if (-not ($srv -and $bakDir -and $data -and $log -and $c.Databases)) { throw "Проверьте settings.json" }
if (-not (Get-Command sqlcmd -EA SilentlyContinue)) { throw "sqlcmd не в PATH" }
if (-not (Test-Path $bakDir)) { New-Item $bakDir -ItemType Directory -Force | Out-Null }
$sel = @(foreach ($d in $c.Databases) {
[pscustomobject]@{ Caption = $(if ($d.Caption) { $d.Caption } else { $d.Name }); Name = [string]$d.Name; Test = [string]$d.Name + $suf }
}) | Out-GridView -Title "Источник - Приемник" -OutputMode Single
if (-not $sel) { "Отменено."; exit 0 }
$src, $dst = $sel.Name, $sel.Test
Write-Host "`n=== Источник: $src - Приемник: $dst ===" -ForegroundColor Cyan
if (-not (Test-Db $srv $src)) { throw "Нет базы [$src] на $srv" }
$exists = Test-Db $srv $dst
if ($exists -and (Read-Host "База [$dst] уже есть. Заменить из [$src]? (yes/no)") -ne "yes") { "Отменено."; exit 0 }
$bak = Join-Path $bakDir ("{0}_to_{1}_{2}.bak" -f $src, $dst, (Get-Date -Format "yyyyMMdd_HHmmss"))
$mdf, $ldf = (Join-Path $data "$dst.mdf"), (Join-Path $log "$dst`_log.ldf")
$e = { param($s) $s.Replace("'", "''") }
Write-Host "`n=== BACKUP [$src] ===" -ForegroundColor Cyan
Invoke-Sql $srv "BACKUP DATABASE [$src] TO DISK=N'$(& $e $bak)' WITH COPY_ONLY,COMPRESSION,INIT,STATS=10;"
$rows = Invoke-Sql $srv -Capture @"
SET NOCOUNT ON;
DECLARE @f TABLE(LogicalName nvarchar(128),PhysicalName nvarchar(260),Type char(1),FileGroupName nvarchar(128),Size numeric(20,0),MaxSize numeric(20,0),FileId bigint,CreateLSN numeric(25,0),DropLSN numeric(25,0),UniqueId uniqueidentifier,ReadOnlyLSN numeric(25,0),ReadWriteLSN numeric(25,0),BackupSizeInBytes bigint,SourceBlockSize int,FileGroupId int,LogGroupGUID uniqueidentifier,DifferentialBaseLSN numeric(25,0),DifferentialBaseGUID uniqueidentifier,IsReadOnly bit,IsPresent bit,TDEThumbprint varbinary(32),SnapshotUrl nvarchar(360));
INSERT INTO @f EXEC('RESTORE FILELISTONLY FROM DISK=N''$(& $e $bak)''');
SELECT LogicalName+NCHAR(9)+Type FROM @f WHERE Type IN (N'D',N'L');
"@
$ld = $null; $ll = $null
foreach ($r in $rows) {
$p = $r -split "`t", 2
if ($p.Count -lt 2) { continue }
if ($p[1] -eq "D" -and -not $ld) { $ld = $p[0] }
if ($p[1] -eq "L" -and -not $ll) { $ll = $p[0] }
}
if (-not ($ld -and $ll)) { throw "Нет логических имён в бэкапе" }
Write-Host "`n=== RESTORE [$dst] ===" -ForegroundColor Cyan
if ($exists) { Invoke-Sql $srv "ALTER DATABASE [$dst] SET SINGLE_USER WITH ROLLBACK IMMEDIATE;" }
try {
Invoke-Sql $srv @"
RESTORE DATABASE [$dst] FROM DISK=N'$(& $e $bak)'
WITH MOVE N'$(& $e $ld)' TO N'$(& $e $mdf)', MOVE N'$(& $e $ll)' TO N'$(& $e $ldf)', REPLACE, RECOVERY, STATS=10;
"@
} catch {
if ($exists) { try { Invoke-Sql $srv "ALTER DATABASE [$dst] SET MULTI_USER;" } catch {} }
throw
}
Invoke-Sql $srv "ALTER DATABASE [$dst] SET MULTI_USER; ALTER DATABASE [$dst] SET RECOVERY SIMPLE;"
Write-Host "`n=== Готово ===" -ForegroundColor Cyan
Write-Host "Источник: $src"
Write-Host "Приемник: $dst"
Write-Host "Бэкап: $bak"
Write-Host "В кластере 1С у [$dst] - блокировка регламентных заданий." -ForegroundColor Yellow
Read-Host "Enter - выход"
Настройка
Откройте Clone-1CTestDb.settings.json и подставьте свои значения (пример - в спойлере выше).
| Поле | Смысл |
|---|---|
SqlServer |
имя инстанса SQL (как в SSMS: SQLSRV01 или SQLSRV01\INSTANCE) |
BackupPath |
каталог для .bak на стороне SQL Server |
DataPath / LogPath |
куда положить .mdf / _log.ldf тестовой базы |
TestSuffix |
суффикс имени копии: к Name добавляется эта строка (_test, _Ivanov, …) |
Databases |
копируемые базы: Name - имя базы в SQL, Caption - подпись в списке. Имя копии = Name + TestSuffix |
Важно: Name - имя в SQL Server (поле «База данных» в свойствах ИБ кластера 1С), а не обязательно имя ИБ в списке кластера.
Пути должны существовать для службы SQL Server. Каталог бэкапов скрипт по возможности создаст сам.
Как пользоваться
- Сохраните файлы (скрипты и настройки) в одну папку на SQL-сервере.
- Отредактируйте
Clone-1CTestDb.settings.json. - Запустите
Clone-1CTestDb.cmd. - В окне выберите копируемую базу - OK (копия =
имя+TestSuffix, напримерbaza1_Ivanov). - Если база-приёмник уже есть - введите
yesдля замены. - Дождитесь BACKUP и RESTORE.
Рабочую базу скрипт не переводит в single-user. Сеансы обрываются только у старой тестовой, если её перезаписывают.
После копирования у тестовой ИБ включите блокировку регламентных заданий.
Что делает скрипт технически
BACKUP … WITH COPY_ONLY, COMPRESSION, INIT- онлайн-копия, цепочку бэкапов не ломает.RESTORE FILELISTONLY- логические имена файлов из.bak.- При необходимости:
ALTER DATABASE [тест] SET SINGLE_USER WITH ROLLBACK IMMEDIATE. RESTORE … WITH MOVE, REPLACE, RECOVERY.MULTI_USER+RECOVERY SIMPLEдля теста.
Файл .bak - снимок копируемой базы. Старый тест при yes перезаписывается.
Ограничения
- Один файл данных + один журнал. Несколько
.ndf- нужна доработкаMOVE. - Не регистрирует ИБ в кластере 1С.
- Не чистит обмены/почту - только напоминает про блокировку регламентов.
- Запускать на сервере SQL; пути в settings - серверные.
Типовые ошибки
«Нет базы [имя] на сервере»
В settings указано имя ИБ кластера, а в SQL база называется иначе.
sqlcmd не найден
Установите Command Line Utilities / запускайте там, где есть SQL Server.
Ошибка путей при RESTORE
DataPath/LogPath/BackupPath должны быть доступны службе SQL Server.
Итог
Список баз в JSON, суффикс в настройках, один клик - свежая копия через SQL без простоя рабочей базы. Тексты файлов - в спойлерах выше.
Вступайте в нашу телеграмм-группу Инфостарт