sp_replicationdboption (Transact-SQL)

適用対象: SQL ServerAzure SQL Managed Instance

指定したデータベースのレプリケーション データベース オプションを設定します。 このストアド プロシージャは、任意のデータベースのパブリッシャーまたはサブスクライバーで実行されます。

Transact-SQL 構文表記規則

構文

  
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' 指定されたレプリケーション データベース オプションを有効または無効にするかどうかを指定します。 値は sysname で、true または false にすることができます。 この値が false で、optname がマージ 発行の場合、マージパブリッシュされたデータベースのサブスクリプションも削除されます。

[ @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)」を参照してください。

アクセス許可

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

参照

パブリッシングとディストリビューションの構成
パブリケーションを作成する
パブリケーションの削除
パブリッシングおよびディストリビューションの無効化
sys.databases (Transact-SQL)
レプリケーション ストアド プロシージャ (Transact-SQL)