PostSnapshotScript Property

[アーティクル]
12/15/2008

この機能は、将来のバージョンの Microsoft SQL Server では削除される予定です。新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションは修正することを検討してください。

The PostSnapshotScript property specifies the complete path and file name of a Transact-SQL script that runs after an initial snapshot is applied to a Subscriber.

構文

object
.PostSnapshotScript [= value]

Parts

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

value
A string that specifies the complete path and file name of the Transact-SQL script

Data Type

String

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetPostSnapshotScript(SQLDMO_LPBSTR pRetVal);
HRESULT SetPostSnapshotScript(SQLDMO_LPCSTR NewValue);

解説

Running Transact-SQL scripts after an initial snapshot is applied can be used to:

Set up reporting environments that depend on stored procedures.
Create custom views.
Create user-defined functions.

メモ :

If PostSnapshotScript is set, the script automatically runs when a subscription is reinitialized. Therefore, the script must be written so that its statements are repeatable.

If an application sets **PostSnapshotScript** after the initial snapshot has been created, a new snapshot must be generated. Snapshots are applied when the next scheduled snapshot agent runs.

メモ :
If PostSnapshotScript is set, the script automatically runs when a subscription is reinitialized. Therefore, the script must be written so that its statements are repeatable.

You can also run Transact-SQL scripts during a replication operation using the ReplicateUserDefinedScript method.

メモ :
If an application calls PostSnapshotScript 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 or later" are returned.