Как настроить подписку для использования веб-синхронизации (программирование объектов RMO)

Описанные в данном разделе процедуры являются третьим этапом в настройке веб-синхронизации при репликации слиянием. Этот шаг выполняется после включения публикации и настройки компьютера, на котором работают службы Microsoft IIS. Обзор этого процесса настройки см. в разделе Как настроить веб-синхронизацию для репликации слиянием (программирование объектов RMO). Если подписка настраивается на использование веб-синхронизации для подписчиков, которые могут соединяться с издателем только по протоколу HTTP, необходимо соответствующим образом настроить публикацию. Дополнительные сведения см. в разделе Как настроить публикацию для использования веб-синхронизации (программирование объектов RMO). После завершения выполнения процедуры, описанной в этом разделе, синхронизируйте созданную подписку. Дополнительные сведения см. в разделе Как синхронизировать подписку по запросу (программирование объектов RMO).

В этом разделе описываются параметры, необходимые для веб-синхронизации. Дополнительные сведения о создании подписок по запросу см. в разделе Как создать подписку по запросу (программирование объектов RMO).

Важно!

URL-адрес веб-сервера, используемого для веб-синхронизации (например https://сервер.домен.com/папка/replisapi.dll), указывает местоположение файла replisapi.dll. Если сервер настроен на нестандартный порт для протокола SSL (отличного от 443), то необходимо также указать номер порта в следующем формате: https://сервер.домен.com:номер_порта/каталог/replisapi.dll. Имя сервера в URL-адресе должно совпадать с именем, которое использовалось при создании сертификата. Например, в корпоративной сети может оказаться возможным подключение к веб-серверу, используя адрес вида https://сервер/. Однако если при создании сертификата было указано уточненное имя (например https://сервер.домен.com/), то его же следует использовать и в URL-адресе (https://сервер.домен.com/папка/replisapi.dll).

Настройка подписки для использования веб-синхронизации

1. Создайте соединения с подписчиком и издателем при помощи класса ServerConnection.

2. На основе соединения с издателем, созданного на шаге 1, создайте экземпляр класса MergePublication.

3. (Необязательно) Если база данных подписки не существует, создайте ее с помощью класса Database объектов SMO. Дополнительные сведения см. в разделе Создание, изменение и удаление баз данных.

4. Создайте экземпляр класса MergePullSubscription.

5. Укажите следующие свойства подписки:

   • Соединение ServerConnection с подписчиком, созданное на шаге 1, в свойстве ConnectionContext.

   • Имя базы данных подписки в свойстве DatabaseName.

   • Имя издателя в свойстве PublisherName.

   • Имя базы данных публикации в свойстве PublicationDBName.

   • Имя публикации в свойстве PublicationName.

   • Значение true для свойства UseWebSynchronization.

   • Расположение веб-сервера, где размещаются средства веб-синхронизации, для свойства InternetUrl.

   • Имя входа и пароль для учетной записи Windows, с которой работает агент слияния на подписчике, в полях Login и Password свойства SynchronizationAgentProcessSecurity соответственно. Эта учетная запись также используется, когда агент слияния устанавливает соединения с локальным подписчиком.

     Примечание
     Если публикация создается членом предопределенной роли сервера sysadmin, необязательно задавать свойство SnapshotGenerationAgentProcessSecurity. Дополнительные сведения см. в разделе Модель безопасности агента репликации.

   • Значение 0 в параметре InternetSecurityMode, а также значения InternetLogin и InternetPassword при использовании для подключения к веб-серверу по протоколу HTTP обычной проверки подлинности. Рекомендуется использовать этот метод проверки подлинности для веб-синхронизации. Дополнительные сведения см. в разделе Обеспечение безопасности репликации через Интернет.

6. Вызовите метод Create.

7. Для экземпляра класса MergePublication, созданного на шаге 2, вызовите метод MakePullSubscriptionWellKnown, чтобы зарегистрировать подписку по запросу для данного издателя.

Настройка подписки на использование веб-синхронизации для подписчиков, которые могут подключаться к издателю через веб-сервер только по протоколу HTTP

1. Создайте соединение с подписчиком с помощью класса ServerConnection.

2. (Необязательно) Если база данных подписки не существует, создайте ее с помощью класса Database объектов SMO. Дополнительные сведения см. в разделе Создание, изменение и удаление баз данных.

3. Создайте экземпляр класса MergePullSubscription.

4. Укажите следующие свойства подписки:

   • Объект ServerConnection, созданный на шаге 1, в свойстве ConnectionContext.

   • Имя базы данных подписки в свойстве DatabaseName.

   • Имя издателя в свойстве PublisherName.

   • Имя базы данных публикации в свойстве PublicationDBName.

   • Имя публикации в свойстве PublicationName.

   • Значение Anonymous в параметре SubscriberType.

   • Значение true для свойства UseWebSynchronization.

   • Расположение веб-сервера, где размещаются средства веб-синхронизации, для свойства InternetUrl.

   • Имя входа и пароль для учетной записи Windows, с которой работает агент слияния на подписчике, в полях Login и Password свойства SynchronizationAgentProcessSecurity соответственно. Эта учетная запись также используется, когда агент слияния устанавливает соединения с локальным подписчиком.

     Примечание
     Если публикация создается членом предопределенной роли сервера sysadmin, необязательно задавать свойство SnapshotGenerationAgentProcessSecurity. Дополнительные сведения см. в разделе Модель безопасности агента репликации.

   • Значение 0 в параметре InternetSecurityMode, а также значения InternetLogin и InternetPassword при использовании для подключения к веб-серверу по протоколу HTTP обычной проверки подлинности. Рекомендуется использовать этот метод проверки подлинности для веб-синхронизации. Дополнительные сведения см. в разделе Обеспечение безопасности репликации через Интернет.

5. Вызовите метод Create.

Пример

В следующем примере производится создание подписки, синхронизируемой с издателем с использованием веб-синхронизации.

           // 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";
            string webSyncUrl = "https://" + publisherInstance + "/WebSync/replisapi.dll";

            //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 and Web synchronization.
                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;
                    }
                    if ((publication.Attributes & PublicationAttributes.AllowWebSynchronization) == 0)
                    {
                        publication.Attributes |= PublicationAttributes.AllowWebSynchronization;
                    }

                    // 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;

                    // Enable Web synchronization.
                    subscription.UseWebSynchronization = true;
                    subscription.InternetUrl = webSyncUrl;

                    // Specify the same Windows credentials to use when connecting to the
                    // Web server using HTTPS Basic Authentication.
                    subscription.InternetSecurityMode = AuthenticationMethod.BasicAuthentication;
                    subscription.InternetLogin = winLogin;
                    subscription.InternetPassword = winPassword;

                    // Ensure that we create a job for this subscription.
                    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 = "AdventureWorks2008R2Replica"
Dim publicationDbName As String = "AdventureWorks2008R2"
Dim hostname As String = "adventure-works\garrett1"
Dim webSyncUrl As String = "https://" + publisherInstance + "/WebSync/replisapi.dll"

'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 and Web synchronization.
    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
        If (publication.Attributes And PublicationAttributes.AllowWebSynchronization) = 0 Then
            publication.Attributes = publication.Attributes _
            Or PublicationAttributes.AllowWebSynchronization
        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
        subscription.CreateSyncAgentByDefault = True

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

        ' Enable Web synchronization.
        subscription.UseWebSynchronization = True
        subscription.InternetUrl = webSyncUrl

        ' Specify the same Windows credentials to use when connecting to the
        ' Web server using HTTPS Basic Authentication.
        subscription.InternetSecurityMode = AuthenticationMethod.BasicAuthentication
        subscription.InternetLogin = winLogin
        subscription.InternetPassword = winPassword

        ' 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

В следующем примере создается подписка, синхронизируемая с издателем с использованием веб-синхронизации. При этом подписчик может подключаться к издателю только через веб-сервер по протоколу HTTP.

// The publication must support anonymous Subscribers, pull 
// subscriptions, and Web synchronization.
// 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";
string webSyncUrl = "https://" + publisherInstance + "/WebSync/replisapi.dll";

//Create the Subscriber connection.
ServerConnection conn = new ServerConnection(subscriberName);

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

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

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

    // Specify an anonymous Subscriber type since we can't 
    // register at the Publisher with a direct connection.
    subscription.SubscriberType = MergeSubscriberType.Anonymous;

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

    // Enable Web synchronization.
    subscription.UseWebSynchronization = true;
    subscription.InternetUrl = webSyncUrl;

    // Specify the same Windows credentials to use when connecting to the
    // Web server using HTTPS Basic Authentication.
    subscription.InternetSecurityMode = AuthenticationMethod.BasicAuthentication;
    subscription.InternetLogin = winLogin;
    subscription.InternetPassword = winPassword;

    // Ensure that we create a job for this subscription.
    subscription.CreateSyncAgentByDefault = true;

    // Create the pull subscription at the Subscriber.
    subscription.Create();
}
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();
}

' The publication must support anonymous Subscribers, pull 
' subscriptions, and Web synchronization.
' 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"
Dim webSyncUrl As String = "https://" + publisherInstance + "/WebSync/replisapi.dll"

'Create the Subscriber connection.
Dim conn As ServerConnection = New ServerConnection(subscriberName)

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

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

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

    ' Specify an anonymous Subscriber type since we can't 
    ' register at the Publisher with a direct connection.
    subscription.SubscriberType = MergeSubscriberType.Anonymous

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

    ' Enable Web synchronization.
    subscription.UseWebSynchronization = True
    subscription.InternetUrl = webSyncUrl

    ' Specify the same Windows credentials to use when connecting to the
    ' Web server using HTTPS Basic Authentication.
    subscription.InternetSecurityMode = AuthenticationMethod.BasicAuthentication
    subscription.InternetLogin = winLogin
    subscription.InternetPassword = winPassword

    ' Ensure that we create a job for this subscription.
    subscription.CreateSyncAgentByDefault = True

    ' Create the pull subscription at the Subscriber.
    subscription.Create()
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

См. также

Задания

Как создать подписку по запросу (программирование объектов RMO)

Основные понятия

Как настроить веб-синхронизацию для репликации слиянием (программирование репликации на языке Transact-SQL)

Веб-синхронизация для репликации слиянием