приложение sqllogship

Область применения:SQL Server

Приложение sqllogship выполняет операции резервного копирования, копирования или восстановления, а также связанные с ними задачи очистки для конфигурации доставки журналов. Операция выполняется в определенном экземпляре SQL Server для определенной базы данных.

Сведения о соглашениях о синтаксисе см. в служебных программах командной строки SQL (ядро СУБД).

Синтаксис

sqllogship
-server instance_name { -backup primary_id | -copy secondary_id | -restore secondary_id }
[ -verboselevel level ]
[ -logintimeout timeout_value ]
[ -querytimeout timeout_value ]
[ -connectionoptions "<key_value_pairs>; [ ... ]" ]

Аргументы

-сервер instance_name

Указывает экземпляр SQL Server, в котором выполняется операция. Указываемый экземпляр сервера зависит от того, какая операция доставки журналов задается. Для -backupinstance_name должно быть имя основного сервера в конфигурации доставки журналов. Для -copy или -restoreinstance_name должно быть имя вторичного сервера в конфигурации доставки журналов.

-backup primary_id

Выполняет операцию резервного копирования для базы данных-источника, основной идентификатор которой определяется аргументом primary_id. Можно получить этот идентификатор, выбрав его из системной таблицы log_shipping_primary_databases или с помощью хранимой процедуры sp_help_log_shipping_primary_database.

Операция резервного копирования создает резервную копию журналов в каталоге резервного копирования. Затем приложение sqllogship удаляет все старые файлы резервной копии на основе срока их хранения. Далее, программа регистрирует историю операции резервного копирования на основном сервере и сервере мониторинга. Наконец, оно запускает хранимую процедуру sp_cleanup_log_shipping_history, которая удаляет старые данные в журнале на основе срока их хранения.

-copy secondary_id

Выполняет операцию копирования резервных копий с указанного вторичного сервера для вторичной базы данных или баз данных, вторичный идентификатор которых задается аргументом secondary_id. Этот идентификатор можно получить, выбрав его из системной таблицы log_shipping_secondary или используя хранимую процедуру sp_help_log_shipping_secondary_database.

Операция выполняет копирование файлов резервной копии из каталога резервного копирования в целевой каталог. Затем приложение sqllogship ведет журнал истории операции копирования на вторичном сервере и сервере мониторинга.

-восстановить secondary_id

Выполняет операцию восстановления на указанный вторичный сервер для вторичной базы данных или баз данных, чьи вторичные идентификаторы указаны аргументом secondary_id. Этот идентификатор можно получить с помощью хранимой sp_help_log_shipping_secondary_database процедуры.

Все файлы резервной копии в целевом каталоге, созданные после самой последней точки восстановления, восстанавливаются во вторичную базу данных или базы данных. Затем приложение sqllogship удаляет все старые файлы резервной копии на основе срока их хранения. Приложение записывает историю операций восстановления на вторичном сервере и сервере мониторинга. Наконец, приложение запускается sp_cleanup_log_shipping_history, которое очищает старые сведения журнала на основе периода хранения.

-подробный уровень

Определяет уровень сообщений, добавляемых в историю пересылки журналов. level может быть одним из следующих целочисленных значений:

уровень	Описание
0	Не выводить сообщения трассировки и отладки.
1	Выводить сообщения обработки ошибок.
2	Выводить предупреждения и сообщения обработки ошибок.
3 (по умолчанию)	Выводить информационные сообщения, предупреждения и сообщения обработки ошибок.
4	Выводить все сообщения отладки и трассировки.

-logintimeout timeout_value

Указывает время, выделенное для попытки входа в экземпляр сервера до истечения времени ожидания попытки. Значение по умолчанию — 15 секунд. timeout_value имеет значение int.

-querytimeout timeout_value

Указывает время, выделенное для запуска указанной операции до истечения времени ожидания. По умолчанию период ожидания не задан. timeout_value имеет значение int.

-connectionoptions "<key_value_pairs>; [ ... n ] "

Относится к: SQL Server 2025 (17.x) и более поздним версиям.

Задает дополнительные параметры подключения в виде пар "значение ключа".

В следующей таблице перечислены доступные параметры подключения:

Key	Ценность
Encrypt	strict, , mandatoryoptional, truefalse
TrustServerCertificate	true false yes no
ServerCertificate	Путь к файловой системе к сертификату сервера. Этот параметр имеет максимальную длину 260 символов.
HostNameInCertificate	Переопределение имени узла для сертификата. Этот параметр имеет максимальную длину 255 символов.

Замечания

Используйте задания резервного копирования, копирования и восстановления для выполнения резервного копирования, копирования и восстановления, когда это возможно. Для запуска этих задач из пакетной операции или другого приложения, вызовите хранимую процедуру sp_start_job.

История пересылки журналов, созданная программой sqllogship, перемешивается с историей, создаваемой заданиями резервного копирования, копирования и восстановления в журнале пересылки. Если вы планируете многократно использовать sqllogship для выполнения операций резервного копирования, копирования или восстановления в конфигурации доставки журналов, рассмотрите возможность отключения соответствующих заданий доставки журналов. Дополнительные сведения см. в статье Disable or Enable a Job.

Приложение sqllogship , SqlLogShip.exeустанавливается в <drive>:\Program Files\Microsoft SQL Server\130\Tools\Binn каталоге.

Разрешения

sqllogship использует проверку подлинности Windows. Для учетной записи проверки подлинности Windows, в которой выполняется команда, требуется доступ к каталогу Windows и разрешения SQL Server. Требование зависит от того, указывает ли команда -backup параметр , -copyили -restore параметр.

Вариант	Доступ к каталогу	Разрешения
-backup	Требует доступа по чтению и записи в каталог резервной копии.	Требуется те же разрешения, что и инструкция BACKUP . Дополнительные сведения см. в статье BACKUP.
-copy	Требует доступа на чтение к каталогу резервной копии и доступа на запись в каталог копии.	Требует таких же разрешений, что и хранимая процедура sp_help_log_shipping_secondary_database .
-restore	Требуется доступ на чтение и запись в каталог.	Требуется те же разрешения, что и инструкция RESTORE . Дополнительные сведения см. в инструкциях RESTORE.

Чтобы узнать путь к каталогам резервной копии и копирования, можно запустить sp_help_log_shipping_secondary_database хранимую процедуру или просмотреть таблицу log_shipping_secondary в msdb. Пути каталога резервного копирования и целевого каталога находятся в backup_source_directorybackup_destination_directory столбцах соответственно.

Связанный контент

• Сведения о доставке журналов (SQL Server)
• Основные базы данных пересылки журналов (Transact-SQL)
• log_shipping_secondary (Transact-SQL)
• sp_cleanup_log_shipping_history (Transact-SQL)
• sp_help_log_shipping_primary_database (Transact-SQL)
• sp_help_log_shipping_secondary_database (Transact-SQL)
• sp_start_job (Transact-SQL)