TransSynchronizationAgent Classe

Definição

Namespace:: Microsoft.SqlServer.Replication

Assembly:: Microsoft.SqlServer.Replication.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.

Fornece a funcionalidade do Replication Agente de Distribuição.

public ref class TransSynchronizationAgent : MarshalByRefObject, IDisposable, Microsoft::SqlServer::Replication::ITransSynchronizationAgent

[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)]
[System.Runtime.InteropServices.ComSourceInterfaces(typeof(Microsoft.SqlServer.Replication.IComStatusEvent))]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Runtime.InteropServices.Guid("adeda98a-bdfc-4029-b6fb-991d6b468395")]
public class TransSynchronizationAgent : MarshalByRefObject, IDisposable, Microsoft.SqlServer.Replication.ITransSynchronizationAgent

[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)>]
[<System.Runtime.InteropServices.ComSourceInterfaces(typeof(Microsoft.SqlServer.Replication.IComStatusEvent))>]
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Runtime.InteropServices.Guid("adeda98a-bdfc-4029-b6fb-991d6b468395")>]
type TransSynchronizationAgent = class
    inherit MarshalByRefObject
    interface IDisposable
    interface ITransSynchronizationAgent

Public Class TransSynchronizationAgent
Inherits MarshalByRefObject
Implements IDisposable, ITransSynchronizationAgent

Herança: MarshalByRefObject
TransSynchronizationAgent

Atributos: ClassInterfaceAttribute ComSourceInterfacesAttribute ComVisibleAttribute GuidAttribute

Implementações: ITransSynchronizationAgent IDisposable

Exemplos

No exemplo a seguir, o Synchronize método é chamado na instância da TransSynchronizationAgent classe que é acessada a partir da SynchronizationAgent propriedade para sincronizar a assinatura push.

// Define the server, publication, and database names.
string subscriberName = subscriberInstance;
string publisherName = publisherInstance;
string publicationName = "AdvWorksProductTran";
string subscriptionDbName = "AdventureWorks2012Replica";
string publicationDbName = "AdventureWorks2012";

// Create a connection to the Publisher.
ServerConnection conn = new ServerConnection(publisherName);

TransSubscription subscription;

try
{
    // Connect to the Publisher.
    conn.Connect();

    // Define the push subscription.
    subscription = new TransSubscription();
    subscription.ConnectionContext = conn;
    subscription.DatabaseName = publicationDbName;
    subscription.PublicationName = publicationName;
    subscription.SubscriptionDBName = subscriptionDbName;
    subscription.SubscriberName = subscriberName;

    // If the push subscription exists, start the synchronization.
    if (subscription.LoadProperties())
    {
        // Check that we have enough metadata to start the agent.
        if (subscription.SubscriberSecurity != null)
        {
            // Synchronously start the Distribution Agent for the subscription.
            subscription.SynchronizationAgent.Synchronize();
        }
        else
        {
            throw new ApplicationException("There is insufficent metadata to " +
                "synchronize the subscription. Recreate the subscription with " +
                "the agent job or supply the required agent properties at run time.");
        }
    }
    else
    {
        // Do something here if the push subscription does not exist.
        throw new ApplicationException(String.Format(
            "The subscription to '{0}' does not exist on {1}",
            publicationName, subscriberName));
    }
}
catch (Exception ex)
{
    // Implement appropriate error handling here.
    throw new ApplicationException("The subscription could not be synchronized.", ex);
}
finally
{
    conn.Disconnect();
}

' Define the server, publication, and database names.
Dim subscriberName As String = subscriberInstance
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksProductTran"
Dim subscriptionDbName As String = "AdventureWorks2012Replica"
Dim publicationDbName As String = "AdventureWorks2012"

' Create a connection to the Publisher.
Dim conn As ServerConnection = New ServerConnection(publisherName)

Dim subscription As TransSubscription

Try
    ' Connect to the Publisher.
    conn.Connect()

    ' Define the push subscription.
    subscription = New TransSubscription()
    subscription.ConnectionContext = conn
    subscription.DatabaseName = publicationDbName
    subscription.PublicationName = publicationName
    subscription.SubscriptionDBName = subscriptionDbName
    subscription.SubscriberName = subscriberName

    ' If the push subscription exists, start the synchronization.
    If subscription.LoadProperties() Then
        ' Check that we have enough metadata to start the agent.
        If Not subscription.SubscriberSecurity Is Nothing Then

            ' Synchronously start the Distribution Agent for the subscription.
            subscription.SynchronizationAgent.Synchronize()
        Else
            Throw New ApplicationException("There is insufficent metadata to " + _
             "synchronize the subscription. Recreate the subscription with " + _
             "the agent job or supply the required agent properties at run time.")
        End If
    Else
        ' Do something here if the push subscription does not exist.
        Throw New ApplicationException(String.Format( _
         "The subscription to '{0}' does not exist on {1}", _
         publicationName, subscriberName))
    End If
Catch ex As Exception
    ' Implement appropriate error handling here.
    Throw New ApplicationException("The subscription could not be synchronized.", ex)
Finally
    conn.Disconnect()
End Try

Comentários

A TransSynchronizationAgent classe suporta a capacidade de sincronizar programaticamente assinaturas com publicações transacionais ou snapshot.

Construtores

Nome	Description
TransSynchronizationAgent()	Cria uma instância de TransSynchronizationAgent classe.

Propriedades

Nome	Description
AltSnapshotFolder	Obtém ou configura a pasta de snapshots alternativos para a assinatura.
ComErrorCollection	Obtém uma coleção de erros gerados pelo agente de replicação.
Distributor	Recebe ou define o nome da instância do Microsoft SQL Server que atua como distribuidora da assinatura.
DistributorAddress	Obtém ou define o endereço de rede que é usado para se conectar ao distribuidor quando a DistributorNetwork propriedade é especificada.
DistributorEncryptedPassword	Obtém ou define a senha criptografada usada ao se conectar ao distribuidor usando a Autenticação do SQL Server.
DistributorLogin	Obtém ou define o nome de login usado ao se conectar ao distribuidor usando a Autenticação do SQL Server.
DistributorNetwork	Recebe ou define o Net-Library cliente que é usado ao conectar ao distribuidor.
DistributorPassword	Obtém ou define a senha usada ao se conectar ao Distribuidor usando a Autenticação do SQL Server.
DistributorSecurityMode	Recebe ou configura o modo de segurança usado ao se conectar ao distribuidor.
DtsPackageFileName	Recebe ou define o nome e o caminho de um pacote Microsoft SQL Server 2000 Data Transformation Services (DTS) que é usado para transformar conjuntos de linhas de comandos antes que sejam aplicados a um assinante.
DtsPackagePassword	Obtém ou define a senha do proprietário que costumava acessar o pacote Microsoft SQL Server 2000 Data Transformation Services (DTS) especificado pela DtsPackageFileName propriedade.
FileTransferType	Obtém ou define como os arquivos snapshot iniciais são transferidos para o Assinante.
HostName	Obtém ou define o nome do host usado.
LastUpdatedTime	Recebe o carimbo de data da última vez que o agente de replicação sincronizou a assinatura.
LoginTimeout	Obtém ou define o número máximo de segundos para esperar que as conexões sejam estabelecidas.
MaxDeliveredTransactions	Recebe ou define o número máximo de transações aplicadas ao Assinante durante uma execução de um único agente.
Output	Obtém ou define o nome do arquivo e o caminho do arquivo de saída do agente.
OutputVerboseLevel	Obtém ou define a quantidade de informação registrada pelo Agente de Distribuição no arquivo de saída do agente.
ProfileName	Obtém ou define o nome do perfil que é usado pelo agente.
Publication	Recebe ou define o nome da publicação.
Publisher	Recebe ou define o nome da instância do Microsoft SQL Server que é o Publisher da assinatura.
PublisherDatabase	Obtém ou define o nome do banco de dados da publicação.
QueryTimeout	Obtém ou define o número de segundos permitidos para que as consultas internas sejam concluídas.
SecureDistributorEncryptedPassword	Obtém ou define a senha criptografada e segura do distribuidor.
SecureSubscriberEncryptedPassword	Obtém ou define a senha criptografada e segura para o assinante.
SkipErrors	Obtém ou define uma lista separada por dois pontos dos números de erro que devem ser pulados por esse agente.
Subscriber	Recebe ou define o nome da instância do Microsoft SQL Server que é assinante.
SubscriberDatabase	Obtém ou define o nome do banco de dados de assinaturas.
SubscriberDatabasePath	Obtenha ou defina o caminho do banco de dados para o assinante.
SubscriberDataSourceType	Obtém ou define o tipo de fonte de dados que é usada como assinante.
SubscriberEncryptedPassword	Obtém ou define a senha criptografada do assinante.
SubscriberLogin	Obtém ou define o nome de login usado ao se conectar ao assinante usando a Autenticação do SQL Server.
SubscriberPassword	Obtém ou define a senha usada ao se conectar ao assinante usando a Autenticação do SQL Server.
SubscriberSecurityMode	Obtém ou configura o modo de segurança usado ao se conectar com a editora.
SubscriptionType	Obtém ou define se a assinatura é push ou pull.
UndeliveredCommands	Recebe o número de comandos não entregues.
UndeliveredTransactions	Obtém o número de transações não entregues.
UseInProcLoader	Recebe ou define um valor que indica se deve usar o comando BULK INSERT ao aplicar arquivos snapshot no assinante.
WorkingDirectory	Obtém ou define o diretório funcional a partir do qual os arquivos snapshot são acessados quando o File Transfer Protocol (FTP) é utilizado.

Métodos

Nome	Description
Abort()	Aborta a TransSynchronizationAgent operação.
Dispose()	Libera todos os recursos usados pela instância atual da TransSynchronizationAgent classe.
Dispose(Boolean)	Libera todos os recursos usados pela TransSynchronizationAgent classe.
Finalize()	Finaliza o TransSynchronizationAgent.
IsSnapshotRequired()	Conecta-se ao Distribuidor e ao Assinante para determinar se um novo snapshot será aplicado durante a próxima sincronização do agente.
Synchronize()	Inicia o Agente de Distribuição para sincronizar a assinatura.

Eventos

Nome	Description
ComStatus	Ocorre quando o Agente de Distribuição retorna informações de status do Com de sincronização.
Status	Ocorre quando o Agente de Distribuição retorna informações de status de sincronização.

Aplica-se a

Acesso thread-safe

A TransSynchronizationAgent classe não suporta apartamentos multithread. Você pode especificar um apartamento single-threaded declarando o [STAThread] atributo no método que é o ponto principal de entrada da aplicação. Esse é o padrão para aplicações baseadas em Microsoft Windows criadas usando Microsoft Visual Studio.