sp_publisherproperty (Transact-SQL)
適用対象: SQL Server Azure SQL Managed Instance
SQL Server 以外のパブリッシャーのパブリッシャー プロパティを表示または変更します。 このストアド プロシージャはディストリビューターで実行されます。
構文
sp_publisherproperty
[ @publisher = ] N'publisher'
[ , [ @propertyname = ] N'propertyname' ]
[ , [ @propertyvalue = ] N'propertyvalue' ]
[ ; ]
引数
[ @publisher = ] N'publisher'
異種パブリッシャーの名前。 @publisher は sysname で、既定値はありません。
[ @propertyname = ] N'propertyname'
設定するプロパティの名前。 @propertyname は sysname で、次のいずれかの値を指定できます。
Value | 説明 |
---|---|
xactsetbatching |
パブリッシャー側のトランザクションを、後続の処理のためにトランザクション整合性セット (Xactset) にグループ化するかどうかを指定します。 enabled の値は、Xactset を作成できることを意味します。これは既定値です。 disabled の値は、既存の Xactset が新しい Xactset が作成されていないことを意味します。 |
xactsetjob |
Xactset ジョブを Xactset の作成に対して有効にするかどうかを指定します。 enabled 値は、Xactset ジョブが定期的に実行され、パブリッシャーで Xactset を作成することを意味します。 disabled の値は、ログ リーダー エージェントがパブリッシャーに変更をポーリングしたときにのみ Xactset が作成されることを意味します。 |
xactsetjobinterval |
Xactset ジョブの実行間隔 (分単位) です。 |
@propertynameを省略すると、すべての設定可能なプロパティが返されます。
[ @propertyvalue = ] N'propertyvalue'
プロパティ設定の新しい値。 @propertyvalue は sysname で、既定値は NULL
です。 @propertyvalueを省略すると、プロパティの現在の設定が返されます。
結果セット
列名 | データ型 | 説明 |
---|---|---|
propertyname |
sysname | 設定できる次のパブリケーション プロパティを返します。xactsetbatching xactsetjob xactsetjobinterval |
propertyvalue |
sysname | propertyname 列のプロパティの現在の設定。 |
リターン コードの値
0
(成功) または 1
(失敗)。
解説
sp_publisherproperty
は、SQL Server 以外のパブリッシャーのトランザクション レプリケーションで使用されます。
@publisherのみを指定した場合、結果セットには、設定できるすべてのプロパティの現在の設定が含まれます。
@propertynameを指定すると、結果セットに名前付きプロパティのみが表示されます。
すべてのパラメーターを指定すると、プロパティが変更され、結果セットは返されません。
実行中のジョブの xactsetjobinterval
プロパティを変更する場合は、新しい間隔を有効にするためにジョブを再起動する必要があります。
アクセス許可
ディストリビューターの固定サーバー ロールsysadmin のメンバーのみがsp_publisherproperty
を実行できます。