MergePullSubscription Kelas

Referensi

Definisi

Ruang nama:: Microsoft.SqlServer.Replication

Rakitan:: Microsoft.SqlServer.Rmo.dll

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 langganan penarikan ke publikasi gabungan.

public ref class MergePullSubscription sealed : Microsoft::SqlServer::Replication::PullSubscription

public sealed class MergePullSubscription : Microsoft.SqlServer.Replication.PullSubscription

type MergePullSubscription = class
    inherit PullSubscription

Public NotInheritable Class MergePullSubscription
Inherits PullSubscription

Warisan: Object

ReplicationObject

PullSubscription
MergePullSubscription

Contoh

// Define the Publisher, publication, and databases.
string publicationName = "AdvWorksSalesOrdersMerge";
string publisherName = publisherInstance;
string subscriberName = subscriberInstance;
string subscriptionDbName = "AdventureWorks2012Replica";
string publicationDbName = "AdventureWorks2012";
string hostname = @"adventure-works\garrett1";

//Create connections to the Publisher and Subscriber.
ServerConnection subscriberConn = new ServerConnection(subscriberName);
ServerConnection publisherConn = new ServerConnection(publisherName);

// Create the objects that we need.
MergePublication publication;
MergePullSubscription subscription;

try
{
    // Connect to the Subscriber.
    subscriberConn.Connect();

    // Ensure that the publication exists and that 
    // it supports pull subscriptions.
    publication = new MergePublication();
    publication.Name = publicationName;
    publication.DatabaseName = publicationDbName;
    publication.ConnectionContext = publisherConn;

    if (publication.LoadProperties())
    {
        if ((publication.Attributes & PublicationAttributes.AllowPull) == 0)
        {
            publication.Attributes |= PublicationAttributes.AllowPull;
        }

        // Define the pull subscription.
        subscription = new MergePullSubscription();
        subscription.ConnectionContext = subscriberConn;
        subscription.PublisherName = publisherName;
        subscription.PublicationName = publicationName;
        subscription.PublicationDBName = publicationDbName;
        subscription.DatabaseName = subscriptionDbName;
        subscription.HostName = hostname;

        // Specify the Windows login credentials for the Merge Agent job.
        subscription.SynchronizationAgentProcessSecurity.Login = winLogin;
        subscription.SynchronizationAgentProcessSecurity.Password = winPassword;

        // Make sure that the agent job for the subscription is created.
        subscription.CreateSyncAgentByDefault = true;

        // Create the pull subscription at the Subscriber.
        subscription.Create();

        Boolean registered = false;

        // Verify that the subscription is not already registered.
        foreach (MergeSubscription existing
            in publication.EnumSubscriptions())
        {
            if (existing.SubscriberName == subscriberName
                && existing.SubscriptionDBName == subscriptionDbName
                && existing.SubscriptionType == SubscriptionOption.Pull)
            {
                registered = true;
            }
        }
        if (!registered)
        {
            // Register the local subscription with the Publisher.
            publication.MakePullSubscriptionWellKnown(
                subscriberName, subscriptionDbName,
                SubscriptionSyncType.Automatic,
                MergeSubscriberType.Local, 0);
        }
    }
    else
    {
        // Do something here if the publication does not exist.
        throw new ApplicationException(String.Format(
            "The publication '{0}' does not exist on {1}.",
            publicationName, publisherName));
    }
}
catch (Exception ex)
{
    // Implement the appropriate error handling here.
    throw new ApplicationException(String.Format(
        "The subscription to {0} could not be created.", publicationName), ex);
}
finally
{
    subscriberConn.Disconnect();
    publisherConn.Disconnect();
}

' Define the Publisher, publication, and databases.
Dim publicationName As String = "AdvWorksSalesOrdersMerge"
Dim publisherName As String = publisherInstance
Dim subscriberName As String = subscriberInstance
Dim subscriptionDbName As String = "AdventureWorks2012Replica"
Dim publicationDbName As String = "AdventureWorks2012"
Dim hostname As String = "adventure-works\garrett1"

'Create connections to the Publisher and Subscriber.
Dim subscriberConn As ServerConnection = New ServerConnection(subscriberName)
Dim publisherConn As ServerConnection = New ServerConnection(publisherName)

' Create the objects that we need.
Dim publication As MergePublication
Dim subscription As MergePullSubscription

Try
    ' Connect to the Subscriber.
    subscriberConn.Connect()

    ' Ensure that the publication exists and that 
    ' it supports pull subscriptions.
    publication = New MergePublication()
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName
    publication.ConnectionContext = publisherConn

    If publication.LoadProperties() Then
        If (publication.Attributes And PublicationAttributes.AllowPull) = 0 Then
            publication.Attributes = publication.Attributes _
            Or PublicationAttributes.AllowPull
        End If

        ' Define the pull subscription.
        subscription = New MergePullSubscription()
        subscription.ConnectionContext = subscriberConn
        subscription.PublisherName = publisherName
        subscription.PublicationName = publicationName
        subscription.PublicationDBName = publicationDbName
        subscription.DatabaseName = subscriptionDbName
        subscription.HostName = hostname

        ' Specify the Windows login credentials for the Merge Agent job.
        subscription.SynchronizationAgentProcessSecurity.Login = winLogin
        subscription.SynchronizationAgentProcessSecurity.Password = winPassword

        ' Make sure that the agent job for the subscription is created.
        subscription.CreateSyncAgentByDefault = True

        ' Create the pull subscription at the Subscriber.
        subscription.Create()

        Dim registered As Boolean = False

        ' Verify that the subscription is not already registered.
        For Each existing As MergeSubscription In _
        publication.EnumSubscriptions()
            If existing.SubscriberName = subscriberName Then
                registered = True
            End If
        Next
        If Not registered Then
            ' Register the local subscription with the Publisher.
            publication.MakePullSubscriptionWellKnown( _
             subscriberName, subscriptionDbName, _
             SubscriptionSyncType.Automatic, _
             MergeSubscriberType.Local, 0)
        End If
    Else
        ' Do something here if the publication does not exist.
        Throw New ApplicationException(String.Format( _
         "The publication '{0}' does not exist on {1}.", _
         publicationName, publisherName))
    End If
Catch ex As Exception
    ' Implement the appropriate error handling here.
    Throw New ApplicationException(String.Format( _
        "The subscription to {0} could not be created.", publicationName), ex)
Finally
    subscriberConn.Disconnect()
    publisherConn.Disconnect()
End Try

Keterangan

Untuk langganan penarikan, Agen Penggabungan berjalan di Pelanggan.

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

MergePullSubscription()	Membuat instans MergePullSubscription baru kelas .
MergePullSubscription(String, String, String, String, ServerConnection)	Menginisialisasi instans MergePullSubscription baru kelas dengan database, Penerbit, publikasi, dan koneksi Pelanggan yang ditentukan.
MergePullSubscription(String, String, String, String, ServerConnection, Boolean)	Membuat instans MergePullSubscription baru kelas dengan database yang ditentukan, Penerbit, publikasi, koneksi Pelanggan, dan apakah pekerjaan agen dibuat.

Properti

AgentJobId	Mendapatkan ID pekerjaan agen yang digunakan untuk menyinkronkan langganan. (Diperoleh dari PullSubscription)
AgentOffload	Mendapatkan atau mengatur apakah Agen Sinkronisasi berjalan di komputer selain yang membuat pekerjaan agen atau tidak. Properti ini tidak lagi didukung untuk Distributor yang menjalankan Microsoft SQL Server 2005 dan yang lebih baru. (Diperoleh dari PullSubscription)
AgentOffloadServer	Mendapatkan atau mengatur nama komputer jarak jauh tempat agen berjalan saat menggunakan aktivasi agen jarak jauh. (Diperoleh dari PullSubscription)
AgentSchedule	Mendapatkan jadwal untuk pekerjaan agen yang digunakan untuk menyinkronkan langganan. (Diperoleh dari PullSubscription)
AltSnapshotFolder	Mendapatkan atau mengatur lokasi tempat file rekam jepret publikasi diperoleh ketika lokasi rekam jepret default di Distributor tidak digunakan. (Diperoleh dari PullSubscription)
CachePropertyChanges	Mendapatkan atau mengatur apakah akan menyimpan perubahan yang dilakukan pada properti replikasi atau segera menerapkannya. (Diperoleh dari ReplicationObject)
ConnectionContext	Mendapatkan atau mengatur koneksi ke instans Microsoft SQL Server. (Diperoleh dari ReplicationObject)
CreateSyncAgentByDefault	Mendapatkan atau mengatur apakah pekerjaan agen yang digunakan untuk memulai Agen Replikasi untuk menyinkronkan langganan dibuat saat langganan dibuat. (Diperoleh dari PullSubscription)
DatabaseName	Mendapatkan atau mengatur nama database langganan. (Diperoleh dari PullSubscription)
Description	Mendapatkan atau mengatur deskripsi tekstual dari langganan penarikan. (Diperoleh dari PullSubscription)
DistributorName	Mendapatkan atau mengatur instans Microsoft SQL Server yang merupakan Distributor dan mendistribusikan publikasi tempat langganan berlangganan. (Diperoleh dari PullSubscription)
DistributorSecurity	Mendapatkan konteks keamanan yang digunakan untuk menyambungkan ke Distributor. (Diperoleh dari PullSubscription)
DynamicSnapshotLocation	Mendapatkan atau mengatur lokasi file untuk file rekam jepret khusus langganan saat publikasi menggunakan filter baris berparameter.
EnabledForSynchronizationManager	Menentukan apakah langganan dapat disinkronkan menggunakan Pengelola Sinkronisasi Windows atau tidak. (Diperoleh dari PullSubscription)
FtpAddress	Mendapatkan atau mengatur alamat IP server FTP. (Diperoleh dari PullSubscription)
FtpLogin	Mendapatkan atau mengatur login FTP. (Diperoleh dari PullSubscription)
FtpPassword	Mendapatkan atau mengatur kata sandi FTP. (Diperoleh dari PullSubscription)
FtpPort	Mendapatkan atau mengatur nomor port untuk server FTP. (Diperoleh dari PullSubscription)
HostName	Mendapatkan atau mengatur nilai yang disediakan ke fungsi HOST_NAME saat fungsi ini digunakan dalam filter baris berparameter yang menentukan partisi data Pelanggan.
InternetLogin	Mendapatkan atau mengatur login yang digunakan dengan Autentikasi Dasar HTTP saat menyambungkan ke server Web selama sinkronisasi Web.
InternetPassword	Mendapatkan atau menyetel kata sandi untuk nilai yang disediakan InternetLogin saat menyambungkan ke server Web selama sinkronisasi Web.
InternetSecurityMode	Mendapatkan atau mengatur metode autentikasi HTTP yang digunakan saat menyambungkan ke server Web selama sinkronisasi Web.
InternetTimeout	Mendapatkan atau mengatur batas waktu HTTP, dalam detik, saat menyambungkan ke server Web selama sinkronisasi Web.
InternetUrl	Mendapatkan atau mengatur URL yang akan digunakan saat menyinkronkan langganan menggunakan sinkronisasi Web.
IsExistingObject	Mendapatkan apakah objek ada di server atau tidak. (Diperoleh dari ReplicationObject)
IsMemoryOptimized	Mewakili langganan penarikan ke publikasi gabungan. (Diperoleh dari PullSubscription)
LastAgentDateTime	Mendapatkan tanggal dan waktu saat langganan terakhir disinkronkan. (Diperoleh dari PullSubscription)
LastAgentStatus	Mendapatkan status sinkronisasi langganan terbaru. (Diperoleh dari PullSubscription)
LastAgentSummary	Mendapatkan ringkasan hasil sinkronisasi langganan terbaru. (Diperoleh dari PullSubscription)
Name	Mendapatkan nama yang dihasilkan untuk langganan penarikan. (Diperoleh dari PullSubscription)
Priority	Mendapatkan atau mengatur bobot langganan server ini relatif terhadap langganan server lain saat mengatasi konflik antar langganan.
PublicationDBName	Mendapatkan atau mengatur nama database publikasi. (Diperoleh dari PullSubscription)
PublicationName	Mendapatkan atau menetapkan nama publikasi tempat langganan berlangganan. (Diperoleh dari PullSubscription)
PublisherName	Mendapatkan atau mengatur nama Publisher. (Diperoleh dari PullSubscription)
PublisherSecurity	Mendapatkan atau mengatur konteks keamanan yang digunakan oleh Agen Sinkronisasi saat menyambungkan ke Publisher. (Diperoleh dari PullSubscription)
SecureFtpPassword	Mendapatkan atau mengatur kata sandi aman untuk login yang digunakan untuk menyambungkan ke server FTP. (Diperoleh dari PullSubscription)
SecureInternetPassword	Menyetel kata sandi (sebagai objek) yang SecureString digunakan saat menyambungkan ke server Web menggunakan Autentikasi Dasar HTTP.
SqlServerName	Mendapatkan nama instans Microsoft SQL Server tempat objek ini tersambung. (Diperoleh dari ReplicationObject)
SubscriberSecurity	Mendapatkan konteks keamanan yang digunakan oleh Agen Sinkronisasi saat menyambungkan ke Pelanggan. (Diperoleh dari PullSubscription)
SubscriberType	Mendapatkan atau mengatur apakah langganan adalah langganan server atau klien.
SubscriptionId	Mendapatkan nilai ID langganan. (Diperoleh dari PullSubscription)
SubscriptionType	Mendapatkan apakah pendaftaran langganan adalah untuk pendorongan, penarikan, atau langganan anonim. (Diperoleh dari PullSubscription)
SynchronizationAgent	Mendapatkan objek yang mewakili instans Agen Penggabungan yang dapat digunakan untuk menyinkronkan langganan.
SynchronizationAgentProcessSecurity	Mendapatkan konteks keamanan yang digunakan untuk menentukan akun Microsoft Windows tempat pekerjaan Agen Sinkronisasi berjalan untuk menyinkronkan langganan. (Diperoleh dari PullSubscription)
SyncType	Mendapatkan atau mengatur cara data diinisialisasi di Pelanggan.
Type	Mendapatkan atau mengatur jenis publikasi. (Diperoleh dari PullSubscription)
UseFtp	Mendapatkan atau mengatur apakah file rekam jepret yang diperlukan untuk menginisialisasi langganan penarikan diakses oleh Agen Sinkronisasi menggunakan Protokol Transfer File (FTP). (Diperoleh dari PullSubscription)
UseInteractiveResolver	Mendapatkan atau mengatur apakah Pemecah Masalah Interaktif digunakan selama proses sinkronisasi.
UserData	Mendapatkan atau mengatur properti objek yang memungkinkan pengguna melampirkan data mereka sendiri ke objek. (Diperoleh dari ReplicationObject)
UseWebSynchronization	Mendapatkan atau mengatur apakah langganan disinkronkan menggunakan sinkronisasi Web.
WorkingDirectory	Mendapatkan atau mengatur jalur direktori di Pelanggan yang digunakan untuk menyimpan sementara dan mendekompresi file rekam jepret yang diunduh. (Diperoleh dari PullSubscription)

Metode

CheckValidCreation()	Memeriksa pembuatan replikasi yang valid. (Diperoleh dari ReplicationObject)
CheckValidDefinition(Boolean)	Menunjukkan apakah definisi jika valid. (Diperoleh dari PullSubscription)
CommitPropertyChanges()	Mengirim semua pernyataan perubahan properti yang di-cache ke instans Microsoft SQL Server. (Diperoleh dari ReplicationObject)
Create()	Membuat langganan penarikan pada Pelanggan. (Diperoleh dari PullSubscription)
CustomEnabledForSyncMgr(StringBuilder)	Mengaktifkan publikasi kustom untuk manajer sinkron. (Diperoleh dari PullSubscription)
Decouple()	Memisahkan objek replikasi yang direferensikan dari server. (Diperoleh dari ReplicationObject)
EnumSynchronizationPartners()	Mengembalikan Mitra Sinkronisasi Alternatif
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)
InitMemberVariables(String, String, String, String, Boolean)	Menginisialisasi variabel anggota. (Diperoleh dari PullSubscription)
InternalRefresh(Boolean)	Memulai refresh internal dari replikasi. (Diperoleh dari ReplicationObject)
LastAgentJobHistoryInfo()	Mengembalikan informasi tentang pekerjaan Agen Sinkronisasi terakhir yang dijalankan. (Diperoleh dari PullSubscription)
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)
Reinitialize(Boolean)	Menandai langganan penarikan penggabungan untuk reinisialisasi.
Remove()	Menghapus langganan penarikan. (Diperoleh dari PullSubscription)
Script(ScriptOptions)	Mengembalikan skrip Transact-SQL untuk membuat atau menghapus langganan penarikan berdasarkan pengaturan PullSubscription properti objek saat ini. (Diperoleh dari PullSubscription)
StopSynchronizationJob()	Mencoba menghentikan pekerjaan Agen Penggabungan yang sedang berjalan yang saat ini menyinkronkan langganan.
SynchronizeWithJob()	Memulai pekerjaan agen secara asinkron untuk menyinkronkan langganan penarikan.

Berlaku untuk

Lihat juga

sp_helpmergealternatepublisher (Transact-SQL))