sp_setreplfailovermode (Transact-SQL)

適用対象: SQL サーバー

キュー更新をフェールオーバーとして使用して、即時更新が有効になっているサブスクリプションのフェールオーバー操作モードを設定できます。 このストアド プロシージャは、サブスクリプション データベースのサブスクライバーで実行されます。 フェールオーバー モードの詳細については、「 Updatable サブスクリプション - トランザクション レプリケーションの場合」を参照してください。

Transact-SQL 構文表記規則

構文

sp_setreplfailovermode
    [ @publisher = ] N'publisher'
    , [ @publisher_db = ] N'publisher_db'
    , [ @publication = ] N'publication'
    , [ @failover_mode = ] N'failover_mode'
    [ , [ @override = ] override ]
[ ; ]

引数

[ @publisher = ] N'publisher'

出版物の名前。 @publisher は sysname で、既定値はありません。 パブリケーションは既に存在している必要があります。

[ @publisher_db = ] N'publisher_db'

パブリケーション データベースの名前。 @publisher_db は sysname で、既定値はありません。

[ @publication = ] N'publication'

出版物の名前。 @publication は sysname で、既定値はありません。

[ @failover_mode = ] N'failover_mode'

サブスクリプションのフェールオーバー モード。 @failover_mode は nvarchar(10)であり、これらの値のいずれかを指定できます。

Value	説明
immediate または sync	サブスクライバーで行われたデータ変更は、変更の発生時にパブリッシャーに一括コピーされます。
queued	データの変更は SQL Server キューに格納されます。

Note

Microsoft メッセージ キューは非推奨となり、サポートされなくなりました。

[ @override = ] override

単に情報を示すためだけに特定されます。 サポートされていません。 将来の互換性は保証されません。

リターン コードの値

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

解説

sp_setreplfailovermode は、サブスクリプションが有効になっているスナップショット レプリケーションまたはトランザクション レプリケーションで使用されます。これは、フェールオーバーによるキュー更新から即時更新、またはキュー更新へのフェールオーバーによる即時更新に使用されます。

アクセス許可

sysadmin固定サーバー ロールまたは固定データベース ロールdb_ownerのメンバーのみがsp_setreplfailovermodeを実行できます。

関連するコンテンツ

• 更新可能トランザクション サブスクリプションの更新モードの切り替え
• システム ストアド プロシージャ (Transact-SQL)