sp_change_subscription_properties （Transact-SQL）

  • 發行項

適用於：SQL ServerAzure SQL 受控執行個體

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

Transact-SQL 語法慣例

語法

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

引數

[ @publisher = ] 'publisher' 這是發行者的名稱。 publisher 是 sysname，沒有預設值。

[ @publisher_db = ] 'publisher_db' 這是發行者資料庫的名稱。 publisher_db為 sysname，沒有預設值。

[ @publication = ] 'publication' 這是發行集的名稱。 publication 是 sysname，沒有預設值。

[ @property = ] 'property' 這是要變更的屬性。 屬性 為 sysname。

[ @value = ] 'value' 這是屬性的新值。 value 是 nvarchar（1000），沒有預設值。

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

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

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

屬性 數值 Description
alt_snapshot_folder 指定快照集替代資料夾的位置。 如果設定為 NULL，則會從發行者指定的預設位置挑選快照集檔案。
distrib_job_login 登入代理程序執行所在的 Microsoft 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是預設值為 NULL 的 sysname，指定密碼屬性維持不變。

注意：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。

另請參閱

檢視及修改提取訂閱屬性
sp_addmergepullsubscription （Transact-SQL）
sp_addmergepullsubscription_agent (Transact-SQL)
sp_addpullsubscription （Transact-SQL）
sp_addpullsubscription_agent (Transact-SQL)
系統預存程序 (Transact-SQL)