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
- Наследование
Примеры
// 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) |
Удаляет регистрацию обработчика бизнес-логики у Дистрибьютора. |