PublisherIdentityRangeSize Property

SQL-DMO

SQL-DMO

PublisherIdentityRangeSize Property

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

Applies To
MergeArticle2 Object TransArticle2 Object
Syntax

object.PublisherIdentityRangeSize [= value]

Parts

object

Expression that evaluates to an object in the Applies To list

value

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 in 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 PublisherIdentityRangeSize on an instance of SQL Server version 7.0, the constant, SQLDMO_E_SQL80ONLY, and the message "This property or method requires Microsoft SQL Server 2000" are returned.

See Also

AutoIdentityRange Property

IdentityRangeThreshold Property

SubscriberIdentityRangeSize Property