PublisherMonitor.EnumDistributionAgentSessions(String, Int32, Boolean) Método
Definição
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 sobre sessões do Agente de Distribuição.
public:
System::Data::DataSet ^ EnumDistributionAgentSessions(System::String ^ agentName, int sessionDuration, bool returnOnlyErrorSessions);public System.Data.DataSet EnumDistributionAgentSessions (string agentName, int sessionDuration, bool returnOnlyErrorSessions);member this.EnumDistributionAgentSessions : string * int * bool -> System.Data.DataSetPublic Function EnumDistributionAgentSessions (agentName As String, sessionDuration As Integer, returnOnlyErrorSessions As Boolean) As DataSetParâmetros
- agentName
- String
Um valor String que especifica o nome do trabalho do Agente de Distribuição. Você pode usar a propriedade SynchronizationAgentName do objeto TransSubscription 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 do Distribution Agent 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 valor Boolean que especifica se devem ser retornadas informações apenas sobre sessões que resultaram em um erro ou sobre 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
Um objeto DataSet que contém as colunas a seguir.
| Coluna | Tipo de dados | Descrição |
|---|---|---|
| runstatus | Int32 | O status da execução: 1 = Iniciar 2 = Êxito 3 = Em andamento 4 = Ocioso 5 = Tentar novamente 6 = Falha |
| start_time | String | Data e hora da última execução do agente. |
| time | String | Data e hora em que a sessão foi registrada em log. |
| comments | String | Texto da mensagem registrada em log pelo agente. |
| duration | Int32 | Tempo decorrido da sessão, em segundos. |
| delivery_rate | Single | Número médio de comandos entregues por segundo. |
| delivery_latency | Int32 | Latência, em milissegundos, entre a entrada da transação no banco de dados de distribuição e a aplicação no Assinante. |
| (Sem nome de coluna) | Não aplicável | Somente para uso interno. |
| delivered_transactions | Int32 | Número total de transações entregues na sessão. |
| delivered_commands | Int32 | Número total de comandos entregues na sessão. |
| average_commands | Int32 | Número médio de comandos por transação entregues na sessão. |
| action_count | Int32 | Número de mensagens de log de agente registrado pela sessão. |
| error_id | Int32 | A ID do erro na tabela do sistema [MSrepl_errors (Transact-SQL)](http://msdn.microsoft.com/library/c6e023c1-2c32-4269-8d76-e442ea309e4b) . Use o método EnumErrorRecords(Int32) para retornar informações detalhadas sobre um erro. |
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 EnumDistributionAgentSessions 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.