Jak Utwórz subskrypcję wypychaną (Programowanie RMO)

Można utworzyć wypychanie subskrypcje programowo, używając obiektów zarządzania replikacji (RMO).Służy do tworzenia klas RMO subskrypcja wypychana zależą od typu publikacja, do której jest tworzona subskrypcji.

Uwaga dotycząca zabezpieczeń
Jeśli to możliwe, monitują użytkowników o wprowadzenie poświadczenia zabezpieczeń w czasie wykonywania.Jeśli poświadczenia muszą być przechowywane, usługi kryptograficzne dostarczonych przez Microsoft systemu Windows.NET Framework.

Aby utworzyć subskrypcja wypychana migawka lub transakcyjnych publikacja

1. Tworzenie połączenia do Wydawca za pomocą ServerConnection klasy

2. Utworzenie wystąpienie TransPublication klasy przy użyciu połączenia Wydawca z kroku 1.Specify Name, DatabaseName, and ConnectionContext.

3. Wywołanie LoadProperties metoda.Jeśli ta metoda zwraca false, albo właściwości określonego w kroku 2 są niepoprawne lub publikacja nie istnieje na serwerze.

4. Wykonuje logiczną operację AND (& w środowisku Visual C# i And w języku Visual Basic) między Attributes właściwość i AllowPush.If the result is None, set Attributes to the result of a bitwise logical OR (|in Visual C# and Or in Visual Basic) between Attributes and AllowPush.Następnie należy wywołać CommitPropertyChanges włączyć wypychanie subskrypcje.

5. Jeśli baza danych subskrypcja nie istnieje, utwórz go za pomocą Database klasyAby uzyskać więcej informacji, zobacz Tworzenie, modyfikowanie i usuwanie baz danych.

6. Utworzenie wystąpienie TransSubscription klasy

7. Ustaw następujące właściwości subskrypcja:

   • ServerConnection Do Wydawca, utworzony w kroku 1 dla ConnectionContext.

   • Nazwa baza danych subskrypcja dla SubscriptionDBName.

   • Subskrybenta dla SubscriberName.

   • Nazwa baza danych publikacja dla DatabaseName.

   • Nazwa publikacja dla PublicationName.

   • Login i Password lub SecurePassword pola SynchronizationAgentProcessSecurity o podanie poświadczenia dla Microsoft Windows konto agenta dystrybucji dystrybutora.To konto jest używane do ustanowienia lokalnego połączenia do dystrybutora i nawiązywanie połączeń zdalnych za pomocą uwierzytelniania systemu Windows.

     Ostrzeżenie

     Ustawienie SynchronizationAgentProcessSecurity nie jest wymagane podczas tworzenia subskrypcja przez element członkowski sysadmin stała rola serwera, jednak zaleca.W takim przypadek agent personifikuje konto agenta programu SQL Server.Aby uzyskać więcej informacji, zobacz Model zabezpieczeń Agent replikacji.

   • (Opcjonalnie) Wartość true (domyślnie) dla CreateSyncAgentByDefault utworzyć zadanie agenta, który jest używany do synchronizacji subskrypcja.Jeśli określisz false, subskrypcja mogą być synchronizowane tylko programowo.

   • (Opcjonalnie) Ustaw SqlStandardLogin i SqlStandardPassword lub SecureSqlStandardPassword pola SubscriberSecurity podczas używania uwierzytelniania programu SQL Server, aby połączyć subskrybenta.

8. Wywołanie Create metoda.

   Uwaga dotycząca zabezpieczeń
   Podczas tworzenia subskrypcja wypychanej wydawca z dystrybutor zdalny, wartości dostarczone dla wszystkich właściwości, łącznie z SynchronizationAgentProcessSecurity, są wysyłane do dystrybutora jako zwykły tekst.Należy zaszyfrować połączenie między Wydawca i jego dystrybutor zdalny przed wywoływaniem Create metoda.Aby uzyskać więcej informacji, zobacz Szyfrowania połączeńSQL Server.

Aby utworzyć subskrypcja wypychana do publikacja korespondencji seryjnej

1. Tworzenie połączenia do Wydawca za pomocą ServerConnection klasy

2. Utworzenie wystąpienie MergePublication klasy przy użyciu połączenia Wydawca z kroku 1.Specify Name, DatabaseName, and ConnectionContext.

3. Wywołanie LoadProperties metoda.Jeśli ta metoda zwraca false, albo właściwości określonego w kroku 2 są niepoprawne lub publikacja nie istnieje na serwerze.

4. Wykonuje logiczną operację AND (& w środowisku Visual C# i And w języku Visual Basic) między Attributes właściwość i AllowPush.If the result is None, set Attributes to the result of a bitwise logical OR (|in Visual C# and Or in Visual Basic) between Attributes and AllowPush.Następnie należy wywołać CommitPropertyChanges włączyć wypychanie subskrypcje.

5. Jeśli baza danych subskrypcja nie istnieje, utwórz go za pomocą Database klasyAby uzyskać więcej informacji, zobacz Tworzenie, modyfikowanie i usuwanie baz danych.

6. Utworzenie wystąpienie MergeSubscription klasy

7. Ustaw następujące właściwości subskrypcja:

   • ServerConnection Do Wydawca, utworzony w kroku 1 dla ConnectionContext.

   • Nazwa baza danych subskrypcja dla SubscriptionDBName.

   • Subskrybenta dla SubscriberName.

   • Nazwa baza danych publikacja dla DatabaseName.

   • Nazwa publikacja dla PublicationName.

   • Login i Password lub SecurePassword pola SynchronizationAgentProcessSecurity o podanie poświadczenia dla Microsoft Windows konto agenta scalanie u dystrybutora.To konto jest używane do ustanowienia lokalnego połączenia do dystrybutora i nawiązywanie połączeń zdalnych za pomocą uwierzytelniania systemu Windows.

     Ostrzeżenie

     Ustawienie SynchronizationAgentProcessSecurity nie jest wymagane podczas tworzenia subskrypcja przez element członkowski sysadmin stała rola serwera, jednak zaleca.W takim przypadek agent personifikuje konto agenta programu SQL Server.Aby uzyskać więcej informacji, zobacz Model zabezpieczeń Agent replikacji.

   • (Opcjonalnie) Wartość true (domyślnie) dla CreateSyncAgentByDefault utworzyć zadanie agenta, który jest używany do synchronizacji subskrypcja.Jeśli określisz false, subskrypcja mogą być synchronizowane tylko programowo.

   • (Opcjonalnie) Ustaw SqlStandardLogin i SqlStandardPassword lub SecureSqlStandardPassword pola SubscriberSecurity podczas używania uwierzytelniania programu SQL Server, aby połączyć subskrybenta.

   • (Opcjonalnie) Ustaw SqlStandardLogin i SqlStandardPassword lub SecureSqlStandardPassword pola PublisherSecurity podczas używania uwierzytelniania programu SQL Server, aby połączyć Wydawca.

8. Wywołanie Create metoda.

   Uwaga dotycząca zabezpieczeń
   Podczas tworzenia subskrypcja wypychanej wydawca z dystrybutor zdalny, wartości dostarczone dla wszystkich właściwości, łącznie z SynchronizationAgentProcessSecurity, są wysyłane do dystrybutora jako zwykły tekst.Należy zaszyfrować połączenie między Wydawca i jego dystrybutor zdalny przed wywoływaniem Create metoda.Aby uzyskać więcej informacji, zobacz Szyfrowania połączeńSQL Server.

Przykład

To przykładowe polecenie tworzy nowy subskrypcja wypychana do publikacja transakcyjnych.Poświadczenia konta systemu Windows, można użyć do uruchomienia zadanie agenta dystrybucji są przekazywane w czasie wykonywania.

           // Define the Publisher, publication, and databases.
            string publicationName = "AdvWorksProductTran";
            string publisherName = publisherInstance;
            string subscriberName = subscriberInstance;
            string subscriptionDbName = "AdventureWorks2008R2Replica";
            string publicationDbName = "AdventureWorks2008R2";

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

            // Create the objects that we need.
            TransPublication publication;
            TransSubscription subscription;

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

                // Ensure that the publication exists and that 
                // it supports push subscriptions.
                publication = new TransPublication();
                publication.Name = publicationName;
                publication.DatabaseName = publicationDbName;
                publication.ConnectionContext = conn;

                if (publication.IsExistingObject)
                {
                    if ((publication.Attributes & PublicationAttributes.AllowPush) == 0)
                    {
                        publication.Attributes |= PublicationAttributes.AllowPush;
                    }

                    // Define the push subscription.
                    subscription = new TransSubscription();
                    subscription.ConnectionContext = conn;
                    subscription.SubscriberName = subscriberName;
                    subscription.PublicationName = publicationName;
                    subscription.DatabaseName = publicationDbName;
                    subscription.SubscriptionDBName = subscriptionDbName;

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

                    // By default, subscriptions to transactional publications are synchronized 
                    // continuously, but in this case we only want to synchronize on demand.
                    subscription.AgentSchedule.FrequencyType = ScheduleFrequencyType.OnDemand;

                    // Create the push subscription.
                    subscription.Create();
                }
                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
            {
                conn.Disconnect();
            }

' Define the Publisher, publication, and databases.
Dim publicationName As String = "AdvWorksProductTran"
Dim publisherName As String = publisherInstance
Dim subscriberName As String = subscriberInstance
Dim subscriptionDbName As String = "AdventureWorks2008R2Replica"
Dim publicationDbName As String = "AdventureWorks2008R2"

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

' Create the objects that we need.
Dim publication As TransPublication
Dim subscription As TransSubscription

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

    ' Ensure that the publication exists and that 
    ' it supports push subscriptions.
    publication = New TransPublication()
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName
    publication.ConnectionContext = conn

    If publication.IsExistingObject Then
        If (publication.Attributes And PublicationAttributes.AllowPush) = 0 Then
            publication.Attributes = publication.Attributes _
            Or PublicationAttributes.AllowPush
        End If

        ' Define the push subscription.
        subscription = New TransSubscription()
        subscription.ConnectionContext = conn
        subscription.SubscriberName = subscriberName
        subscription.PublicationName = publicationName
        subscription.DatabaseName = publicationDbName
        subscription.SubscriptionDBName = subscriptionDbName

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

        ' By default, subscriptions to transactional publications are synchronized 
        ' continuously, but in this case we only want to synchronize on demand.
        subscription.AgentSchedule.FrequencyType = ScheduleFrequencyType.OnDemand

        ' Create the push subscription.
        subscription.Create()
    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
    conn.Disconnect()
End Try

To przykładowe polecenie tworzy nowy subskrypcja wypychana do publikacja korespondencji seryjnej.Poświadczenia konta systemu Windows, można użyć do uruchomienia zadanie agenta scalania są przekazywane w czasie wykonywania.

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

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

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

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

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

                if (publication.IsExistingObject)
                {
                    if ((publication.Attributes & PublicationAttributes.AllowPush) == 0)
                    {
                        publication.Attributes |= PublicationAttributes.AllowPush;
                    }

                    // Define the push subscription.
                    subscription = new MergeSubscription();
                    subscription.ConnectionContext = conn;
                    subscription.SubscriberName = subscriberName;
                    subscription.PublicationName = publicationName;
                    subscription.DatabaseName = publicationDbName;
                    subscription.SubscriptionDBName = subscriptionDbName;
                    subscription.HostName = hostname;

                    // Set a schedule to synchronize the subscription every 2 hours
                    // during weekdays from 6am to 10pm.
                    subscription.AgentSchedule.FrequencyType = ScheduleFrequencyType.Weekly;
                    subscription.AgentSchedule.FrequencyInterval = Convert.ToInt32(0x003E);
                    subscription.AgentSchedule.FrequencyRecurrenceFactor = 1;
                    subscription.AgentSchedule.FrequencySubDay = ScheduleFrequencySubDay.Hour;
                    subscription.AgentSchedule.FrequencySubDayInterval = 2;
                    subscription.AgentSchedule.ActiveStartDate = 20051108;
                    subscription.AgentSchedule.ActiveEndDate = 20071231;
                    subscription.AgentSchedule.ActiveStartTime = 060000;
                    subscription.AgentSchedule.ActiveEndTime = 100000;

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

                    // Create the push subscription.
                    subscription.Create();
                }
                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
            {
                conn.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 = "AdventureWorks2008R2Replica"
Dim publicationDbName As String = "AdventureWorks2008R2"
Dim hostname As String = "adventure-works\garrett1"

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

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

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

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

    If publication.IsExistingObject Then
        If (publication.Attributes And PublicationAttributes.AllowPush) = 0 Then
            publication.Attributes = publication.Attributes _
            Or PublicationAttributes.AllowPush
        End If

        ' Define the push subscription.
        subscription = New MergeSubscription()
        subscription.ConnectionContext = conn
        subscription.SubscriberName = subscriberName
        subscription.PublicationName = publicationName
        subscription.DatabaseName = publicationDbName
        subscription.SubscriptionDBName = subscriptionDbName
        subscription.HostName = hostname

        ' Set a schedule to synchronize the subscription every 2 hours
        ' during weekdays from 6am to 10pm.
        subscription.AgentSchedule.FrequencyType = ScheduleFrequencyType.Weekly
        subscription.AgentSchedule.FrequencyInterval = Convert.ToInt32("0x003E", 16)
        subscription.AgentSchedule.FrequencyRecurrenceFactor = 1
        subscription.AgentSchedule.FrequencySubDay = ScheduleFrequencySubDay.Hour
        subscription.AgentSchedule.FrequencySubDayInterval = 2
        subscription.AgentSchedule.ActiveStartDate = 20051108
        subscription.AgentSchedule.ActiveEndDate = 20071231
        subscription.AgentSchedule.ActiveStartTime = 60000
        subscription.AgentSchedule.ActiveEndTime = 100000

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

        ' Create the push subscription.
        subscription.Create()
    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
    conn.Disconnect()
End Try

Zobacz także

Zadania

Jak Tworzenie publikacji (Programowanie RMO)

Jak Utwórz subskrypcję wypychaną (Programowanie replikacji Transact-SQL)

Jak Synchronizowanie subskrypcji wypychanej (Programowanie RMO)

Koncepcje

Pojęcia dotyczące obiektów zarządzania replikacją

Subskrybowanie publikacje