PublisherMonitor.EnumSnapshotAgentSessions(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 Snapshot Agent.
public:
System::Data::DataSet ^ EnumSnapshotAgentSessions(System::String ^ agentName, int sessionDuration, bool returnOnlyErrorSessions);public System.Data.DataSet EnumSnapshotAgentSessions (string agentName, int sessionDuration, bool returnOnlyErrorSessions);member this.EnumSnapshotAgentSessions : string * int * bool -> System.Data.DataSetPublic Function EnumSnapshotAgentSessions (agentName As String, sessionDuration As Integer, returnOnlyErrorSessions As Boolean) As DataSetParâmetros
- agentName
- String
Um valor String que especifica o nome do Log Reader Agent. Você pode obter esse valor da propriedade LogReaderAgentName do banco de dados publicado.
- 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 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. |
| delivered_commands | Int32 | Número total de comandos 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 no [MSrepl_errors (Transact-SQL)](http://msdn.microsoft.com/library/c6e023c1-2c32-4269-8d76-e442ea309e4b) tabela do sistema. Use o método EnumErrorRecords(Int32) para retornar informações detalhadas sobre um erro. |
Comentários
Você deve confirmar quaisquer alterações de propriedade no PublisherMonitor objeto antes de chamar esse método porque as propriedades desse objeto podem precisar ser carregadas se elas ainda não tiverem sido carregadas.
O EnumSnapshotAgentSessions método só pode ser chamado por membros das db_owner funções de banco de dados fixas ou no replmonitor banco de dados de distribuição.