sp_adjustpublisheridentityrange (Transact-SQL)
適用対象: SQL Server
パブリケーションの ID 範囲を調整し、パブリケーションのしきい値に基づいて新しい範囲を再割り当てします。 このストアド プロシージャは、パブリッシャー側のパブリケーション データベースで実行されます。
構文
sp_adjustpublisheridentityrange
[ [ @publication = ] N'publication' ]
[ , [ @table_name = ] N'table_name' ]
[ , [ @table_owner = ] N'table_owner' ]
[ ; ]
引数
[ @publication = ] N'publication'
新しい ID 範囲が再割り当てされるパブリケーションの名前。 @publication は sysname で、既定値は NULL
です。
[ @table_name = ] N'table_name'
新しい ID 範囲が再割り当てされるテーブルの名前。 @table_name は sysname で、既定値は NULL
です。
[ @table_owner = ] N'table_owner'
パブリッシャーのテーブルの所有者。 @table_owner は sysname で、既定値は NULL
です。
リターン コードの値
0
(成功) または 1
(失敗)。
解説
sp_adjustpublisheridentityrange
は、すべての種類のレプリケーションで使用されます。
自動 ID 範囲が有効になっているパブリケーションの場合、ディストリビューション エージェントまたはマージ エージェントは、しきい値に基づいてパブリケーション内の ID 範囲を自動的に調整します。 ただし、何らかの理由でディストリビューション エージェントまたはマージ エージェントが一定期間実行されておらず、ID 範囲リソースがしきい値の時点まで大きく消費される場合は、sp_adjustpublisheridentityrange
を呼び出して、パブリッシャーに新しい値の範囲を割り当てることができます。
sp_adjustpublisheridentityrange
を実行するときは、@publicationまたは@table_nameを指定する必要があります。 両方とも指定されていない場合は、エラーが返されます。
アクセス許可
sysadmin固定サーバー ロールまたは固定データベース ロールdb_ownerのメンバーのみがsp_adjustpublisheridentityrange
を実行できます。