Поделиться через


TransArticle Класс

Определение

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

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
Наследование

Примеры

// 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.

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

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