TransArticle Classe

Referência

Definição

Namespace:: Microsoft.SqlServer.Replication

Assembly:: Microsoft.SqlServer.Rmo.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Representa um artigo em uma publicação transacional.

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

Herança: Object

ReplicationObject

Article
TransArticle

Exemplos

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

Comentários

Acesso thread-safe

Todos os membros estáticos públicos (Shared no Microsoft Visual Basic) desse tipo são seguros para operações multithread. Não há garantia de que qualquer membro de instância seja seguro para threads.

Construtores

TransArticle()	Cria uma nova instância da classe TransArticle.
TransArticle(String, String, String, ServerConnection)	Cria uma nova instância da TransArticle classe , com as propriedades necessárias e com a conexão especificada com a instância do Microsoft SQL Server.

Propriedades

ArticleId	Obtém o valor de ID do artigo. (Herdado de Article)
ArticleLogTablespace	Obtém ou define o nome do tablespace Oracle usado para armazenar informações de log de replicação.
CachePropertyChanges	Obtém ou define se as alterações feitas às propriedades de replicação devem ser armazenadas em cache ou aplicadas imediatamente. (Herdado de ReplicationObject)
CommandFormat	Obtém ou define como as alterações são propagadas para o artigo.
ConnectionContext	Obtém ou define a conexão com uma instância do Microsoft SQL Server. (Herdado de ReplicationObject)
CreateArticleAsHeterogeneous	Obtém ou define um valor que indica se é preciso criar um artigo como heterogêneo. (Herdado de Article)
CreationScript	Obtém ou define o nome e o caminho completo do arquivo de script Transact-SQL usado para criar o objeto de destino no Assinante. (Herdado de Article)
DatabaseName	Obtém ou define o nome do banco de dados que contém os dados e os objetos publicados no artigo. (Herdado de Article)
DatatypeMappingOptions	Retorna se o mapeamento de tipo de dados de artigo padrão é usado para um Publicador não SQL Server.
DeleteCommand	Obtém ou define o comando usado para replicar exclusões.
Description	Obtém ou define uma descrição textual do artigo. (Herdado de Article)
DestinationObjectName	Obtém ou define o objeto de banco de dados que é a origem do artigo no Assinante. (Herdado de Article)
DestinationObjectOwner	Obtém ou define o proprietário do esquema de banco de dados de origem do artigo no Assinante. (Herdado de Article)
FilterClause	Obtém ou define a cláusula WHERE usada para filtrar o artigo horizontalmente.
FilterProcName	Obtém ou define o procedimento armazenado (criado com FOR REPLICATION) usado para filtrar a tabela horizontalmente.
FilterProcOwner	Obtém ou define o usuário do banco de dados que possui o procedimento armazenado que é usado para particionar horizontalmente um artigo baseado em tabela.
IdentityRangeManagementOption	Obtém ou define as opções de gerenciamento de intervalo de identidade para o artigo. (Herdado de Article)
IdentityRangeThreshold	Obtém ou define o valor ao qual um novo intervalo de valores de coluna de identidade é atribuído para um Publicador ou Assinante. (Herdado de Article)
InsertCommand	Obtém ou define o comando usado para replicar inserções.
IsExistingObject	Especifica se o objeto existe no servidor ou não. (Herdado de ReplicationObject)
Name	Obtém ou define o nome do artigo. (Herdado de Article)
PreCreationMethod	Obtém ou define a ação a ser executada quando o objeto publicado já existe no banco de dados de assinatura. (Herdado de Article)
PublicationName	Obtém ou define o nome da publicação à qual o artigo pertence. (Herdado de Article)
PublisherIdentityRangeSize	Obtém ou define o intervalo de valores de identidade atribuídos às colunas da tabela no Publicador. (Herdado de Article)
PublisherName	Obtém ou define o nome do Publicador não SQL Server que publica o artigo.
SchemaOption	Obtém ou define as opções de criação de esquema para um artigo. (Herdado de Article)
SnapshotObjectName	Obtém ou define o objeto de banco de dados que fornece o instantâneo de dados inicial para o artigo.
SnapshotObjectOwner	Obtém ou define o proprietário do objeto de banco de dados que fornece o instantâneo de dados inicial para o artigo.
SourceObjectName	Obtém ou define o nome do objeto de banco de dados que está sendo publicado. (Herdado de Article)
SourceObjectOwner	Obtém ou define o proprietário do objeto de banco de dados que está sendo publicado. (Herdado de Article)
SqlServerName	Obtém o nome da instância do Microsoft SQL Server à qual esse objeto está conectado. (Herdado de ReplicationObject)
SubscriberIdentityRangeSize	Obtém ou define o número máximo de novas linhas que podem ser inseridas em uma coluna de identidade em uma tabela em um Assinante, antes de outro intervalo de identidade ser alocado. (Herdado de Article)
Type	Obtém ou define o tipo de artigo. (Herdado de Article)
UpdateCommand	Obtém ou define o comando usado para replicar atualizações.
UserData	Obtém ou define uma propriedade de objeto que permite que os usuários anexem seus próprios dados ao objeto. (Herdado de ReplicationObject)
VerticalPartition	Obtém um valor que indica se todas as colunas são publicadas em um artigo de tabela. (Herdado de Article)

Métodos

AddReplicatedColumns(Array)	Inclui colunas em um artigo de tabela particionado verticalmente.
CheckValidCreation()	Verifica a criação do artigo válido. (Herdado de Article)
CheckValidDefinition(Boolean)	Indica se a definição é válida. (Herdado de Article)
CommitPropertyChanges()	Envia todas as instruções de alteração de propriedade armazenadas em cache para a instância do Microsoft SQL Server. (Herdado de ReplicationObject)
Create()	Cria um novo artigo sobre a instância atualmente conectada do SQL Server com base nas propriedades atuais do TransArticle objeto ou do MergeArticle objeto . (Herdado de Article)
Decouple()	Desacopla o objeto de replicação referenciado do servidor. (Herdado de ReplicationObject)
EnumHeterogeneousColumns()	Retorna informações de coluna para um artigo de tabela publicado por um Publicador não SQL Server.
GetChangeCommand(StringBuilder, String, String)	Retorna o comando change da replicação. (Herdado de ReplicationObject)
GetCreateCommand(StringBuilder, Boolean, ScriptOptions)	Retorna o comando create da replicação. (Herdado de ReplicationObject)
GetDropCommand(StringBuilder, Boolean)	Retorna o comando drop da replicação. (Herdado de ReplicationObject)
InternalRefresh(Boolean)	Inicia uma atualização interna da replicação. (Herdado de ReplicationObject)
ListReplicatedColumns()	Retorna as colunas publicadas em um artigo de tabela.
Load()	Carrega as propriedades de um objeto existente do servidor. (Herdado de ReplicationObject)
LoadProperties()	Carrega as propriedades de um objeto existente do servidor. (Herdado de ReplicationObject)
Refresh()	Recarrega as propriedades do objeto. (Herdado de ReplicationObject)
Remove()	Remove um artigo existente sobre a instância atualmente conectada do SQL Server com base nas propriedades atuais do TransArticle objeto ou do MergeArticle objeto . (Herdado de Article)
RemoveReplicatedColumns(Array)	Exclui colunas de um artigo de tabela particionado verticalmente.
Script(ScriptOptions)	Gera um script Transact-SQL que pode ser executado para criar ou excluir o TransArticle objeto ou o MergeArticle objeto no servidor. (Herdado de Article)
ScriptChangeColumnDestinationDataType(String, String, Int64, Int32, Int64, ScriptOptions)	Retorna um script Transact-SQL usado para alterar o mapeamento de tipo de dados de coluna para um Publicador não SQL Server.
SetColumnDestinationDataType(String, String, Int64, Int32, Int64)	Define o mapeamento de tipo de dados de coluna para um Publicador não SQL Server.

Aplica-se a

Confira também

Mapeamento de tipo de dados para Editores Oracle)

Compartilhar via