IdentityRangeThreshold Property

아티클
12/15/2008

Microsoft SQL Server의 이후 버전에서는 이 기능이 제거됩니다. 새 개발 작업에서는 이 기능을 사용하지 말고, 현재 이 기능을 사용하는 응용 프로그램은 수정하십시오.

The IdentityRangeThreshold property specifies when to assign a new range of values to an identity column at a Publisher or Subscriber.

구문

object
.IdentityRangeThreshold [= value]

Parts

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.

Data Type

Long

Modifiable

Read/write

Prototype (C/C++)

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 SubscriberIdentityRangeSize properties. 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 SubscriberIdentityRangeSize properties.

[!참고] 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.