MergeArticle Kelas

Definisi

Ruang nama:

Microsoft.SqlServer.Replication

Rakitan:

Microsoft.SqlServer.Rmo.dll

Mewakili artikel dalam publikasi gabungan.

public ref class MergeArticle sealed : Microsoft::SqlServer::Replication::Article

public sealed class MergeArticle : Microsoft.SqlServer.Replication.Article

type MergeArticle = class
    inherit Article

Public NotInheritable Class MergeArticle
Inherits Article

Warisan

Object

ReplicationObject

Article

MergeArticle

Contoh

Contoh ini membuat tiga artikel gabungan dan filter gabungan terkait.

// Define the Publisher and publication names.
string publisherName = publisherInstance;
string publicationName = "AdvWorksSalesOrdersMerge";
string publicationDbName = "AdventureWorks2012";

// Specify article names.
string articleName1 = "Employee";
string articleName2 = "SalesOrderHeader";
string articleName3 = "SalesOrderDetail";

// Specify join filter information.
string filterName12 = "SalesOrderHeader_Employee";
string filterClause12 = "Employee.EmployeeID = " +
    "SalesOrderHeader.SalesPersonID";
string filterName23 = "SalesOrderDetail_SalesOrderHeader";
string filterClause23 = "SalesOrderHeader.SalesOrderID = " +
    "SalesOrderDetail.SalesOrderID";

string salesSchema = "Sales";
string hrSchema = "HumanResources";

MergeArticle article1 = new MergeArticle();
MergeArticle article2 = new MergeArticle();
MergeArticle article3 = new MergeArticle();
MergeJoinFilter filter12 = new MergeJoinFilter();
MergeJoinFilter filter23 = new MergeJoinFilter();

// Create a connection to the Publisher.
ServerConnection conn = new ServerConnection(publisherName);

// Create three merge articles that are horizontally partitioned
// using a parameterized row filter on Employee.EmployeeID, which is 
// extended to the two other articles using join filters. 
try
{
    // Connect to the Publisher.
    conn.Connect();

    // Create each article. 
    // For clarity, each article is defined separately. 
    // In practice, iterative structures and arrays should 
    // be used to efficiently create multiple articles.

    // Set the required properties for the Employee article.
    article1.ConnectionContext = conn;
    article1.Name = articleName1;
    article1.DatabaseName = publicationDbName;
    article1.SourceObjectName = articleName1;
    article1.SourceObjectOwner = hrSchema;
    article1.PublicationName = publicationName;
    article1.Type = ArticleOptions.TableBased;

    // Define the parameterized filter clause based on Hostname.
    article1.FilterClause = "Employee.LoginID = HOST_NAME()";

    // Set the required properties for the SalesOrderHeader article.
    article2.ConnectionContext = conn;
    article2.Name = articleName2;
    article2.DatabaseName = publicationDbName;
    article2.SourceObjectName = articleName2;
    article2.SourceObjectOwner = salesSchema;
    article2.PublicationName = publicationName;
    article2.Type = ArticleOptions.TableBased;

    // Set the required properties for the SalesOrderDetail article.
    article3.ConnectionContext = conn;
    article3.Name = articleName3;
    article3.DatabaseName = publicationDbName;
    article3.SourceObjectName = articleName3;
    article3.SourceObjectOwner = salesSchema;
    article3.PublicationName = publicationName;
    article3.Type = ArticleOptions.TableBased;

    if (!article1.IsExistingObject) article1.Create();
    if (!article2.IsExistingObject) article2.Create();
    if (!article3.IsExistingObject) article3.Create();

    // Select published columns for SalesOrderHeader.
    // Create an array of column names to vertically filter out.
    // In this example, only one column is removed.
    String[] columns = new String[1];

    columns[0] = "CreditCardApprovalCode";

    // Remove the column.
    article2.RemoveReplicatedColumns(columns);

    // Define a merge filter clauses that filter 
    // SalesOrderHeader based on Employee and 
    // SalesOrderDetail based on SalesOrderHeader. 

    // Parent article.
    filter12.JoinArticleName = articleName1;
    // Child article.
    filter12.ArticleName = articleName2;
    filter12.FilterName = filterName12;
    filter12.JoinUniqueKey = true;
    filter12.FilterTypes = FilterTypes.JoinFilter;
    filter12.JoinFilterClause = filterClause12;

    // Add the join filter to the child article.
    article2.AddMergeJoinFilter(filter12);

    // Parent article.
    filter23.JoinArticleName = articleName2;
    // Child article.
    filter23.ArticleName = articleName3;
    filter23.FilterName = filterName23;
    filter23.JoinUniqueKey = true;
    filter23.FilterTypes = FilterTypes.JoinFilter;
    filter23.JoinFilterClause = filterClause23;

    // Add the join filter to the child article.
    article3.AddMergeJoinFilter(filter23);
}
catch (Exception ex)
{
    // Do error handling here and rollback the transaction.
    throw new ApplicationException(
        "The filtered articles could not be created", ex);
}
finally
{
    conn.Disconnect();
}

' Define the Publisher and publication names.
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksSalesOrdersMerge"
Dim publicationDbName As String = "AdventureWorks2012"

' Specify article names.
Dim articleName1 As String = "Employee"
Dim articleName2 As String = "SalesOrderHeader"
Dim articleName3 As String = "SalesOrderDetail"

' Specify join filter information.
Dim filterName12 As String = "SalesOrderHeader_Employee"
Dim filterClause12 As String = "Employee.EmployeeID = " + _
    "SalesOrderHeader.SalesPersonID"
Dim filterName23 As String = "SalesOrderDetail_SalesOrderHeader"
Dim filterClause23 As String = "SalesOrderHeader.SalesOrderID = " + _
    "SalesOrderDetail.SalesOrderID"

Dim salesSchema As String = "Sales"
Dim hrSchema As String = "HumanResources"

Dim article1 As MergeArticle = New MergeArticle()
Dim article2 As MergeArticle = New MergeArticle()
Dim article3 As MergeArticle = New MergeArticle()
Dim filter12 As MergeJoinFilter = New MergeJoinFilter()
Dim filter23 As MergeJoinFilter = New MergeJoinFilter()

' Create a connection to the Publisher.
Dim conn As ServerConnection = New ServerConnection(publisherName)

' Create three merge articles that are horizontally partitioned
' using a parameterized row filter on Employee.EmployeeID, which is 
' extended to the two other articles using join filters. 
Try
    ' Connect to the Publisher.
    conn.Connect()

    ' Create each article. 
    ' For clarity, each article is defined separately. 
    ' In practice, iterative structures and arrays should 
    ' be used to efficiently create multiple articles.

    ' Set the required properties for the Employee article.
    article1.ConnectionContext = conn
    article1.Name = articleName1
    article1.DatabaseName = publicationDbName
    article1.SourceObjectName = articleName1
    article1.SourceObjectOwner = hrSchema
    article1.PublicationName = publicationName
    article1.Type = ArticleOptions.TableBased

    ' Define the parameterized filter clause based on Hostname.
    article1.FilterClause = "Employee.LoginID = HOST_NAME()"

    ' Set the required properties for the SalesOrderHeader article.
    article2.ConnectionContext = conn
    article2.Name = articleName2
    article2.DatabaseName = publicationDbName
    article2.SourceObjectName = articleName2
    article2.SourceObjectOwner = salesSchema
    article2.PublicationName = publicationName
    article2.Type = ArticleOptions.TableBased

    ' Set the required properties for the SalesOrderDetail article.
    article3.ConnectionContext = conn
    article3.Name = articleName3
    article3.DatabaseName = publicationDbName
    article3.SourceObjectName = articleName3
    article3.SourceObjectOwner = salesSchema
    article3.PublicationName = publicationName
    article3.Type = ArticleOptions.TableBased

    ' Create the articles, if they do not already exist.
    If article1.IsExistingObject = False Then
        article1.Create()
    End If
    If article2.IsExistingObject = False Then
        article2.Create()
    End If
    If article3.IsExistingObject = False Then
        article3.Create()
    End If

    ' Select published columns for SalesOrderHeader.
    ' Create an array of column names to vertically filter out.
    ' In this example, only one column is removed.
    Dim columns() As String = New String(0) {}

    columns(0) = "CreditCardApprovalCode"

    ' Remove the column.
    article2.RemoveReplicatedColumns(columns)

    ' Define a merge filter clauses that filter 
    ' SalesOrderHeader based on Employee and 
    ' SalesOrderDetail based on SalesOrderHeader. 

    ' Parent article.
    filter12.JoinArticleName = articleName1
    ' Child article.
    filter12.ArticleName = articleName2
    filter12.FilterName = filterName12
    filter12.JoinUniqueKey = True
    filter12.FilterTypes = FilterTypes.JoinFilter
    filter12.JoinFilterClause = filterClause12

    ' Add the join filter to the child article.
    article2.AddMergeJoinFilter(filter12)

    ' Parent article.
    filter23.JoinArticleName = articleName2
    ' Child article.
    filter23.ArticleName = articleName3
    filter23.FilterName = filterName23
    filter23.JoinUniqueKey = True
    filter23.FilterTypes = FilterTypes.JoinFilter
    filter23.JoinFilterClause = filterClause23

    ' Add the join filter to the child article.
    article3.AddMergeJoinFilter(filter23)

Catch ex As Exception
    ' Do error handling here and rollback the transaction.
    Throw New ApplicationException( _
        "The filtered articles could not be created", ex)
Finally
    conn.Disconnect()
End Try

Contoh ini mengubah dan artikel penggabungan yang sudah ada untuk mengaitkan penangan logika bisnis dengan artikel. Untuk informasi selengkapnya, lihat sp_helpmergearticlecolumn (Transact-SQL)).

// Define the Publisher, publication, and article names.
string publisherName = publisherInstance;
string publicationName = "AdvWorksSalesOrdersMerge";
string publicationDbName = "AdventureWorks2012";
string articleName = "SalesOrderHeader";

// Set the friendly name of the business logic handler.
string customLogic = "OrderEntryLogic";

MergeArticle article = new MergeArticle();

// Create a connection to the Publisher.
ServerConnection conn = new ServerConnection(publisherName);

try
{
    // Connect to the Publisher.
    conn.Connect();

    // Set the required properties for the article.
    article.ConnectionContext = conn;
    article.Name = articleName;
    article.DatabaseName = publicationDbName;
    article.PublicationName = publicationName;

    // Load the article properties.
    if (article.LoadProperties())
    {
        article.ArticleResolver = customLogic;
    }
    else
    {
        // Throw an exception of the article does not exist.
        throw new ApplicationException(String.Format(
        "{0} is not published in {1}", articleName, publicationName));
    }
    
}
catch (Exception ex)
{
    // Do error handling here and rollback the transaction.
    throw new ApplicationException(String.Format(
        "The business logic handler {0} could not be associated with " +
        " the {1} article.",customLogic,articleName), ex);
}
finally
{
    conn.Disconnect();
}

' Define the Publisher, publication, and article names.
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksSalesOrdersMerge"
Dim publicationDbName As String = "AdventureWorks2012"
Dim articleName As String = "SalesOrderHeader"

' Set the friendly name of the business logic handler.
Dim customLogic As String = "OrderEntryLogic"

Dim article As MergeArticle = New MergeArticle()

' Create a connection to the Publisher.
Dim conn As ServerConnection = New ServerConnection(publisherName)

Try
    ' Connect to the Publisher.
    conn.Connect()

    ' Set the required properties for the article.
    article.ConnectionContext = conn
    article.Name = articleName
    article.DatabaseName = publicationDbName
    article.PublicationName = publicationName

    ' Load the article properties.
    If article.LoadProperties() Then
        article.ArticleResolver = customLogic
    Else
        ' Throw an exception of the article does not exist.
        Throw New ApplicationException(String.Format( _
         "{0} is not published in {1}", articleName, publicationName))
    End If

Catch ex As Exception
    ' Do error handling here and rollback the transaction.
    Throw New ApplicationException(String.Format( _
     "The business logic handler {0} could not be associated with " + _
     " the {1} article.", customLogic, articleName), ex)
Finally
    conn.Disconnect()
End Try

Keterangan

Keamanan Thread

Setiap anggota statis publik (Shared di Microsoft Visual Basic) jenis ini aman untuk operasi multithreaded. Setiap anggota instans tidak dijamin aman untuk utas.

Konstruktor

MergeArticle()	Membuat instans MergeArticle baru kelas .
MergeArticle(String, String, String, ServerConnection)	Membuat instans MergeArticle baru kelas dengan nama, publikasi, database, dan koneksi yang ditentukan ke instans Microsoft SQL Server.

Properti

AllowInteractiveResolver	Mendapatkan atau mengatur apakah akan mengizinkan langganan untuk memanggil pemecah masalah interaktif saat konflik terjadi selama sinkronisasi.
ArticleId	Mendapatkan nilai ID artikel. (Diperoleh dari Article)
ArticleResolver	Mendapatkan atau mengatur nama yang mudah diingat dari penyelesai konflik kustom atau penangan logika bisnis yang digunakan saat menyinkronkan artikel.
CachePropertyChanges	Mendapatkan atau mengatur apakah akan menyimpan perubahan yang dilakukan pada properti replikasi atau segera menerapkannya. (Diperoleh dari ReplicationObject)
CheckPermissions	Mendapatkan atau mengatur bagaimana izin diperiksa di Penerbit sebelum perubahan diunggah dari Pelanggan.
ColumnTracking	Mendapatkan atau mengatur bagaimana konflik terdeteksi saat menyinkronkan baris data.
CompensateForErrors	Mendapatkan atau mengatur apakah tindakan kompensasi diambil ketika kesalahan ditemui selama sinkronisasi.
ConflictTable	Mendapatkan nama tabel yang digunakan untuk melacak konflik yang terjadi saat menyinkronkan artikel penggabungan.
ConnectionContext	Mendapatkan atau mengatur koneksi ke instans Microsoft SQL Server. (Diperoleh dari ReplicationObject)
CreateArticleAsHeterogeneous	Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan membuat artikel sebagai heterogen. (Diperoleh dari Article)
CreationScript	Mendapatkan atau mengatur nama dan jalur lengkap file skrip Transact-SQL yang digunakan untuk membuat objek tujuan di Pelanggan. (Diperoleh dari Article)
DatabaseName	Mendapatkan atau mengatur nama database yang berisi data dan objek yang diterbitkan dalam artikel. (Diperoleh dari Article)
DeleteTracking	Mendapatkan atau mengatur apakah penghapusan direplikasi.
Description	Mendapatkan atau mengatur deskripsi tekstual artikel. (Diperoleh dari Article)
DestinationObjectName	Mendapatkan atau mengatur objek database yang merupakan objek database sumber untuk artikel di Pelanggan. (Diperoleh dari Article)
DestinationObjectOwner	Mendapatkan atau mengatur pemilik skema objek database sumber untuk artikel di Pelanggan. (Diperoleh dari Article)
FilterClause	Mendapatkan atau mengatur klausa WHERE (Transact-SQL) yang dievaluasi untuk memfilter artikel secara horizontal.
IdentityRangeManagementOption	Mendapatkan atau mengatur opsi manajemen rentang identitas untuk artikel. (Diperoleh dari Article)
IdentityRangeThreshold	Mendapatkan atau mengatur nilai di mana rentang baru nilai kolom identitas ditetapkan ke Penerbit atau ke Pelanggan. (Diperoleh dari Article)
IsExistingObject	Mendapatkan apakah objek ada di server atau tidak. (Diperoleh dari ReplicationObject)
MultipleColumnUpdate	Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan memperbarui beberapa kolom.
Name	Mendapatkan atau mengatur nama artikel. (Diperoleh dari Article)
PartitionOption	Mendapatkan atau mengatur opsi pemfilteran saat artikel difilter menggunakan filter baris berparameter.
PreCreationMethod	Mendapatkan atau mengatur tindakan yang akan diambil ketika objek yang diterbitkan sudah ada di database langganan. (Diperoleh dari Article)
ProcessingOrder	Mendapatkan atau mengatur urutan pemrosesan artikel selama sinkronisasi.
PublicationName	Mendapatkan atau menetapkan nama publikasi tempat artikel berada. (Diperoleh dari Article)
PublisherIdentityRangeSize	Mendapatkan atau mengatur rentang nilai identitas yang ditetapkan ke kolom tabel di Publisher. (Diperoleh dari Article)
ResolverInfo	Mendapatkan atau mengatur data dan parameter tambahan yang akan digunakan oleh penyelesai konflik berbasis COM.
SchemaOption	Mendapatkan atau mengatur opsi pembuatan skema untuk artikel. (Diperoleh dari Article)
SnapshotObjectName	Mendapatkan nama objek database yang mewakili data rekam jepret awal untuk artikel.
SnapshotObjectOwner	Mendapatkan pemilik objek database yang mewakili data rekam jepret awal untuk artikel.
SourceObjectName	Mendapatkan atau mengatur nama objek database yang sedang diterbitkan. (Diperoleh dari Article)
SourceObjectOwner	Mendapatkan atau mengatur pemilik objek database yang sedang diterbitkan. (Diperoleh dari Article)
SqlServerName	Mendapatkan nama instans Microsoft SQL Server tempat objek ini tersambung. (Diperoleh dari ReplicationObject)
Status	Mendapatkan atau mengatur status artikel penggabungan.
StreamBlobColumns	Mendapatkan atau mengatur apakah pengoptimalan aliran data digunakan saat mereplikasi kolom objek besar biner (BLOB).
SubscriberIdentityRangeSize	Mendapatkan atau mengatur jumlah maksimum baris baru yang dapat disisipkan ke dalam kolom identitas dalam tabel pada Pelanggan sebelum rentang identitas lain harus dialokasikan. (Diperoleh dari Article)
SubscriberUploadOption	Mendapatkan atau mengatur perilaku pembaruan yang dibuat di Pelanggan dengan langganan klien.
Type	Mendapatkan atau mengatur jenis artikel. (Diperoleh dari Article)
UserData	Mendapatkan atau mengatur properti objek yang memungkinkan pengguna melampirkan data mereka sendiri ke objek. (Diperoleh dari ReplicationObject)
VerifyResolverSignature	Mendapatkan atau mengatur opsi untuk memverifikasi tanda tangan digital pada penyelesai konflik berbasis COM untuk menentukan apakah opsi tersebut berasal dari sumber tepercaya.
VerticalPartition	Mendapatkan nilai yang menunjukkan apakah semua kolom diterbitkan dalam artikel tabel. (Diperoleh dari Article)

Metode

AddMergeJoinFilter(MergeJoinFilter)	Menambahkan filter gabungan ke artikel penggabungan.
AddReplicatedColumns(Array)	Menambahkan kolom yang ditentukan ke artikel penggabungan.
ChangeMergeJoinFilter(MergeJoinFilter, MergeJoinFilter)	Mengubah filter gabungan yang ditentukan pada artikel penggabungan.
CheckValidCreation()	Memeriksa pembuatan artikel yang valid. (Diperoleh dari Article)
CheckValidDefinition(Boolean)	Menunjukkan apakah definisi valid. (Diperoleh dari Article)
CommitPropertyChanges()	Mengirim semua pernyataan perubahan properti yang di-cache ke instans Microsoft SQL Server. (Diperoleh dari ReplicationObject)
Create()	Membuat artikel baru tentang instans SQL Server yang saat ini tersambung berdasarkan properti TransArticle objek atau MergeArticle objek saat ini. (Diperoleh dari Article)
Decouple()	Memisahkan objek replikasi yang direferensikan dari server. (Diperoleh dari ReplicationObject)
EnumMergeJoinFilters()	Mengembalikan filter gabungan yang ditentukan untuk artikel penggabungan.
GetChangeCommand(StringBuilder, String, String)	Mengembalikan perintah perubahan dari replikasi. (Diperoleh dari ReplicationObject)
GetCreateCommand(StringBuilder, Boolean, ScriptOptions)	Mengembalikan perintah buat dari replikasi. (Diperoleh dari ReplicationObject)
GetDropCommand(StringBuilder, Boolean)	Mengembalikan perintah hilangkan dari replikasi. (Diperoleh dari ReplicationObject)
InitializeSharedPropertiesBasedOnExistingArticles()	Menunjukkan apakah akan menginisialisasi properti bersama berdasarkan artikel yang ada.
InternalRefresh(Boolean)	Memulai refresh internal dari replikasi. (Diperoleh dari ReplicationObject)
ListReplicatedColumns()	Mengembalikan kolom yang ada dalam artikel yang dipartisi secara vertikal.
Load()	Memuat properti objek yang ada dari server. (Diperoleh dari ReplicationObject)
LoadProperties()	Memuat properti objek yang ada dari server. (Diperoleh dari ReplicationObject)
Refresh()	Memuat ulang properti objek. (Diperoleh dari ReplicationObject)
Remove()	Menghapus artikel yang ada pada instans SQL Server yang saat ini tersambung berdasarkan properti TransArticle objek atau MergeArticle objek saat ini. (Diperoleh dari Article)
RemoveMergeJoinFilter(String)	Menghapus filter gabungan gabungan yang ditentukan dari artikel.
RemoveReplicatedColumns(Array)	Menghapus kolom yang ada dari artikel yang dipartisi secara vertikal.
Script(ScriptOptions)	Menghasilkan skrip Transact-SQL yang dapat dijalankan untuk membuat atau menghapus TransArticle objek atau MergeArticle objek di server. (Diperoleh dari Article)
ScriptMergeJoinFilter(MergeJoinFilter, ScriptOptions)	Mengembalikan skrip Transact-SQL dari filter gabungan gabungan yang dilampirkan ke artikel penggabungan.

Lihat juga

• Cara: Menentukan Artikel (Pemrograman RMO)