共用方式為

sp_changesubscriber (Transact-SQL)

  • 發行項

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

變更訂閱者的選項。 此發行者之訂閱者的任何散發工作都會更新。 這個預存程式會 MSsubscriber_info 寫入散發資料庫中的數據表。 這個預存程式會在發行集資料庫的發行者端執行。

Transact-SQL 語法慣例

語法

sp_changesubscriber
    [ @subscriber = ] N'subscriber'
    [ , [ @type = ] type ]
    [ , [ @login = ] N'login' ]
    [ , [ @password = ] N'password' ]
    [ , [ @commit_batch_size = ] commit_batch_size ]
    [ , [ @status_batch_size = ] status_batch_size ]
    [ , [ @flush_frequency = ] flush_frequency ]
    [ , [ @frequency_type = ] frequency_type ]
    [ , [ @frequency_interval = ] frequency_interval ]
    [ , [ @frequency_relative_interval = ] frequency_relative_interval ]
    [ , [ @frequency_recurrence_factor = ] frequency_recurrence_factor ]
    [ , [ @frequency_subday = ] frequency_subday ]
    [ , [ @frequency_subday_interval = ] frequency_subday_interval ]
    [ , [ @active_start_time_of_day = ] active_start_time_of_day ]
    [ , [ @active_end_time_of_day = ] active_end_time_of_day ]
    [ , [ @active_start_date = ] active_start_date ]
    [ , [ @active_end_date = ] active_end_date ]
    [ , [ @description = ] N'description' ]
    [ , [ @security_mode = ] security_mode ]
    [ , [ @publisher = ] N'publisher' ]
[ ; ]

引數

[ @subscriber = ] N'subscriber'

要變更選項之訂閱者的名稱。 @subscriber為 sysname，沒有預設值。

[ @type = ] type

訂閱者類型。 @type為 tinyint，預設值為 NULL。

  • 0 表示 SQL Server 訂閱者。
  • 1 指定非 SQL Server 或其他 ODBC 資料源伺服器訂閱者。

[ @login = ] N'login'

SQL Server 驗證登入標識碼。 @login為 sysname，預設值為 NULL。

[ @password = ] N'password'

SQL Server 驗證密碼。 @password為 sysname，預設值%為 ，表示密碼屬性沒有變更。

[ @commit_batch_size = ] commit_batch_size

此參數已被取代，而且會維護腳本的回溯相容性。

[ @status_batch_size = ] status_batch_size

此參數已被取代，而且會維護腳本的回溯相容性。

[ @flush_frequency = ] flush_frequency

此參數已被取代，而且會維護腳本的回溯相容性。

[ @frequency_type = ] frequency_type

指定要排程散發工作的頻率。 @frequency_type為 int，而且可以是下列其中一個值。

值 Description
1 一次性
2 [視需要]
4 每日
8 每週
16 每月
32 每月相對
64 自動啟動
128 重複執行

[ @frequency_interval = ] frequency_interval

@frequency_type的間隔。 @frequency_interval為 int，預設值為 NULL。

[ @frequency_relative_interval = ] frequency_relative_interval

散發工作的日期。 當@frequency_type設定為 32 （每月相對） 時，會使用此參數。 @frequency_relative_interval為 int，而且可以是下列其中一個值。

值 Description
1 第一個
2 Second
4 Third
8 第四個
16 最後一個

[ @frequency_recurrence_factor = ] frequency_recurrence_factor

指定散發工作在定義的 @frequency_type期間應該遞歸的頻率。 @frequency_recurrence_factor為 int，預設值為 NULL。

[ @frequency_subday = ] frequency_subday

指定在定義期間重新排程的頻率。 @frequency_subday為 int，而且可以是下列其中一個值。

值 Description
1 一次
2 第二個
4 Minute
8 Hour

[ @frequency_subday_interval = ] frequency_subday_interval

@frequence_subday的間隔。 @frequency_subday_interval 為 int，預設值為 NULL。

[ @active_start_time_of_day = ] active_start_time_of_day

第一次排程散發工作的時間，格式為 HHmmss。 @active_start_time_of_day為 int，預設值為 NULL。

[ @active_end_time_of_day = ] active_end_time_of_day

散發工作停止排程的時間，格式為 HHmmss。 @active_end_time_of_day 為 int，預設值為 NULL。

[ @active_start_date = ] active_start_date

第一次排程散發工作的日期，格式為 yyyyMMdd。 @active_start_date為 int，預設值為 NULL。

[ @active_end_date = ] active_end_date

散發工作停止排程的日期，格式為 yyyyMMdd。 @active_end_date為 int，預設值為 NULL。

[ @description = ] N'description'

選擇性的文字描述。 @description為 nvarchar（255），預設值為 NULL。

[ @security_mode = ] security_mode

實作的安全性模式。 @security_mode為 int，而且可以是下列其中一個值。

值 Description
0 SQL Server 驗證
1 Windows 驗證

[ @publisher = ] N'publisher'

指定非 SQL Server 發行者。 @publisher為 sysname，預設值為 NULL。

變更 SQL Server 發行者上的發行項屬性時，不應使用@publisher。

傳回碼值

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

備註

sp_changesubscriber 用於所有類型的複寫。

權限

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

相關內容