sys.sp_changedistpublisher(Transact-SQL)

適用於:SQL ServerAzureSQL Managed Instance

變更散發發行者的屬性。 此預存程式會在任何資料庫的散發者端執行。

Transact-SQL 語法慣例

語法

sys.sp_changedistpublisher
    [ @publisher = ] N'publisher'
    [ , [ @property = ] N'property' ]
    [ , [ @value = ] N'value' ]
[ ; ]

引數

[ @publisher = ] N'publisher'

發行者名稱。 @publisher 是 sysname,沒有預設值。

[ @property = ] N'property'

要變更指定發行者的屬性。 @property 是 sysname,可以是 @value 下表格中的屬性之一。

[ @value = ] N'value'

指定屬性的值。 @value 為 nvarchar(255),可以是下表中的其中一個值。

注意

Azure 上的發行者和散發者資料庫 SQL 資料庫 需要 SQL 受管理執行個體。 如需詳細資訊,請參閱 複寫至 Azure SQL 資料庫。

下表描述 Publishers 的屬性和這些屬性的值。

屬性 值 描述
active true 啟動發行者。
false 停用發行者
distribution_db 散發資料庫的名稱。
login 登入名稱。
password 所提供登入的強密碼。
security_mode 1 5 連線至 Publisher 時,請使用經銷商的預設管理身份進行 Microsoft Entra 受管身份驗證。 僅適用於交易複寫中,當 Distributor 與 Publisher 皆為 Azure SQL 受控執行個體 資源時。
1 連接到發行者時,請使用 Windows 驗證。
0 連接到發行者時,請使用 SQL Server 驗證。
working_directory 用來儲存發行集數據和架構檔案的工作目錄。
NULL (預設) 所有可用的 @property 選項皆已列印。
storage_connection_string 存取金鑰 當資料庫 Azure SQL 受控執行個體 時,工作目錄的存取金鑰。

1 對於非 SQL Server 發佈者,此設定無法更改。

傳回碼值

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

備註

sp_changedistpublisher 用於所有類型的複製。

如果您要變更 working_directory 屬性,而且 storage_connection_string 必須更新 屬性,請藉由更新 working_directory 屬性,然後更新 屬性,然後執行 storage_connection_string 預存程式,反之亦然。

權限

只有系統管理員固定伺服器角色的成員才能執行 sp_changedistpublisher。