分享方式：

sp_change_subscription_properties （Transact-SQL）

  • 文章

適用於：SQL Server Azure SQL 受控執行個體

更新提取訂閱的資訊。 這個預存程式會在訂閱資料庫的訂閱者端執行。

Transact-SQL 語法慣例

語法

sp_change_subscription_properties
    [ @publisher = ] N'publisher'
    , [ @publisher_db = ] N'publisher_db'
    , [ @publication = ] N'publication'
    , [ @property = ] N'property'
    , [ @value = ] N'value'
    [ , [ @publication_type = ] publication_type ]
[ ; ]

引數

[ @publisher = ] N'publisher'

發行者的名稱。 @publisher為 sysname，沒有預設值。

[ @publisher_db = ] N'publisher_db'

發行者資料庫的名稱。 @publisher_db為 sysname，沒有預設值。

[ @publication = ] N'publication'

發行集的名稱。 @publication為 sysname，沒有預設值。

[ @property = ] N'property'

要變更的屬性。 @property為 sysname，沒有預設值。

[ @value = ] N'value'

屬性的新值。 @value為 nvarchar（1000），沒有預設值。

[ @publication_type = ] publication_type

指定發行集的復寫類型。 @publication_type為 int，預設值NULL為 ，而且可以是下列其中一個值：

值 Publication type
0 交易式
1 快照式
2 合併
NULL (預設值) 復寫會決定發行集類型。 由於預存程式必須查看多個數據表，因此此選項比提供確切的發行集類型時慢。

下表描述發行項的屬性和這些屬性的值。

屬性 數值 Description
alt_snapshot_folder 指定快照集替代資料夾的位置。 如果設定為 NULL，則會從發行者指定的預設位置挑選快照集檔案。
distrib_job_login 執行代理程式的 Windows 帳戶登入。
distrib_job_password 代理程序執行所在的 Windows 帳戶密碼。
distributor_login 散發者登入。
distributor_password 散發者密碼。
distributor_security_mode 1 連接到散發者時，請使用 Windows 驗證。
0 連接到散發者時，請使用 SQL Server 驗證。
dts_package_name 指定 SQL Server 2000 資料轉換服務 （DTS） 套件的名稱。 只有當發行集是交易式或快照集時，才能指定這個值。
dts_package_password 指定封裝上的密碼。 dts_package_password 是 sysname ，預設值為 NULL，指定密碼屬性維持不變。 只有當發行集是交易式或快照集時，才能指定這個值。

注意： DTS 套件必須具有密碼。
dts_package_location 儲存 DTS 套件的位置。 只有當發行集是交易式或快照集時，才能指定這個值。
dynamic_snapshot_location 指定儲存快照集檔案的資料夾路徑。 只有當發行集是合併式發行集時，才能指定這個值。
ftp_address 此參數已被取代，而且會維護腳本的回溯相容性。
ftp_login 此參數已被取代，而且會維護腳本的回溯相容性。
ftp_password 此參數已被取代，而且會維護腳本的回溯相容性。
ftp_port 此參數已被取代，而且會維護腳本的回溯相容性。
hostname 連接到發行者時所使用的主機名。
internet_login 當使用基本身份驗證連線到裝載 Web 同步處理的 Web 伺服器時，合併代理程式 所使用的登入。
internet_password 當使用基本身份驗證連接到裝載 Web 同步處理的 Web 伺服器時，合併代理程式 所使用的密碼。
internet_security_mode 1 使用 Windows 整合式驗證進行 Web 同步處理。 建議您搭配 Web 同步處理使用基本身份驗證。 如需詳細資訊，請參閱 Configure Web Synchronization。
0 使用 Web 同步處理的基本身份驗證。

注意： Web 同步處理需要與網頁伺服器的 TLS 連線。
internet_timeout Web 同步處理要求到期前，以秒為單位的時間長度。
internet_url 表示 Web 同步處理之復寫接聽程式位置的 URL。
merge_job_login 執行代理程式的 Windows 帳戶登入。
merge_job_password 代理程序執行所在的 Windows 帳戶密碼。
publisher_login 發行者登入。 只有合併式發行集的訂閱才支持變更 publisher_login 。
publisher_password 發行者密碼。 只有合併式發行集的訂閱才支持變更 publisher_password 。
publisher_security_mode 1 連接到發行者時，請使用 Windows 驗證。 只有合併式發行集的訂閱才支持變更 publisher_security_mode 。
0 連接到發行者時，請使用 SQL Server 驗證。
use_ftp true 若要擷取快照集，請使用 FTP，而不是一般通訊協定。
false 使用一般通訊協議來擷取快照集。
use_web_sync true 啟用 Web 同步處理。
false 停用 Web 同步處理。
working_directory 當使用檔案傳輸通訊協定 （FTP） 來傳輸快照集檔案時，用來暫時儲存發行集數據和架構檔案的工作目錄名稱。

傳回碼值

0 (成功) 或 1 (失敗)。

備註

sp_change_subscription_properties 用於所有類型的複寫。

sp_change_subscription_properties 用於提取訂閱。

針對 Oracle 發行者，會忽略 @publisher_db 的值，因為 Oracle 只允許每個伺服器實例一個資料庫。

權限

只有系統管理員固定伺服器角色或db_owner固定資料庫角色的成員才能執行 sp_change_subscription_properties。

相關內容