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) |
Возвращает команду на создание из репликации. (Унаследовано от ReplicationObject) |
GetDropCommand(StringBuilder, Boolean) |
Возвращает команду на удаление из репликации. (Унаследовано от ReplicationObject) |
InternalRefresh(Boolean) |
Инициирует внутреннее обновление из репликации. (Унаследовано от ReplicationObject) |
Load() |
Загружает свойства существующего объекта с сервера. (Унаследовано от ReplicationObject) |
LoadProperties() |
Загружает свойства существующего объекта с сервера. (Унаследовано от ReplicationObject) |
Refresh() |
Повторно загружает свойства объекта. (Унаследовано от ReplicationObject) |
RegisterBusinessLogicHandler(BusinessLogicHandler) |
Регистрирует сборку обработчика бизнес-логики на распространителе. |
Remove() |
Удаляет базу данных распространителя. |
Script(ScriptOptions) |
Создает скрипт Transact-SQL, который можно использовать для создания или удаления базы данных распространителя, которую представляет объект . |
UnregisterBusinessLogicHandler(BusinessLogicHandler) |
Удаляет регистрацию обработчика бизнес-логики из распространителя. |