TransArticle Класс

Определение

Пространство имен:: Microsoft.SqlServer.Replication

Сборка:: Microsoft.SqlServer.Rmo.dll

Важно!

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

Представляет статью в транзакционной публикации.

public ref class TransArticle sealed : Microsoft::SqlServer::Replication::Article

public sealed class TransArticle : Microsoft.SqlServer.Replication.Article

type TransArticle = class
    inherit Article

Public NotInheritable Class TransArticle
Inherits Article

Наследование: Object

ReplicationObject

Article
TransArticle

Примеры

// 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	Получает значение ID статьи. (Унаследовано от Article)
ArticleLogTablespace	Получает или устанавливает имя пространства таблиц Oracle, используемого для хранения информации журнала репликации.
CachePropertyChanges	Получает или задаёт, кэшировать ли изменения, внесённые в свойства репликации, или применять их сразу. (Унаследовано от ReplicationObject)
CommandFormat	Получает или задаёт, как распространяются изменения в статье.
ConnectionContext	Получает или устанавливает соединение с экземпляром Microsoft SQL Server. (Унаследовано от ReplicationObject)
CreateArticleAsHeterogeneous	Получает или устанавливает значение, указывающее, нужно ли создавать статью как неоднородную. (Унаследовано от Article)
CreationScript	Получает или задаёт имя и полный путь Transact-SQL скрипт-файла, который используется для создания объекта назначения у Подписчика. (Унаследовано от Article)
DatabaseName	Получает или устанавливает имя базы данных, содержащей данные и объекты, опубликованные в статье. (Унаследовано от Article)
DatatypeMappingOptions	Возвращает, используется ли стандартное отображение типов данных статей для не-SQL Server Publisher.
DeleteCommand	Получает или устанавливает команду, используемую для репликации удаления.
Description	Получает или устанавливает текстовое описание статьи. (Унаследовано от Article)
DestinationObjectName	Получает или устанавливает объект базы данных, который является исходным объектом базы данных для статьи, в адрес Subscriber. (Унаследовано от Article)
DestinationObjectOwner	Получает или устанавливает владельца схемы исходного объекта базы данных для статьи в Subscriber. (Унаследовано от Article)
FilterClause	Получает или устанавливает клаузу WHERE , используемую для горизонтальной фильтрации статьи.
FilterProcName	Получает или устанавливает сохранённую процедуру (созданную с помощью ДЛЯ РЕПЛИКАЦИИ), используемую для горизонтальной фильтрации таблицы.
FilterProcOwner	Получает или устанавливает пользователя базы данных, которому принадлежит сохранённая процедура, используемая для горизонтального разделения таблицной статьи.
IdentityRangeManagementOption	Получает или устанавливает параметры управления диапазоном идентичности для статьи. (Унаследовано от Article)
IdentityRangeThreshold	Получает или устанавливает значение, при котором новый диапазон значений столбцов идентичности присваивается Publisher или Subscriber. (Унаследовано от Article)
InsertCommand	Получает или устанавливает команду, используемую для воспроизведения вставок.
IsExistingObject	Понимает, существует ли объект на сервере или нет. (Унаследовано от ReplicationObject)
Name	Получает или устанавливает название статьи. (Унаследовано от Article)
PreCreationMethod	Получает или устанавливает действие, которое должно предпринять, если опубликованный объект уже существует в базе данных подписки. (Унаследовано от Article)
PublicationName	Получает или устанавливает название издания, к которому относится статья. (Унаследовано от Article)
PublisherIdentityRangeSize	Получает или устанавливает диапазон значений идентичности, присваиваемых столбцам таблицы в Publisher. (Унаследовано от Article)
PublisherName	Получает или устанавливает имя не-SQL Server Publisher, публикующего статью.
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 Publisher.
GetChangeCommand(StringBuilder, String, String)	Возвращает команду изменения из репликации. (Унаследовано от ReplicationObject)
GetCreateCommand(StringBuilder, Boolean, ScriptOptions)	Возвращает команду create из репликации. (Унаследовано от ReplicationObject)
GetDropCommand(StringBuilder, Boolean)	Возвращает команду drop из репликации. (Унаследовано от 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 Publisher.
SetColumnDestinationDataType(String, String, Int64, Int32, Int64)	Задаёт отображение типа данных столбцов для не-SQL Server Publisher.

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

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

Отображение типов данных для издателей Oracle)