sp_setreplfailovermode (Transact-SQL)

適用対象:SQL Server

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

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)