sp_adjustpublisheridentityrange (Transact-SQL)

適用対象:SQL Server

パブリケーションの 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できます。