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 = com sucesso 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 para o PublisherMonitor objeto antes de chamar esse método, pois 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 replmonitor banco de dados ou fixas no banco de dados de distribuição.