sp_replicationdboption (Transact-SQL)
適用対象: SQL Server Azure SQL Managed Instance
指定したデータベースのレプリケーション データベース オプションを設定します。 このストアド プロシージャは、任意のデータベースのパブリッシャーまたはサブスクライバーで実行されます。
構文
sp_replicationdboption [ @dbname= ] 'db_name'
, [ @optname= ] 'optname'
, [ @value= ] 'value'
[ , [ @ignore_distributor= ] ignore_distributor ]
[ , [ @from_scripting = ] from_scripting ]
引数
[ @dbname = ] 'dbname'
レプリケーション データベース オプションが設定されているデータベースです。 db_name は sysname で、既定値はありません。
[ @optname = ] 'optname'
有効または無効にするレプリケーション データベース オプションです。 optname は sysname であり、これらの値のいずれかを指定できます。
Value | 説明 |
---|---|
マージ 発行 | データベースは、マージ パブリケーションで使用できます。 |
publish (発行) | データベースは、他の種類のパブリケーションで使用できます。 |
サブスクライブ | データベースはサブスクリプション データベースです。 |
バックアップと同期する | データベースは、調整されたバックアップに対して有効になっています。 詳細については、「 トランザクション レプリケーションの有効な調整されたバックアップ (レプリケーション Transact-SQL プログラミング)」を参照してください。 |
[ @value = ] 'value'
指定されたレプリケーション データベース オプションを有効または無効にするかどうかを指定します。 value は sysname で、 true または false。 この値がfalseoptnameが発行場合マージパブリッシュされたデータベースへのサブスクリプションも削除されます。
[ @ignore_distributor = ] ignore_distributor
ディストリビューターに接続せずにこのストアド プロシージャを実行するかどうかを示します。 ignore_distributor は ビットです既定値は 0 です。つまり、ディストリビューターに接続し、発行データベースの新しい状態で更新する必要があります。 値 1 は、ディストリビューターにアクセスできなくなり、 sp_replicationdboption が発行を無効にするために使用されている場合にのみ指定する必要があります。
[ @from_scripting = ] from_scripting
単に情報を示すためだけに特定されます。 サポートされていません。 将来の互換性は保証されません。
リターン コードの値
0 (成功) または 1 (失敗)
解説
sp_replicationdboption は、スナップショット レプリケーション、トランザクション レプリケーション、マージ レプリケーションで使用されます。
このプロシージャでは、指定したオプションに従って、特定のレプリケーション システム テーブル、セキュリティ アカウントなどが作成または削除されます。 master.databasesシステム テーブル内の対応するis_published (トランスカケーション レプリケーションまたはスナップショット レプリケーション)、is_merge_published (マージ レプリケーション)、またはis_distributor ビットを設定し、必要なシステム テーブルを作成します。
発行を無効にするには、パブリケーション データベースがオンラインである必要があります。 パブリケーション データベースのデータベース スナップショットが存在する場合は、パブリッシュを無効にする前に削除する必要があります。 データベース スナップショットは、データベースの読み取り専用オフライン コピーであり、レプリケーション スナップショットとは関係ありません。 詳細については、「データベース スナップショット (SQL Server)」を参照してください。
アクセス許可
sysadmin固定サーバー ロールのメンバーのみがsp_replicationdboptionを実行できます。
参照
パブリッシングとディストリビューションの構成
パブリケーションを作成する
パブリケーションの削除
パブリッシングおよびディストリビューションの無効化
sys.databases (Transact-SQL)
レプリケーション ストアド プロシージャ (Transact-SQL)