sp_changesubscriber (Transact-SQL)

サブスクライバのオプションを変更します。このパブリッシャのサブスクライバに対するディストリビューション タスクはすべて更新されます。このストアド プロシージャでは、ディストリビューション データベースの MSsubscriber_info テーブルに書き込みが行われます。このストアド プロシージャは、パブリッシャ側でパブリケーション データベースについて実行されます。

Transact-SQL 構文表記規則

構文

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 は MicrosoftSQL 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 です。

  注意
  SQL Server パブリッシャでアーティクルのプロパティを変更する場合は、publisher を使用できません。

戻り値

0 (成功) または 1 (失敗)

説明

sp_changesubscriber は、すべての種類のレプリケーションで使用できます。

権限

sp_changesubscriber を実行できるのは、sysadmin 固定サーバー ロールのメンバだけです。

関連項目

参照

sp_addsubscriber (Transact-SQL)

sp_dropsubscriber (Transact-SQL)

sp_helpdistributiondb (Transact-SQL)

sp_helpserver (Transact-SQL)

sp_helpsubscriberinfo (Transact-SQL)

システム ストアド プロシージャ (Transact-SQL)