Partager via


TransArticle Classe

Définition

Représente un article dans une publication transactionnelle.

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
Héritage

Exemples

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

Remarques

Cohérence de thread

Tous les membres statiques publics (Shared dans Microsoft Visual Basic) de ce type sont sécurisés pour les opérations multithread. Tous les membres de l'instance ne sont pas garantis comme étant thread-safe.

Constructeurs

TransArticle()

Crée une instance de la classe TransArticle.

TransArticle(String, String, String, ServerConnection)

Crée une instance de la TransArticle classe, avec les propriétés requises et avec la connexion spécifiée à l’instance de Microsoft SQL Server.

Propriétés

ArticleId

Obtient la valeur d'ID de l'article.

(Hérité de Article)
ArticleLogTablespace

Obtient ou définit le nom de l'espace de table Oracle utilisé pour stocker les informations du journal de réplication.

CachePropertyChanges

Obtient ou définit s'il faut mettre en cache des modifications effectuées sur les propriétés de réplication ou les appliquer immédiatement.

(Hérité de ReplicationObject)
CommandFormat

Obtient ou définit la manière dont les modifications sont propagées pour l'article.

ConnectionContext

Obtient ou définit la connexion à une instance de Microsoft SQL Server.

(Hérité de ReplicationObject)
CreateArticleAsHeterogeneous

Obtient ou définit une valeur qui indique s'il faut créer un article hétérogène.

(Hérité de Article)
CreationScript

Obtient ou définit le nom et le chemin d’accès complet du fichier de script Transact-SQL utilisé pour créer l’objet de destination sur l’Abonné.

(Hérité de Article)
DatabaseName

Obtient ou définit le nom de la base de données qui contient les données et les objets publiés dans l'article.

(Hérité de Article)
DatatypeMappingOptions

Retourne une valeur indiquant si le mappage du type de données de l'article par défaut est utilisé pour un serveur de publication non-SQL Server.

DeleteCommand

Obtient ou définit la commande utilisée pour répliquer des suppressions.

Description

Obtient ou définit une description textuelle de l'article.

(Hérité de Article)
DestinationObjectName

Obtient ou définit l'objet de base de données qui est l'objet de base de données source pour l'article sur l'Abonné.

(Hérité de Article)
DestinationObjectOwner

Obtient ou définit le propriétaire du schéma de l'objet de base de données source pour l'article sur l'Abonné.

(Hérité de Article)
FilterClause

Obtient ou définit la clause WHERE utilisée pour filtrer horizontalement l’article.

FilterProcName

Obtient ou définit la procédure stockée (créée avec FOR REPLICATION) utilisée pour filtrer la table horizontalement.

FilterProcOwner

Obtient ou définit l'utilisateur de base de données propriétaire de la procédure stockée utilisée pour partitionner horizontalement un article basé sur une table.

IdentityRangeManagementOption

Obtient ou définit les options de gestion des plages d'identité pour l'article.

(Hérité de Article)
IdentityRangeThreshold

Obtient ou définit la valeur à laquelle une nouvelle plage de valeurs de colonne d'identité est affectée à un serveur de publication ou à un Abonné.

(Hérité de Article)
InsertCommand

Obtient ou définit la commande utilisée pour répliquer des insertions.

IsExistingObject

Détermine si l'objet existe ou non sur le serveur.

(Hérité de ReplicationObject)
Name

Obtient ou définit le nom de l'article.

(Hérité de Article)
PreCreationMethod

Obtient ou définit l'action à entreprendre lorsque l'objet publié existe déjà dans la base de données de l'abonnement.

(Hérité de Article)
PublicationName

Obtient ou définit le nom de la publication à laquelle l'article appartient.

(Hérité de Article)
PublisherIdentityRangeSize

Obtient ou définit la plage de valeurs d’identité affectées aux colonnes de table sur le serveur de publication.

(Hérité de Article)
PublisherName

Obtient ou définit le nom du serveur de publication non-SQL Server qui publie l'article.

SchemaOption

Obtient ou définit les options de création du schéma pour un article.

(Hérité de Article)
SnapshotObjectName

Obtient ou définit l'objet de base de données qui fournit l'instantané des données initial pour l'article.

SnapshotObjectOwner

Obtient ou définit le propriétaire de la base de données qui fournit l'instantané des données initial pour l'article.

SourceObjectName

Obtient ou définit le nom de l'objet de base de données publié.

(Hérité de Article)
SourceObjectOwner

Obtient ou définit le propriétaire de l'objet de base de données publié.

(Hérité de Article)
SqlServerName

Obtient le nom de l’instance Microsoft SQL Server à laquelle cet objet est connecté.

(Hérité de ReplicationObject)
SubscriberIdentityRangeSize

Obtient ou définit le nombre maximal de nouvelles lignes qui peuvent être insérées dans une colonne d'identité dans une table sur un Abonné avant qu'une autre plage d'identité ne doive être allouée.

(Hérité de Article)
Type

Obtient ou définit le type de l'article.

(Hérité de Article)
UpdateCommand

Obtient ou définit la commande utilisée pour répliquer des mises à jour.

UserData

Obtient ou définit une propriété d'objet qui permet aux utilisateurs d'attacher leurs propres données à l'objet.

(Hérité de ReplicationObject)
VerticalPartition

Obtient une valeur qui indique si toutes les colonnes sont publiées dans un article de table.

(Hérité de Article)

Méthodes

AddReplicatedColumns(Array)

Inclut des colonnes dans un article de table partitionnée verticalement.

CheckValidCreation()

Vérifie la création de l'article valide.

(Hérité de Article)
CheckValidDefinition(Boolean)

Indique si la définition est valide.

(Hérité de Article)
CommitPropertyChanges()

Envoie toutes les instructions de modification de propriété mises en cache à l’instance de Microsoft SQL Server.

(Hérité de ReplicationObject)
Create()

Crée un article sur l’instance actuellement connectée de SQL Server en fonction des propriétés actuelles de l’objet TransArticle ou de l’objet MergeArticle .

(Hérité de Article)
Decouple()

Dissocie l'objet de réplication référencé du serveur.

(Hérité de ReplicationObject)
EnumHeterogeneousColumns()

Retourne les informations de colonne pour un article de table publié par un serveur de publication non-SQL Server.

GetChangeCommand(StringBuilder, String, String)

Retourne la commande de modification de la réplication.

(Hérité de ReplicationObject)
GetCreateCommand(StringBuilder, Boolean, ScriptOptions)

Retourne la commande de création de la réplication.

(Hérité de ReplicationObject)
GetDropCommand(StringBuilder, Boolean)

Retourne la commande de suppression de la réplication.

(Hérité de ReplicationObject)
InternalRefresh(Boolean)

Initialise une actualisation interne de la réplication.

(Hérité de ReplicationObject)
ListReplicatedColumns()

Retourne les colonnes publiées dans un article de table.

Load()

Charge les propriétés d'un objet existant à partir du serveur.

(Hérité de ReplicationObject)
LoadProperties()

Charge les propriétés d'un objet existant à partir du serveur.

(Hérité de ReplicationObject)
Refresh()

Recharge les propriétés de l'objet.

(Hérité de ReplicationObject)
Remove()

Supprime un article existant sur l’instance actuellement connectée de SQL Server en fonction des propriétés actuelles de l’objet TransArticle ou de l’objet MergeArticle .

(Hérité de Article)
RemoveReplicatedColumns(Array)

Exclut des colonnes d'un article de table partitionnée verticalement.

Script(ScriptOptions)

Génère un script Transact-SQL qui peut être exécuté pour créer ou supprimer l’objet TransArticle ou l’objet MergeArticle sur le serveur.

(Hérité de Article)
ScriptChangeColumnDestinationDataType(String, String, Int64, Int32, Int64, ScriptOptions)

Retourne un script Transact-SQL utilisé pour modifier le mappage de type de données de colonne pour un serveur de publication non SQL Server.

SetColumnDestinationDataType(String, String, Int64, Int32, Int64)

Définit le mappage du type de données de colonne pour un serveur de publication non-SQL Server.

S’applique à

Voir aussi