Поделиться через


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

Публикацию и распространение репликации можно настраивать программно, с помощью объектов RMO.

Настройка публикации и распространения на одиночном сервере

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

  2. Создайте экземпляр класса ReplicationServer. Передайте объект ServerConnection, созданный на шаге 1.

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

  4. Задайте для свойства Name имя базы данных, а для свойства ConnectionContext — значение ServerConnection из шага 1.

  5. Установите распространитель, вызвав метод InstallDistributor. Передайте объект DistributionDatabase, созданный на шаге 3.

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

  7. Установите следующие свойства DistributionPublisher.

    • Name — имя издателя.

    • ConnectionContext — соединение ServerConnection, созданное на шаге 1.

    • DistributionDatabase — название базы данных, созданной на шаге 5.

    • WorkingDirectory — общая папка, используемая для доступа к файлам моментальных снимков.

    • PublisherSecurity — режим безопасности, используемый при соединении с издателем. Рекомендуется использовать режим WindowsAuthentication.

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

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

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

  2. Создайте экземпляр класса ReplicationServer. Передайте объект ServerConnection, созданный на шаге 1.

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

  4. Задайте для свойства Name имя базы данных, а для свойства ConnectionContext — значение ServerConnection из шага 1.

  5. Установите распространитель, вызвав метод InstallDistributor. Укажите безопасный пароль (используемый издателем для соединения с удаленным распространителем) и объект DistributionDatabase из шага 3. Дополнительные сведения см. в разделе Защита распространителя.

    Примечание по безопасностиПримечание по безопасности

    По возможности предлагайте пользователям вводить учетные данные системы безопасности во время выполнения. Если необходимо хранить учетные данные, используйте службы шифрования, предоставляемые платформой Microsoft Windows .NET Framework.

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

  7. Установите следующие свойства DistributionPublisher.

    • Name — имя локального издателя.

    • ConnectionContext — соединение ServerConnection, созданное на шаге 1.

    • DistributionDatabase — название базы данных, созданной на шаге 5.

    • WorkingDirectory — общая папка, используемая для доступа к файлам моментальных снимков.

    • PublisherSecurity — режим безопасности, используемый при соединении с издателем. Рекомендуется использовать режим WindowsAuthentication.

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

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

  10. Создайте экземпляр класса ReplicationServer. Передайте объект ServerConnection, созданный на шаге 9.

  11. Вызовите метод InstallDistributor. Передайте имя удаленного распространителя и пароль для удаленного распространителя, указанный в шаге 5.

    Примечание по безопасностиПримечание по безопасности

    По возможности предлагайте пользователям вводить учетные данные системы безопасности во время выполнения. Если необходимо хранить учетные данные, используйте службы шифрования, предоставляемые платформой Windows .NET Framework.

Пример

В следующем примере показана настройка сервера в качестве издателя с удаленным распространителем.

         // Set the server and database names
            string distributionDbName = "distribution";
            string publisherName = publisherInstance;
            string publicationDbName = "AdventureWorks2008R2";

            DistributionDatabase distributionDb;
            ReplicationServer distributor;
            DistributionPublisher publisher;
            ReplicationDatabase publicationDb;

            // Create a connection to the server using Windows Authentication.
            ServerConnection conn = new ServerConnection(publisherName);

            try
            {
                // Connect to the server acting as the Distributor 
                // and local Publisher.
                conn.Connect();

                // Define the distribution database at the Distributor,
                // but do not create it now.
                distributionDb = new DistributionDatabase(distributionDbName, conn);
                distributionDb.MaxDistributionRetention = 96;
                distributionDb.HistoryRetention = 120;

                // Set the Distributor properties and install the Distributor.
                // This also creates the specified distribution database.
                distributor = new ReplicationServer(conn);
                distributor.InstallDistributor((string)null, distributionDb);

                // Set the Publisher properties and install the Publisher.
                publisher = new DistributionPublisher(publisherName, conn);
                publisher.DistributionDatabase = distributionDb.Name;
                publisher.WorkingDirectory = @"\\" + publisherName + @"\repldata";
                publisher.PublisherSecurity.WindowsAuthentication = true;
                publisher.Create();

                // Enable AdventureWorks as a publication database.
                publicationDb = new ReplicationDatabase(publicationDbName, conn);

                publicationDb.EnabledTransPublishing = true;
                publicationDb.EnabledMergePublishing = true;
            }
            catch (Exception ex)
            {
                // Implement appropriate error handling here.
                throw new ApplicationException("An error occured when installing distribution and publishing.", ex);
            }
            finally
            {
                conn.Disconnect();
            }
' Set the server and database names
Dim distributionDbName As String = "distribution"
Dim publisherName As String = publisherInstance
Dim publicationDbName As String = "AdventureWorks2008R2"

Dim distributionDb As DistributionDatabase
Dim distributor As ReplicationServer
Dim publisher As DistributionPublisher
Dim publicationDb As ReplicationDatabase

' Create a connection to the server using Windows Authentication.
Dim conn As ServerConnection = New ServerConnection(publisherName)

Try
    ' Connect to the server acting as the Distributor 
    ' and local Publisher.
    conn.Connect()

    ' Define the distribution database at the Distributor,
    ' but do not create it now.
    distributionDb = New DistributionDatabase(distributionDbName, conn)
    distributionDb.MaxDistributionRetention = 96
    distributionDb.HistoryRetention = 120

    ' Set the Distributor properties and install the Distributor.
    ' This also creates the specified distribution database.
    distributor = New ReplicationServer(conn)
    distributor.InstallDistributor((CType(Nothing, String)), distributionDb)

    ' Set the Publisher properties and install the Publisher.
    publisher = New DistributionPublisher(publisherName, conn)
    publisher.DistributionDatabase = distributionDb.Name
    publisher.WorkingDirectory = "\\" + publisherName + "\repldata"
    publisher.PublisherSecurity.WindowsAuthentication = True
    publisher.Create()

    ' Enable AdventureWorks as a publication database.
    publicationDb = New ReplicationDatabase(publicationDbName, conn)

    publicationDb.EnabledTransPublishing = True
    publicationDb.EnabledMergePublishing = True

Catch ex As Exception
    ' Implement appropriate error handling here.
    Throw New ApplicationException("An error occured when installing distribution and publishing.", ex)

Finally
    conn.Disconnect()

End Try