Приложение Sqllogship

2025-04-21

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

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

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

Синтаксис

  
sqllogship -server instance_name { -backup primary_id | -copy secondary_id | -restore secondary_id } [ -verboselevel level ] [ -logintimeout timeout_value ] [ -querytimeout timeout_value ]

Аргументы

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

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

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

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

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

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

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

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

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

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

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

Замечания

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

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

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

Разрешения

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

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

Примечание.

Чтобы выяснить пути к каталогам резервной копии и копии, необходимо запустить хранимую процедуру sp_help_log_shipping_secondary_database или просмотреть таблицу log_shipping_secondary в базе данных msdb. Пути к каталогам резервной копии и назначения находятся в столбцах backup_source_directory и backup_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)