sp_replicationdboption (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 で、次のいずれかの値を指定できます。値 説明 merge publish
データベースは、マージ パブリケーションで使用できます。
publish
データベースは、他の種類のパブリケーションで使用できます。
subscribe
データベースは、サブスクリプション データベースです。
sync with backup
データベースが連携バックアップに対して有効になっています。詳細については、「トランザクション レプリケーションの連携バックアップを有効にする方法 (レプリケーション Transact-SQL プログラミング)」を参照してください。
- [ @value=] 'value'
指定したデータベース オプションを有効にするか無効にするかを指定します。value のデータ型は sysname で、true または false のいずれかを指定できます。この値が false で、optname が merge publish の場合、マージ パブリッシュ データベースへのサブスクリプションも削除されます。
- [ @ignore_distributor=] ignore_distributor
ディストリビュータに接続せずに、このストアド プロシージャを実行するかどうかを指定します。ignore_distributor のデータ型は bit で、既定値は 0 です。既定値は、ディストリビュータに接続し、パブリッシング データベースの新しい状態を反映する必要があることを表します。値 1 は、ディストリビュータがアクセス不能で、sp_replicationdboption を使用してパブリッシングを無効にする場合にのみ指定してください。
- [ @from_scripting=] from_scripting
内部使用のみです。
解説
sp_replicationdboption は、スナップショット レプリケーション、トランザクション レプリケーション、およびマージ レプリケーションで使用します。
このプロシージャでは、指定したオプションに従って、特定のレプリケーション システム テーブル、セキュリティ アカウントなどが作成または削除されます。また、master.sysdatabases システム テーブルに対応するカテゴリ ビットが設定され、必要なシステム テーブルが作成されます。
パブリッシングを無効にするには、パブリケーション データベースがオンラインであることが必要です。パブリケーション データベースにデータベース スナップショットが存在する場合は、パブリッシングを無効にする前に削除する必要があります。データベース スナップショットは、データベースの読み取り専用のオフライン コピーであり、レプリケーション スナップショットには関係していません。詳細については、「データベース スナップショット」を参照してください。
権限
sp_replicationdboption を実行できるのは、sysadmin 固定サーバー ロールのメンバだけです。
戻り値
0 (成功) または 1 (失敗)
参照
関連項目
sys.sysdatabases (Transact-SQL)
レプリケーション ストアド プロシージャ (Transact-SQL)
その他の技術情報
パブリッシングとディストリビューションを構成する方法 (レプリケーション Transact-SQL プログラミング)
パブリケーションを作成する方法 (レプリケーション Transact-SQL プログラミング)
パブリケーションを削除する方法 (レプリケーション Transact-SQL プログラミング)
パブリッシングとディストリビューションを無効にする方法 (レプリケーション Transact-SQL プログラミング)