DistributionDatabase Класс

Определение

Представляет базу данных распределения в Дистрибьюторе.

public ref class DistributionDatabase sealed : Microsoft::SqlServer::Replication::ReplicationObject
public sealed class DistributionDatabase : Microsoft.SqlServer.Replication.ReplicationObject
type DistributionDatabase = class
    inherit ReplicationObject
Public NotInheritable Class DistributionDatabase
Inherits ReplicationObject
Наследование
DistributionDatabase

Примеры

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

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 AdventureWorks2012 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 = "AdventureWorks2012"

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 AdventureWorks2012 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

Комментарии

Потокобезопасность

Любые публичные статические (Sharedв Microsoft Visual Basic) члены этого типа безопасны для многопоточных операций. Никакие члены экземпляра не гарантированы как потокобезопасные.

Конструкторы

Имя Описание
DistributionDatabase()

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

DistributionDatabase(String, ServerConnection)

Создаёт новый экземпляр DistributionDatabase класса с указанным именем базы данных и соединением с Дистрибьютором.

Свойства

Имя Описание
CachePropertyChanges

Получает или задаёт, кэшировать ли изменения, внесённые в свойства репликации, или применять их сразу.

(Унаследовано от ReplicationObject)
ConnectionContext

Получает или устанавливает соединение с экземпляром Microsoft SQL Server.

(Унаследовано от ReplicationObject)
DataFile

Получает или устанавливает имя файла данных для базы данных распределения.

DataFileSize

Получает или устанавливает размер первичного файла базы данных для базы данных распределения.

DataFolder

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

DistributionCleanupTaskName

Получает название задачи агент SQL Server, отвечающей за очистку таблиц репликации в дистрибутиве.

DistributorSecurity

Получает контекст безопасности, используемый для подключения к Дистрибьютору с целью создания базы данных распределения.

HistoryCleanupTaskName

Получает название задачи агент SQL Server, отвечающей за очистку таблиц истории репликации.

HistoryRetention

Получает или устанавливает продолжительность времени, в часах, чтобы сохранялись данные об истории репликационных агентов.

IsExistingObject

Понимает, существует ли объект на сервере или нет.

(Унаследовано от ReplicationObject)
LogFile

Получает или устанавливает имя файла, который хранит журналы транзакций базы данных.

LogFileSize

Получает или устанавливает размер файла, который хранит записи транзакций базы данных.

LogFolder

Получает или устанавливает путь к каталогу, где находится файл, хранящий записи транзакций базы данных.

MaxDistributionRetention

Получает или устанавливает максимальный период хранения — в часах — до удаления транзакций из базы данных распределения.

MinDistributionRetention

Получает или устанавливает минимальный срок хранения в часах до удаления транзакций из базы данных.

Name

Получает или устанавливает имя базы данных распределения.

QueueReaderAgentExists

Определяет, создано ли задание агента читателя очереди для этой базы данных распределения.

QueueReaderAgentName

Получает или устанавливает имя задания агента Очереди, созданного для этой базы данных распределения.

QueueReaderAgentProcessSecurity

Получает контекст безопасности процесса агента для выполнения задачи Очередного Агента.

SqlServerName

Получает имя экземпляра Microsoft SQL Server, к которому подключён этот объект.

(Унаследовано от ReplicationObject)
UserData

Получает или устанавливает свойство объекта, позволяющее пользователям прикреплять к объекту свои собственные данные.

(Унаследовано от ReplicationObject)

Методы

Имя Описание
CheckValidCreation()

Проверяет допустимое создание репликации.

(Унаследовано от ReplicationObject)
CheckValidDefinition(Boolean)

Указывает, действительно ли определение.

(Унаследовано от ReplicationObject)
CleanUpAnonymousSubscription(Int32, PublicationType)

Удаляет метаданные для анонимных подписок в Дистрибьюторе.

CommitPropertyChanges()

Отправляет все кэшированные операторы изменения свойств на экземпляр Microsoft SQL Server.

(Унаследовано от ReplicationObject)
Create()

Создаёт базу данных распределения.

CreateQueueReaderAgent()

Создаёт задание агента читателя очереди в базе данных распределения.

Decouple()

Отделяет объект репликации, на который связан, от сервера.

(Унаследовано от ReplicationObject)
GetChangeCommand(StringBuilder, String, String)

Возвращает команду изменения из репликации.

(Унаследовано от ReplicationObject)
GetCreateCommand(StringBuilder, Boolean, ScriptOptions)

Возвращает команду create из репликации.

(Унаследовано от ReplicationObject)
GetDropCommand(StringBuilder, Boolean)

Возвращает команду drop из репликации.

(Унаследовано от ReplicationObject)
InternalRefresh(Boolean)

Запускает внутреннее обновление после репликации.

(Унаследовано от ReplicationObject)
Load()

Загружает свойства существующего объекта с сервера.

(Унаследовано от ReplicationObject)
LoadProperties()

Загружает свойства существующего объекта с сервера.

(Унаследовано от ReplicationObject)
Refresh()

Перезагружает свойства объекта.

(Унаследовано от ReplicationObject)
RegisterBusinessLogicHandler(BusinessLogicHandler)

Регистрирует сборку обработчика бизнес-логики на дистрибьюторе.

Remove()

Удаляет базу данных распределения.

Script(ScriptOptions)

Генерирует Transact-SQL-скрипт, который может быть использован для создания или удаления базы данных распределения, представленной объектом.

UnregisterBusinessLogicHandler(BusinessLogicHandler)

Удаляет регистрацию обработчика бизнес-логики у Дистрибьютора.

Применяется к

См. также раздел