sp_adjustpublisheridentityrange (Transact-SQL)

適用対象: SQL サーバー

パブリケーションの ID 範囲を調整し、パブリケーションのしきい値に基づいて新しい範囲を再割り当てします。 このストアド プロシージャは、パブリッシャー側のパブリケーション データベースで実行されます。

Transact-SQL 構文表記規則

構文

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を実行できます。

関連するコンテンツ

• ID 列のレプリケート
• システム ストアド プロシージャ (Transact-SQL)