• Article

PublisherIdentityRangeSize Property

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

The PublisherIdentityRangeSize property specifies the identity range size of a published table at the Publisher.

Syntax

object
.PublisherIdentityRangeSize [= value]

Parts

  • object
    An expression that evaluates to an object in the Applies To list

  • value
    A long integer that specifies the maximum number of new rows that can be entered into the table

Data Type

Long

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetPublisherIdentityRangeSize(LONG64 *pRetVal);
HRESULT SetPublisherIdentityRangeSize(LONG64 NewValue);

Remarks

The identity range size specifies the maximum number of new rows that can be inserted into an identity column in a table at a Publisher or Subscriber before another identity range must be allocated. Use the IdentityRangeThreshold property to control when an identity range must be allocated. The PublisherIdentityRangeSize property can be set larger or smaller than the SubscriberIdentityRangeSize property depending on the relative frequency with which new rows are inserted at the Publisher in relation to its Subscribers.

Prior to setting PublisherIdentityRangeSize, set AutoIdentityRange to TRUE.

Note

If an application calls PublisherIdentityRangeSizeon an instance of Microsoft SQL Server version 7.0, the constant, SQLDMO_E_SQL80ONLY, and the message "This property or method requires Microsoft SQL Server 2000 or later" are returned.