sp_changesubscriber (Transact-SQL)
サブスクライバーのオプションを変更します。 このパブリッシャーのサブスクライバーに対するディストリビューション タスクはすべて更新されます。 このストアド プロシージャでは、ディストリビューション データベースの MSsubscriber_info テーブルに書き込みが行われます。 このストアド プロシージャは、パブリッシャー側でパブリケーション データベースについて実行されます。
.gif "トピック リンク アイコン")
構文
sp_changesubscriber [ @subscriber= ] 'subscriber'
[ , [ @type= ] type ]
[ , [ @login= ] 'login' ]
[ , [ @password= ] '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= ] 'description' ]
[ , [ @security_mode= ] security_mode ]
[ , [ @publisher = ] 'publisher' ]
引数
[ @subscriber=] 'subscriber'
オプションを変更するサブスクライバーの名前を指定します。 subscriber のデータ型は sysname で、既定値はありません。[ @type=] type
サブスクライバーの種類を指定します。 type のデータ型は tinyint で、既定値は NULL です。 0 は Microsoft SQL Server のサブスクライバーを示します。 1 は、SQL Server 以外のサブスクライバーまたはその他の ODBC データ ソース サーバー サブスクライバーを示します。[ @login=] 'login'
SQL Server 認証のログイン ID を指定します。 login のデータ型は sysname で、既定値は NULL です。[ @password=] '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 で、次のいずれかの値を指定できます。値
説明
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 で、次のいずれかの値を指定できます。値
説明
1
第 1
2
第 2
4
第 3
8
第 4
16
最終
[ @frequency_recurrence_factor=] frequency_recurrence_factor
定義した frequency_type の期間にディストリビューション タスクを定期的に実行する頻度を指定します。 frequency_recurrence_factor のデータ型は int で、既定値は NULL です。[ @frequency_subday=] frequency_subday
定義した期間にスケジュールを組み直す頻度を指定します。 frequency_subday のデータ型は int で、次のいずれかの値を指定できます。値
説明
1
1 回
2
秒
4
分
8
時
[ @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=] 'description'
説明テキストを指定します (省略可能)。 description のデータ型は nvarchar(255) で、既定値は NULL です。[ @security_mode=] security_mode
実装されているセキュリティ モードを指定します。 security_mode のデータ型は int で、次のいずれかの値を指定できます。値
説明
0
SQL Server 認証
1
Windows 認証
[ @publisher= ] 'publisher'
SQL Server 以外のパブリッシャーを指定します。 publisher のデータ型は sysname で、既定値は NULL です。.gif "注意")
注SQL Server パブリッシャーでアーティクルのプロパティを変更する場合は、publisher は使用しないでください。
戻り値
0 (成功) または 1 (失敗)
説明
sp_changesubscriber は、すべての種類のレプリケーションで使用できます。
権限
sp_changesubscriber を実行できるのは、sysadmin 固定サーバー ロールのメンバーだけです。
関連項目
参照
sp_addsubscriber (Transact-SQL)
sp_dropsubscriber (Transact-SQL)
sp_helpdistributiondb (Transact-SQL)