Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Expand Minimize

IdentityRangeThreshold 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 IdentityRangeThreshold property specifies when to assign a new range of values to an identity column at a Publisher or Subscriber.


object
.IdentityRangeThreshold [= value]

object

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

value

A long integer value from 1 through 100 that specifies (as a percentage of a Publisher's or Subscriber's range size) when a new identity range is allocated.

Read/write

HRESULT GetIdentityRangeThreshold(LPLONG pRetVal);
HRESULT SetIdentityRangeThreshold(LONG NewValue);

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 the starting point of the identity range must be reallocated. Use IdentityRangeThreshold to control when an identity range is reallocated.

The identity range threshold is defined as a percentage of the range size specified by the PublisherIdentityRangeSize or SubscriberIdentityRangeSizeproperties. For example, if the identity range size is 50,000, set IdentityRangeThreshold to 80 to reallocate an identity range when the current identity values used reaches 40,000 rows.

Prior to setting IdentityRangeThreshold, set AutoIdentityRange to TRUE, and specify identity range sizes using the PublisherIdentityRangeSize and SubscriberIdentityRangeSizeproperties.

NoteNote

If an application calls IdentityRangeThreshold on 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.

Community Additions

ADD
Show:
© 2015 Microsoft