sp_copysubscription (Transact-SQL)
.gif "重要事項") 重要事項 |
|---|
可附加訂閱功能已被取代，未來的版本將會移除它。 這項功能不應該使用在新的開發工作中。 對於使用參數化篩選來進行資料分割的合併式發行集，我們建議您使用資料分割快照集的新功能，這些功能可以簡化大量訂閱的初始化。 如需詳細資訊，請參閱＜含參數化篩選之合併式發行集的快照集＞。 對於未進行資料分割的發行集，您可以用備份來初始化訂閱。 如需詳細資訊，請參閱＜不使用快照集初始化交易式訂閱＞。 |
複製有提取訂閱但沒有發送訂閱的訂閱資料庫。 只能複製單一檔案資料庫。 這個預存程序執行於訂閱資料庫的訂閱者端。
.gif "主題連結圖示")
語法
sp_copysubscription [ @filename = ] 'file_name'
[ , [ @temp_dir = ] 'temp_dir' ]
[ , [ @overwrite_existing_file = ] overwrite_existing_file]
引數
[ @filename =] 'file_name'
這是指定用來儲存資料檔 (.mdf) 複本的完整路徑 (包括檔案名稱) 之字串。 file name 是 nvarchar(260)，沒有預設值。[ @temp_dir=] 'temp_dir'
這是包含暫存檔之目錄的名稱。 temp_dir 是 nvarchar(260)，預設值是 NULL。 如果是 NULL，就會使用 Microsoft SQL Server 預設資料目錄。 目錄應該有足夠的空間來存放組合了所有訂閱者資料庫檔案的檔案大小。[ @overwrite_existing_file=] 'overwrite_existing_file'
這是一個選擇性布林旗標，用來指定是否要覆寫 @filename 所指定之相同名稱的現有檔案。 overwrite_existing_file 是 bit，預設值是 0。 如果是 1，當 @filename 所指定的檔案存在時，會覆寫這個檔案。 如果是 0，當檔案存在時，預存程序會失敗，不會覆寫這個檔案。
傳回碼值
0 (成功) 或 1 (失敗)
備註
sp_copysubscription 用於所有類型的複寫中，以便將訂閱資料庫複製到檔案中，以便作為在訂閱者端套用快照集的替代方案。 資料庫必須設定成只支援提取訂閱。 有適當權限的使用者可以建立訂閱資料庫的副本，再複製、傳輸或利用電子郵件來傳送訂閱檔 (.msf) 到另一個訂閱者，之後，便能在此將它附加成一項訂閱。
所複製的訂閱資料庫大小必須小於 2 GB。
只支援含客訂閱的資料庫使用 sp_copysubscription，當資料庫有伺服器訂閱時，不能執行它。
權限
只有系統管理員 (sysadmin) 固定伺服器角色的成員，才能夠執行 sp_copysubscription。