MergeArticle.StreamBlobColumns Property

Artikkeli
12/03/2008

Gets or sets whether a data stream optimization is used when replicating binary large object (BLOB) columns.

Namespace: Microsoft.SqlServer.Replication
Assembly: Microsoft.SqlServer.Rmo (in microsoft.sqlserver.rmo.dll)

Syntax

'Declaration
Public Property StreamBlobColumns As Boolean

public bool StreamBlobColumns { get; set; }

public:
property bool StreamBlobColumns {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_StreamBlobColumns ()

/** @property */
public void set_StreamBlobColumns (boolean value)

public function get StreamBlobColumns () : boolean

public function set StreamBlobColumns (value : boolean)

Property Value

A Boolean value. If true, the default, changes to BLOB columns are transferred in chunks. If false, changes to BLOB columns are transferred individually.

Remarks

Transferring BLOB column changes in chunks can help reduce the amount of memory consumed by the merge synchronization process.

Certain merge replication functionalities, such as logical records, can still prevent the stream optimization from being used when replicating binary large objects even when the StreamBlobColumns property is true.

Enabling this memory optimization may hurt the performance of the Merge Agent during synchronization. This option should only be used when replicating columns that contain megabytes of data.

The StreamBlobColumns property can be retrieved by members of the sysadmin fixed server role at the Publisher and at the Subscriber (for republishing Subscribers). It can also be retrieved by members of the db_owner fixed database role on the publication database, by members of the replmonitor fixed database role at the Distributor, and by users who are members of the publication access list (PAL).

The StreamBlobColumns property can be set by members of the sysadmin fixed server role at the Publisher. It can also be set by members of the db_owner fixed database role on the publication database.

Retrieving StreamBlobColumns is equivalent to executing sp_helpmergearticle (Transact-SQL).

Setting StreamBlobColumns is equivalent to executing sp_addmergearticle (Transact-SQL) or sp_changemergearticle (Transact-SQL).

The StreamBlobColumns property is available with Microsoft SQL Server 2005.

This namespace, class, or member is supported only in version 2.0 of the Microsoft .NET Framework.

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms