TransArticle Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет статью в публикации транзакций.
public ref class TransArticle sealed : Microsoft::SqlServer::Replication::Articlepublic sealed class TransArticle : Microsoft.SqlServer.Replication.Articletype TransArticle = class
inherit ArticlePublic NotInheritable Class TransArticle
Inherits Article- Наследование
Примеры
// Define the Publisher, publication, and article names.
string publisherName = publisherInstance;
string publicationName = "AdvWorksProductTran";
string publicationDbName = "AdventureWorks2012";
string articleName = "Product";
string schemaOwner = "Production";
TransArticle article;
// Create a connection to the Publisher.
ServerConnection conn = new ServerConnection(publisherName);
// Create a filtered transactional articles in the following steps:
// 1) Create the article with a horizontal filter clause.
// 2) Add columns to or remove columns from the article.
try
{
// Connect to the Publisher.
conn.Connect();
// Define a horizontally filtered, log-based table article.
article = new TransArticle();
article.ConnectionContext = conn;
article.Name = articleName;
article.DatabaseName = publicationDbName;
article.SourceObjectName = articleName;
article.SourceObjectOwner = schemaOwner;
article.PublicationName = publicationName;
article.Type = ArticleOptions.LogBased;
article.FilterClause = "DiscontinuedDate IS NULL";
// Ensure that we create the schema owner at the Subscriber.
article.SchemaOption |= CreationScriptOptions.Schema;
if (!article.IsExistingObject)
{
// Create the article.
article.Create();
}
else
{
throw new ApplicationException(String.Format(
"The article {0} already exists in publication {1}.",
articleName, publicationName));
}
// Create an array of column names to remove from the article.
String[] columns = new String[1];
columns[0] = "DaysToManufacture";
// Remove the column from the article.
article.RemoveReplicatedColumns(columns);
}
catch (Exception ex)
{
// Implement appropriate error handling here.
throw new ApplicationException("The article could not be created.", ex);
}
finally
{
conn.Disconnect();
}
' Define the Publisher, publication, and article names.
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksProductTran"
Dim publicationDbName As String = "AdventureWorks2012"
Dim articleName As String = "Product"
Dim schemaOwner As String = "Production"
Dim article As TransArticle
' Create a connection to the Publisher.
Dim conn As ServerConnection = New ServerConnection(publisherName)
' Create a filtered transactional articles in the following steps:
' 1) Create the article with a horizontal filter clause.
' 2) Add columns to or remove columns from the article.
Try
' Connect to the Publisher.
conn.Connect()
' Define a horizontally filtered, log-based table article.
article = New TransArticle()
article.ConnectionContext = conn
article.Name = articleName
article.DatabaseName = publicationDbName
article.SourceObjectName = articleName
article.SourceObjectOwner = schemaOwner
article.PublicationName = publicationName
article.Type = ArticleOptions.LogBased
article.FilterClause = "DiscontinuedDate IS NULL"
' Ensure that we create the schema owner at the Subscriber.
article.SchemaOption = article.SchemaOption Or _
CreationScriptOptions.Schema
If Not article.IsExistingObject Then
' Create the article.
article.Create()
Else
Throw New ApplicationException(String.Format( _
"The article {0} already exists in publication {1}.", _
articleName, publicationName))
End If
' Create an array of column names to remove from the article.
Dim columns() As String = New String(0) {}
columns(0) = "DaysToManufacture"
' Remove the column from the article.
article.RemoveReplicatedColumns(columns)
Catch ex As Exception
' Implement appropriate error handling here.
Throw New ApplicationException("The article could not be created.", ex)
Finally
conn.Disconnect()
End Try
Комментарии
Потокобезопасность
Все общедоступные статические члены (Shared в Microsoft Visual Basic) этого типа безопасны для многопоточных операций. Потокобезопасная работа с членами экземпляров типа не гарантируется.
Конструкторы
| TransArticle() |
Создает новый экземпляр класса TransArticle. |
| TransArticle(String, String, String, ServerConnection) |
Создает новый экземпляр класса с необходимыми TransArticle свойствами и указанным подключением к экземпляру Microsoft SQL Server. |
Свойства
| ArticleId |
Возвращает значение идентификатора статьи. (Унаследовано от Article) |
| ArticleLogTablespace |
Возвращает или задает имя табличного пространства Oracle, используемого для сохранения информации журнала репликации. |
| CachePropertyChanges |
Возвращает или задает значение, указывающее, следует ли кэшировать изменения, внесенные в свойства репликации, или применять их немедленно. (Унаследовано от ReplicationObject) |
| CommandFormat |
Возвращает или задает, как распространяются изменения к статье. |
| ConnectionContext |
Возвращает или задает подключение к экземпляру Microsoft SQL Server. (Унаследовано от ReplicationObject) |
| CreateArticleAsHeterogeneous |
Возвращает или задает значение, показывающее, создается ли статья как разнородная. (Унаследовано от Article) |
| CreationScript |
Возвращает или задает имя и полный путь к файлу скрипта Transact-SQL, который используется для создания целевого объекта на подписчике. (Унаследовано от Article) |
| DatabaseName |
Возвращает или задает имя базы данных, которая содержит данные и объекты, опубликованные в статье. (Унаследовано от Article) |
| DatatypeMappingOptions |
Возвращает значение, указывающее, используется ли предусмотренное по умолчанию сопоставление типа данных статьи для издателя, отличного от издателя SQL Server. |
| DeleteCommand |
Возвращает или задает команду, используемую для репликации удалений. |
| Description |
Возвращает или задает текстовое описание статьи. (Унаследовано от Article) |
| DestinationObjectName |
Возвращает или задает объект базы данных, являющийся объектом базы данных-источника для статьи в подписчике. (Унаследовано от Article) |
| DestinationObjectOwner |
Возвращает или задает владельца схемы объекта базы данных-источника для статьи в подписчике. (Унаследовано от Article) |
| FilterClause |
Возвращает или задает предложение WHERE , используемое для горизонтальной фильтрации статьи. |
| FilterProcName |
Возвращает или задает хранимую процедуру (созданную с параметром FOR REPLICATION), которая используется для фильтрации таблицы по горизонтали. |
| FilterProcOwner |
Возвращает или задает пользователя базы данных, который владеет хранимой процедурой, используемой для секционирования статьи по горизонтали на основе таблицы. |
| IdentityRangeManagementOption |
Возвращает или задает параметры управления диапазонами идентификаторов для статьи. (Унаследовано от Article) |
| IdentityRangeThreshold |
Возвращает или задает значение, в котором новый диапазон значений столбца идентификаторов назначается издателю или подписчику. (Унаследовано от Article) |
| InsertCommand |
Возвращает или задает команду, используемую для репликации вставок. |
| IsExistingObject |
Возвращает значение, указывающее, существует ли объект на сервере. (Унаследовано от ReplicationObject) |
| Name |
Возвращает или задает имя статьи. (Унаследовано от Article) |
| PreCreationMethod |
Возвращает или задает действие, выполняемое, если опубликованный объект уже существует в базе данных подписки. (Унаследовано от Article) |
| PublicationName |
Возвращает или задает имя публикации, в которую входит статья. (Унаследовано от Article) |
| PublisherIdentityRangeSize |
Возвращает или задает диапазон значений идентификаторов, назначенных столбцам таблицы на издателе. (Унаследовано от Article) |
| PublisherName |
Возвращает или задает имя издателя, отличного от издателя SQL Server, который публикует статью. |
| SchemaOption |
Возвращает или задает параметры создания схемы для статьи. (Унаследовано от Article) |
| SnapshotObjectName |
Возвращает или задает объект базы данных, который предоставляет начальный моментальный снимок данных для статьи. |
| SnapshotObjectOwner |
Возвращает или задает владельца объекта базы данных, который предоставляет начальный моментальный снимок данных для статьи. |
| SourceObjectName |
Возвращает или задает имя объекта публикуемой базы данных. (Унаследовано от Article) |
| SourceObjectOwner |
Возвращает или задает владельца объекта публикуемой базы данных. (Унаследовано от Article) |
| SqlServerName |
Возвращает имя экземпляра microsoft SQL Server, к которому подключен этот объект. (Унаследовано от ReplicationObject) |
| SubscriberIdentityRangeSize |
Возвращает или задает максимальное количество новых строк, которые могут быть вставлены в столбец идентификаторов таблицы в подписчике, прежде чем появится необходимость выделить еще один диапазон идентификаторов. (Унаследовано от Article) |
| Type |
Возвращает или задает тип статьи. (Унаследовано от Article) |
| UpdateCommand |
Возвращает или задает команду, используемую для репликации обновлений. |
| UserData |
Возвращает или задает свойство объекта, которое позволяет пользователям прикреплять свои собственные данные к объекту. (Унаследовано от ReplicationObject) |
| VerticalPartition |
Возвращает значение, показывающее, публикуются ли все столбцы в статье таблицы. (Унаследовано от Article) |
Методы
| AddReplicatedColumns(Array) |
Включает столбцы в статью таблицы, секционированную по вертикали. |
| CheckValidCreation() |
Проверяет создание допустимой статьи. (Унаследовано от Article) |
| CheckValidDefinition(Boolean) |
Определяет, является ли определение допустимым. (Унаследовано от Article) |
| CommitPropertyChanges() |
Отправляет все кэшированные инструкции изменения свойств экземпляру Microsoft SQL Server. (Унаследовано от ReplicationObject) |
| Create() |
Создает новую статью для подключенного экземпляра SQL Server на основе текущих TransArticle свойств объекта или MergeArticle объекта . (Унаследовано от Article) |
| Decouple() |
Отделяет связанный объект репликации от сервера. (Унаследовано от ReplicationObject) |
| EnumHeterogeneousColumns() |
Возвращает информацию о столбцах для статьи таблицы, опубликованной издателем, отличным от издателя SQL Server. |
| GetChangeCommand(StringBuilder, String, String) |
Возвращает команду на изменение из репликации. (Унаследовано от ReplicationObject) |
| GetCreateCommand(StringBuilder, Boolean, ScriptOptions) |
Возвращает команду на создание из репликации. (Унаследовано от ReplicationObject) |
| GetDropCommand(StringBuilder, Boolean) |
Возвращает команду на удаление из репликации. (Унаследовано от ReplicationObject) |
| InternalRefresh(Boolean) |
Инициирует внутреннее обновление из репликации. (Унаследовано от ReplicationObject) |
| ListReplicatedColumns() |
Возвращает опубликованные столбцы в статье таблицы. |
| Load() |
Загружает свойства существующего объекта с сервера. (Унаследовано от ReplicationObject) |
| LoadProperties() |
Загружает свойства существующего объекта с сервера. (Унаследовано от ReplicationObject) |
| Refresh() |
Повторно загружает свойства объекта. (Унаследовано от ReplicationObject) |
| Remove() |
Удаляет существующую статью о подключенном экземпляре SQL Server на основе текущих TransArticle свойств объекта или MergeArticle объекта . (Унаследовано от Article) |
| RemoveReplicatedColumns(Array) |
Исключает столбцы из вертикально секционированной статьи таблицы. |
| Script(ScriptOptions) |
Создает скрипт Transact-SQL, который можно выполнить для создания или удаления TransArticle объекта или MergeArticle объекта на сервере. (Унаследовано от Article) |
| ScriptChangeColumnDestinationDataType(String, String, Int64, Int32, Int64, ScriptOptions) |
Возвращает скрипт Transact-SQL, используемый для изменения сопоставления типов данных столбца для издателя, не SQL Server. |
| SetColumnDestinationDataType(String, String, Int64, Int32, Int64) |
Задает сопоставление типа данных столбца для издателя, отличного от издателя SQL Server. |