sp_setreplfailovermode (Transact-SQL)

  • [アーティクル]

適用対象:SQL Server

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

Transact-SQL 構文表記規則

構文

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

引数

[ @publisher = ] 'publisher' パブリケーションの名前を指定します。 publication は sysname で、既定値はありません。 パブリケーションは既に存在している必要があります。

[ @publisher_db = ] 'publisher_db' パブリケーション データベースの名前を指定します。 publisher_db は sysname で、既定値はありません。

[ @publication = ] 'publication' パブリケーションの名前を指定します。 publication は sysname で、既定値はありません。

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

値 説明
イミディエイト または 同期 サブスクライバーで行われたデータ変更は、変更の発生時にパブリッシャーに一括コピーされます。
キュー データの変更は、Microsoft SQL Server キューに格納されます。

注意

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

[ @override = ] override 内部使用のみ。

リターン コードの値

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

解説

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

アクセス許可

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

参照

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