sys.sp_publisherproperty(Transact-SQL)

適用対象:SQL ServerAzure SQL Managed Instance

SQL Server 以外のパブリッシャーのパブリッシャー プロパティを表示または変更します。 このストアド プロシージャはディストリビューターで実行されます。

Transact-SQL 構文表記規則

構文

sys.sp_publisherproperty
    [ @publisher = ] N'publisher'
    [ , [ @propertyname = ] N'propertyname' ]
    [ , [ @propertyvalue = ] N'propertyvalue' ]
[ ; ]

引数

[ @publisher = ] N'publisher'

異種パブリッシャーの名前。 @publisher は sysname で、既定値はありません。

[ @propertyname = ] N'プロパティネーム」

設定するプロパティの名前。 @propertyname は sysname で、次のいずれかの値を指定できます。

値 説明
xactsetbatching パブリッシャー側のトランザクションを、後続の処理のためにトランザクション整合性セット (Xactset) にグループ化するかどうかを指定します。 enabledの値は、Xactset を作成できることを意味します。これは既定値です。 disabledの値は、既存の Xactset が新しい Xactset が作成されていないことを意味します。
xactsetjob Xactset ジョブを Xactset の作成に対して有効にするかどうかを指定します。 enabled値は、Xactset ジョブが定期的に実行され、パブリッシャーで Xactset を作成することを意味します。 disabledの値は、ログ リーダー エージェントがパブリッシャーに変更をポーリングしたときにのみ Xactset が作成されることを意味します。
xactsetjobinterval Xactset ジョブの実行間隔 (分単位) です。

@propertynameを省略すると、すべての設定可能なプロパティが返されます。

[ @propertyvalue = ] N'プロパティバリュー」

プロパティ設定の新しい値。 @propertyvalue は sysname で、既定値は NULL です。 @propertyvalueを省略すると、プロパティの現在の設定が返されます。

結果セット

列名 データ型 説明
propertyname sysname 設定できる次のパブリケーション プロパティを返します。

xactsetbatching
xactsetjob
xactsetjobinterval
propertyvalue sysname propertyname列のプロパティの現在の設定。

リターン コードの値

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

解説

sp_publisherproperty は、SQL Server 以外のパブリッシャーのトランザクション レプリケーションで使用されます。

@publisherのみを指定した場合、結果セットには、設定できるすべてのプロパティの現在の設定が含まれます。

@propertynameを指定すると、結果セットに名前付きプロパティのみが表示されます。

すべてのパラメーターを指定すると、プロパティが変更され、結果セットは返されません。

実行中のジョブの xactsetjobinterval プロパティを変更する場合は、新しい間隔を有効にするためにジョブを再起動する必要があります。

アクセス許可

ディストリビューターの固定サーバー ロールsysadmin のメンバーのみがsp_publisherpropertyを実行できます。