Compartir a través de


TransArticle Clase

Definición

Representa un artículo en una publicación transaccional.

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
Herencia

Ejemplos

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

Comentarios

Seguridad para subprocesos

Todos los miembros estáticos públicos (Shared en Microsoft Visual Basic) de este tipo son seguros para las operaciones multiproceso. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Constructores

TransArticle()

Crea una nueva instancia de la clase TransArticle.

TransArticle(String, String, String, ServerConnection)

Crea una nueva instancia de la TransArticle clase , con las propiedades necesarias y con la conexión especificada a la instancia de Microsoft SQL Server.

Propiedades

ArticleId

Obtiene el valor de identificador del artículo.

(Heredado de Article)
ArticleLogTablespace

Obtiene o establece el nombre del espacio de tabla de Oracle utilizado para almacenar la información del registro de replicación.

CachePropertyChanges

Obtiene o establece si los cambios realizados en las propiedades de replicación se almacenan en memoria caché o se aplican inmediatamente.

(Heredado de ReplicationObject)
CommandFormat

Obtiene o establece cómo se propagan los cambios del artículo.

ConnectionContext

Obtiene o establece la conexión a una instancia de Microsoft SQL Server.

(Heredado de ReplicationObject)
CreateArticleAsHeterogeneous

Obtiene o establece un valor que indica si se ha de crear un artículo como heterogéneo.

(Heredado de Article)
CreationScript

Obtiene o establece el nombre y la ruta de acceso completa del archivo de script de Transact-SQL que se usa para crear el objeto de destino en el suscriptor.

(Heredado de Article)
DatabaseName

Obtiene o establece el nombre de la base de datos que contiene los datos y los objetos que se publican en el artículo.

(Heredado de Article)
DatatypeMappingOptions

Devuelve si la asignación predeterminadas de tipo de datos del artículo se utiliza para un publicador que no es de SQL Server.

DeleteCommand

Obtiene o establece el comando que se usa para replicar las eliminaciones.

Description

Obtiene o establece una descripción textual del artículo.

(Heredado de Article)
DestinationObjectName

Obtiene o establece el objeto de la base de datos que es el objeto de base de datos de origen del artículo en el suscriptor.

(Heredado de Article)
DestinationObjectOwner

Obtiene o establece el propietario del esquema que es el objeto de base de datos de origen del artículo en el suscriptor.

(Heredado de Article)
FilterClause

Obtiene o establece la cláusula WHERE utilizada para filtrar horizontalmente el artículo.

FilterProcName

Obtiene o establece el procedimiento almacenado (creado con FOR REPLICATION) que se usa para filtrar la tabla horizontalmente.

FilterProcOwner

Obtiene o establece el usuario de la base de datos propietario del procedimiento almacenado que se utiliza para crear particiones horizontalmente en un artículo basado en tabla.

IdentityRangeManagementOption

Obtiene o establece las opciones de administración de intervalos de identidad para el artículo.

(Heredado de Article)
IdentityRangeThreshold

Obtiene o establece el valor en el cual los valores de una nueva columna de intervalo de identidad se asignan a un publicador o a un suscriptor.

(Heredado de Article)
InsertCommand

Obtiene o establece el comando que se usa para replicar las inserciones.

IsExistingObject

Obtiene si el objeto existe en el servidor.

(Heredado de ReplicationObject)
Name

Obtiene o establece el nombre del artículo.

(Heredado de Article)
PreCreationMethod

Obtiene o establece la acción que se realiza cuando el objeto publicado ya existe en la base de datos de suscripciones.

(Heredado de Article)
PublicationName

Obtiene o establece el nombre de la publicación a la que pertenece el artículo.

(Heredado de Article)
PublisherIdentityRangeSize

Obtiene o establece el intervalo de valores de identidad asignados a columnas de tabla en el publicador.

(Heredado de Article)
PublisherName

Obtiene o establece el nombre del publicador que no es de SQL Server que publica el artículo.

SchemaOption

Obtiene o establece las opciones de creación de esquema para un artículo.

(Heredado de Article)
SnapshotObjectName

Obtiene o establece el objeto de la base de datos que proporciona la instantánea de datos inicial para el artículo.

SnapshotObjectOwner

Obtiene o establece el propietario del objeto de la base de datos que proporciona la instantánea de datos inicial para el artículo.

SourceObjectName

Obtiene o establece el nombre del objeto de la base de datos que se publicará.

(Heredado de Article)
SourceObjectOwner

Obtiene o establece el propietario del objeto de la base de datos que se publicará.

(Heredado de Article)
SqlServerName

Obtiene el nombre de la instancia de Microsoft SQL Server a la que está conectado este objeto.

(Heredado de ReplicationObject)
SubscriberIdentityRangeSize

Obtiene o establece el número máximo de filas nuevas que pueden insertarse en una columna de identidad en una tabla de un suscriptor antes de que sea necesario asignar otro intervalo de identidad.

(Heredado de Article)
Type

Obtiene o establece el tipo del artículo.

(Heredado de Article)
UpdateCommand

Obtiene o establece el comando que se usa para replicar las actualizaciones.

UserData

Obtiene o establece una propiedad de un objeto que permite a los usuarios adjuntar sus propios datos al objeto.

(Heredado de ReplicationObject)
VerticalPartition

Obtiene un valor que indica si todas las columnas están publicadas en un artículo de tabla.

(Heredado de Article)

Métodos

AddReplicatedColumns(Array)

Incluye las columnas de un artículo de la tabla con particiones verticales.

CheckValidCreation()

Comprueba la creación de artículo válida.

(Heredado de Article)
CheckValidDefinition(Boolean)

Indica si la definición es válida.

(Heredado de Article)
CommitPropertyChanges()

Envía todas las instrucciones de cambio de propiedad almacenadas en caché a la instancia de Microsoft SQL Server.

(Heredado de ReplicationObject)
Create()

Crea un nuevo artículo sobre la instancia conectada actualmente de SQL Server en función de las propiedades actuales del TransArticle objeto o del MergeArticle objeto .

(Heredado de Article)
Decouple()

Desacopla del servidor el objeto de replicación al que se hace referencia.

(Heredado de ReplicationObject)
EnumHeterogeneousColumns()

Devuelve la información de la columna para un artículo de la tabla publicado por un publicador que no es de SQL Server.

GetChangeCommand(StringBuilder, String, String)

Devuelve el comando de cambio de la replicación.

(Heredado de ReplicationObject)
GetCreateCommand(StringBuilder, Boolean, ScriptOptions)

Devuelve el comando de creación de la replicación.

(Heredado de ReplicationObject)
GetDropCommand(StringBuilder, Boolean)

Devuelve el comando drop de la replicación.

(Heredado de ReplicationObject)
InternalRefresh(Boolean)

Inicia una actualización interna de la replicación.

(Heredado de ReplicationObject)
ListReplicatedColumns()

Devuelve las columnas publicadas en un artículo de la tabla.

Load()

Carga las propiedades de un objeto existente desde el servidor.

(Heredado de ReplicationObject)
LoadProperties()

Carga las propiedades de un objeto existente desde el servidor.

(Heredado de ReplicationObject)
Refresh()

Vuelve a cargar las propiedades del objeto.

(Heredado de ReplicationObject)
Remove()

Quita un artículo existente en la instancia conectada actualmente de SQL Server en función de las propiedades actuales del TransArticle objeto o del MergeArticle objeto .

(Heredado de Article)
RemoveReplicatedColumns(Array)

Excluye las columnas de un artículo de la tabla con particiones verticales.

Script(ScriptOptions)

Genera un script de Transact-SQL que se puede ejecutar para crear o eliminar el TransArticle objeto o el MergeArticle objeto en el servidor.

(Heredado de Article)
ScriptChangeColumnDestinationDataType(String, String, Int64, Int32, Int64, ScriptOptions)

Devuelve un script de Transact-SQL que se usa para cambiar la asignación de tipos de datos de columna para un publicador que no es de SQL Server.

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

Establece la asignación del tipo de datos de columna para un publicador que no es de SQL Server.

Se aplica a

Consulte también