다음을 통해 공유

  • 아티클

InsertCommand Property

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

The InsertCommand property specifies record insert when new rows in the source are published to article Subscribers.

구문

object.InsertCommand [=value]

Parts

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

  • value
    A string containing a Transact-SQL script

Data Type

String

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetInsertCommand(SQLDMO_LPBSTR pRetVal);
HRESULT SetInsertCommand(SQLDMO_LPCSTR NewValue);

[!참고]

SQL Distributed Management Objects (SQL-DMO) strings are always returned as OLE BSTR objects. A C/C++ application obtains a reference to the string. The application must release the reference using SysFreeString.

주의

The format and contents of the InsertCommand property must match those specified for the @ins_cmd argument of the system stored procedure sp_article. For more information, see sp_addarticle(Transact-SQL).

For each row added to the published table, a Transact-SQL INSERT statement is built. If InsertCommand is an empty string, or the string "SQL", the default behavior is used.

Set InsertCommand to NONE to specify that the publication ignore records added to the published table.

Set InsertCommand to CALL procedure to specify a Transact-SQL stored procedure executed for record insertion. The stored procedure must include parameters referencing, in order, the columns published in the article, and each Subscriber must have a copy of the stored procedure installed in the destination database.

[!참고]

If an application sets InsertCommand after the initial snapshot has been created, a new snapshot must be generated and reapplied to each subscription. Snapshots are applied when the next scheduled snapshot and distribution agent run.

Applies To:

TransArticle Object