PublisherMonitor.EnumMergeAgentSessions2(String, Int32, Boolean) Método

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.

Retorna informações adicionais sobre sessões do Merge Agent.

public:
 System::Data::DataSet ^ EnumMergeAgentSessions2(System::String ^ agentName, int sessionDuration, bool returnOnlyErrorSessions);

public System.Data.DataSet EnumMergeAgentSessions2 (string agentName, int sessionDuration, bool returnOnlyErrorSessions);

member this.EnumMergeAgentSessions2 : string * int * bool -> System.Data.DataSet

Public Function EnumMergeAgentSessions2 (agentName As String, sessionDuration As Integer, returnOnlyErrorSessions As Boolean) As DataSet

Parâmetros

agentName: String

Um valor String que especifica o nome do trabalho do Merge Agent. Você pode usar a propriedade SynchronizationAgentName do objeto MergeSubscription para obter esse valor.

sessionDuration: Int32

Um valor Int32 que especifica o número de horas antes da hora atual à quais limitar os resultados. Por exemplo, um valor igual a 24 retornará informações sobre sessões de agente durante as últimas 24 horas. Um valor igual a -1 retornará informações das últimas 100 sessões. Um valor igual a 0 retornará informações sobre todas as sessões.

returnOnlyErrorSessions: Boolean

Um Boolean valor que especifica se deve retornar informações somente em sessões que resultaram em um erro ou em todas as sessões. Se o valor for true, apenas sessões com erro serão retornadas. Se o valor for false, todas as sessões serão retornadas.

Retornos

DataSet

Um objeto DataSet que contém as colunas a seguir.

Coluna	Tipo de dados	Descrição
Session_id	Int32	ID da sessão de trabalho do agente.
Status	Int32	Status de execução do agente: 1 = Iniciar 2 = Êxito 3 = Em andamento 4 = Ocioso 5 = Tentar novamente 6 = Falha
StartTime	DateTime	Hora em que a sessão de trabalho do agente começou.
EndTime	DateTime	Hora em que a sessão de trabalho do agente foi concluída.
Duration	Int32	Duração acumulada, em segundos, da sessão de trabalho do agente.
UploadedCommands	Int32	Número de comandos carregados durante a sessão de trabalho do agente.
DownloadedCommands	Int32	Número de comandos baixados durante a sessão de trabalho do agente.
ErrorMessages	Int32	Número de mensagens de erro geradas durante a sessão de trabalho do agente.
ErrorID	Int32	ID do erro ocorrido.
PercentageDone	Decimal	Percentual estimado do total de alterações que já foram entregues em uma sessão ativa.
TimeRemaining	Int32	Número estimado de segundos restantes em uma sessão ativa.
CurrentPhase	Int32	É a fase atual de uma sessão ativa, que pode ser uma das seguintes: 1 = Carregar 2 = Baixar
LastMessage	String	É a última mensagem registrada pelo Merge Agent durante a sessão.

Comentários

Você deve confirmar as alterações de propriedade no PublisherMonitor objeto antes de chamar esse método porque as propriedades desse objeto talvez precisem ser carregadas se ainda não tiverem sido carregadas.

O EnumMergeAgentSessions2 método só pode ser chamado por membros das db_owner funções de banco de dados fixas ou replmonitor no banco de dados de distribuição.

Chamar EnumMergeAgentSessions2 é equivalente à execução de sp_replmonitorhelpmergesession (Transact-SQL).

Aplica-se a

Partilhar via