適用於：
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 執行個體。 指定的伺服器執行個體會視指定哪一項記錄傳送作業而定。 對於 -backup， instance_name 必須是日誌傳送配置中主要伺服器的名稱。 對於 -copy 或 -restore， instance_name 必須是記錄傳送組態中次要伺服器的名稱。
-備份 primary_id
針對主要資料庫執行備份作業，資料庫的主要識別碼是由 primary_id指定。 您可以從 log_shipping_primary_databases 系統資料表選取這個識別碼，或使用 sp_help_log_shipping_primary_database 預存程序取得這個識別碼。
備份作業會在備份目錄中建立記錄備份。 sqllogship 應用程式接著會根據檔案保留期限，清除任何舊的備份檔案。 接下來，應用程式會記錄主要伺服器和監視伺服器的備份作業歷程。 最後，應用程式會執行 sp_cleanup_log_shipping_history，根據保留期限清除舊的記錄資訊。
-複製 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，以根據保留期間清除舊歷程記錄資訊。
-verboselevel 級別
指定要加入記錄傳送記錄的訊息層級。 level 是下列其中一個整數：
| 層級 | 描述 |
|---|---|
0 |
不輸出追蹤和偵錯的訊息。 |
1 |
輸出錯誤處理訊息。 |
2 |
輸出警告和錯誤處理訊息。 |
3 (預設值) |
輸出資訊訊息、警告和錯誤處理訊息。 |
4 |
輸出所有偵錯和追蹤訊息。 |
-登入暫停 timeout_value
指定在嘗試逾時之前，嘗試登入伺服器執行個體所配置的時間量。預設值為 15 秒。 timeout_value 是 int。
-查詢逾時 timeout_value
指定在嘗試啟動指定操作前，分配的時間量，過了就會逾時。預設情況是沒有逾時期限。 timeout_value 是 int。
-connectionoptions「<key_value_pairs>;[ ...n ] ”
適用於：SQL Server 2025（17.x）及更新版本。
以索引鍵值組的形式指定額外的連線選項。
下表列出可用的連線選項：
| Key | 價值觀 |
|---|---|
Encrypt |
strict、mandatory、optional、true、false |
TrustServerCertificate |
true、false、yes、no |
ServerCertificate |
檔案系統上伺服器憑證的路徑。 此選項的長度上限為 260 個字元。 |
HostNameInCertificate |
憑證的主機名稱覆寫。 此選項的長度上限為 255 個字元。 |
備註
盡可能使用備份、複製和還原工作來執行備份、複製和還原。 若要從批次作業或其他應用程式執行這些作業，請呼叫 sp_start_job 預存程序。
由sqllogship創建的日誌傳送歷史會與由日誌傳送備份、複製和還原作業創建的歷史記錄交錯。 如果您要重複使用 sqllogship 對記錄傳送組態執行備份、複製或還原作業，請考慮停用對應的一或多個記錄傳送作業。 如需詳細資訊，請參閱 停用或啟用工作。
sqllogship 應用程式 SqlLogShip.exe已安裝在目錄中<drive>:\Program Files\Microsoft SQL Server\130\Tools\Binn。
權限
sqllogship 使用「Windows 驗證」。 執行命令的 Windows 驗證帳戶必須擁有 Windows 目錄存取權和 SQL Server 權限。 需求取決於 sqllogship 指令是否指定 -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_directory 欄中backup_destination_directory。