MergeArticle Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
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. |