sp_replicationdboption (Transact-SQL)

適用対象: SQL Server Azure SQL Managed Instance

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

Transact-SQL 構文表記規則

構文

sp_replicationdboption
    [ @dbname = ] N'dbname'
    , [ @optname = ] N'optname'
    , [ @value = ] { N'true' | N 'false' }
    [ , [ @ignore_distributor = ] ignore_distributor ]
    [ , [ @from_scripting = ] from_scripting ]
[ ; ]

引数

[ @dbname = ] N'dbname'

レプリケーション データベース オプションが設定されているデータベース。 @dbname は sysname で、既定値はありません。

[ @optname = ] N'optname'

有効または無効にするレプリケーション データベース オプション。 @optname は sysname であり、次のいずれかの値を指定できます。

[ @value = ] { N'true' |N 'false' }

指定されたレプリケーション データベース オプションを有効または無効にするかどうか。 @value は sysname で、既定値はありません。 この値が false され、 @optname が merge publishされると、マージパブリッシュされたデータベースのサブスクリプションも削除されます。

[ @ignore_distributor = ] ignore_distributor

ディストリビューターに接続せずにこのストアド プロシージャを実行するかどうかを示します。 @ignore_distributor は bit で、既定値は 0 です。

• 0場合は、ディストリビューターを接続し、発行データベースの新しい状態で更新する必要があります。

• 1 は、ディストリビューターにアクセスできない場合にのみ指定し、 sp_replicationdboption を使用して発行を無効にする必要があります。

[ @from_scripting = ] from_scripting

単に情報を示すためだけに特定されます。 サポートされていません。 将来の互換性は保証されません。

リターン コードの値

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

解説

sp_replicationdboption は、スナップショット レプリケーション、トランザクション レプリケーション、マージ レプリケーションで使用されます。

このプロシージャでは、指定したオプションに従って、特定のレプリケーション システム テーブル、セキュリティ アカウントなどが作成または削除されます。 対応するis_published (トランザクション またはスナップショット レプリケーション)、is_merge_published (マージ レプリケーション)、またはmaster.databases システム テーブルのis_distributor ビットを設定し、必要なシステム テーブルを作成します。

発行を無効にするには、パブリケーション データベースがオンラインである必要があります。 パブリケーション データベースのデータベース スナップショットが存在する場合は、パブリッシュを無効にする前に削除する必要があります。 データベース スナップショットは、データベースの読み取り専用オフライン コピーであり、レプリケーション スナップショットとは関係ありません。 詳細については、「 Database スナップショット (SQL Server)」を参照してください。

アクセス許可

sysadmin固定サーバー ロールのメンバーのみがsp_replicationdboptionを実行できます。

関連するコンテンツ

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