sp_publisherproperty (Transact-SQL)

適用対象: SQL ServerAzure SQL Managed Instance

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

Transact-SQL 構文表記規則

構文

  
sp_publisherproperty [ @publisher = ] 'publisher'   
   [ , [ @propertyname = ] 'propertyname' ]   
   [ , [ @propertyvalue = ] 'propertyvalue' ]  

引数

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

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

Value	説明
xactsetbatching	パブリッシャーのトランザクションが、後続の処理のために、トランザクション全体で一貫性のあるセット (Xactsets と呼ばれます) にまとめられるかどうかを示します。 有効の値は、Xactset を作成できることを意味します。これが既定値です。 無効の値は、既存の Xactset が新しい Xactset が作成されていないことを意味します。
xactsetjob	Xactsets を作成するために Xactset ジョブを有効にするかどうかを示します。 有効の値は、Xactset ジョブが定期的に実行され、パブリッシャーで Xactset を作成することを意味します。 無効の値は、Xactset がパブリッシャーに変更をポーリングするときにのみログ リーダー エージェントによって作成されることを意味します。
xactsetjobinterval	Xactset ジョブの実行間隔 (分単位) です。

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

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

結果セット

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

リターン コードの値

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

解説

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

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

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

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

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

アクセス許可

sp_publisherpropertyを実行できるのは、ディストリビューターの sysadmin 固定サーバー ロールのメンバーだけです。

参照

Oracle パブリッシャー用のトランザクション セット ジョブの構成 (レプリケーション Transact-SQL プログラミング)
システム ストアド プロシージャ (Transact-SQL)