• [アーティクル]

sp_replicationdboption (Transact-SQL)

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

トピック リンク アイコン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
    単に情報を示すためだけに特定されます。サポートされていません。将来の互換性は保証されません。

戻り値

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

説明

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

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

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

権限

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