ValidatePublication Method (TransPublication2)
未來的 Microsoft SQL Server 版本將移除這項功能。請避免在新的開發工作中使用這項功能,並規劃修改目前使用這項功能的應用程式。
The ValidatePublication method invokes inline publication validation for all Subscribers.
語法
object.ValidatePublication( [ ValidationOption ] ,
[ ValidationMethod ] ,
[ fShutDownAgent ] )
Parts
object
Expression that evaluates to an object in the Applies To list.ValidationOption
Long integer that specifies the type of validation performed as described in Settings.ValidationMethod
Long integer that specifies the method of validation performed as described in Settings.fShutDownAgent
Boolean that specifies whether the distribution agent immediately shuts down after successful completion of the validation process.
Prototype (C/C++)
HRESULT ValidatePublication(
SQLDMO_VALIDATIONOPTION_TYPE ValidationOption,
SQLDMO_VALIDATIONMETHOD_TYPE ValidationMethod,
BOOL fShutDownAgent);
Settings
Set the ValidationOption parameter using these SQLDMO_VALIDATIONOPTION_TYPE values.
Constant |
Value |
Description |
---|---|---|
SQLDMOValidationOption_/70Checksum |
0 |
Perform a Transact-SQL CHECKSUM operation compatible with an instance of Microsoft SQL Server version 7.0. |
SQLDMOValidationOption_/RowCountOnly |
1 |
Default. Perform a Transact-SQL @@ROWCOUNT operation. |
SQLDMOValidationOption_/80Checksum |
2 |
Perform a Transact-SQL CHECKSUM operation compatible with an instance of Microsoft SQL Server 2000. Only supported by SQL Server 2000 Subscribers. |
Set the ValidationMethod parameter using these SQLDMO_VALIDATIONMETHOD_TYPE values.
Constant |
Value |
Description |
---|---|---|
SQLDMOValidationMethod_/ConditionalFast |
2 |
Default. Performs conditional validation first using SQLDMOValidationMethod_FastCount but reverts to using SQLDMOValidationMethod_FullCount if SQLDMOValidationMethod_FastCount indicates differences. |
SQLDMOValidationMethod_/FastCount |
1 |
Performs high speed validation, using the rowcnt column of sysindexes. |
SQLDMOValidationMethod_/FullCount |
0 |
Validates by returning the number of rows, including NULL values, and duplicates using Transact-SQL COUNT(*). |
備註
The result of the validation operation is written to the agent history, which can be viewed using Replication Monitor.
By default, the fShutDownAgent parameter is set to FALSE.
[!附註]
If an application calls ValidatePublicationon 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 or later" are returned.