sys.server_event_sessions (Transact-SQL)

Aplica-se a: SQL Server Instância Gerenciada de SQL do Azure

Lista todas as definições de sessão de evento no escopo do servidor que existem no SQL Server ou na Instância Gerenciada de SQL do Azure.

Observação

O Banco de Dados SQL do Azure dá suporte apenas a sessões de eventos com escopo de banco de dados. Veja a visualização relacionada, sys.database_event_sessions.

Nome da coluna Tipo de dados Descrição
event_session_id int A ID exclusiva da sessão de evento. Não permite valor nulo.
name sysname O nome definido pelo usuário para identificar a sessão de evento. nome é único. Não permite valor nulo.
event_retention_mode nchar(1) Determina como a perda de evento é tratada. O padrão é S. Não permite valor nulo. Pode ser um dos seguintes valores:

S. Mapeia para event_retention_mode_desc = ALLOW_SINGLE_EVENT_LOSS

M. Mapeia para event_retention_mode_desc = ALLOW_MULTIPLE_EVENT_LOSS

N. Mapeia para event_retention_mode_desc = NO_EVENT_LOSS
event_retention_mode_desc sysname Descreve como a perda de evento é tratada. O padrão é ALLOW_SINGLE_EVENT_LOSS. Não permite valor nulo. Pode ser um dos seguintes valores:

ALLOW_SINGLE_EVENT_LOSS. Os eventos podem ser perdidos da sessão. Eventos únicos serão descartados somente quando todos os buffers de evento estiverem cheios. A perda de eventos únicos quando os buffers estão cheios permite características de desempenho aceitáveis do SQL Server, minimizando a perda no fluxo de eventos processado.

ALLOW_MULTIPLE_EVENT_LOSS. Os buffers de evento cheios podem ser perdidos da sessão. O número de eventos depende do tamanho de memória alocado à sessão, do particionamento da memória e do tamanho dos eventos no buffer. Essa opção minimiza o impacto no desempenho do servidor quando os buffers de eventos são preenchidos rapidamente. No entanto, números elevados de eventos podem ser perdidos da sessão.

NO_EVENT_LOSS. Nenhuma perda de evento é permitida. Essa opção assegura que todos os eventos gerados serão retidos. O uso dessa opção força todas as tarefas que disparam eventos a aguardar até que haja espaço disponível em um buffer de eventos. Isso pode levar a uma degradação de desempenho detectável enquanto a sessão de eventos está ativa.
max_dispatch_latency int A quantidade de tempo, em milissegundos, que os eventos são armazenados em buffer na memória antes de serem servidos aos destinos da sessão. Os valores válidos são de 0 a 2.147.483.648 e 0. Um valor de indica que a latência de 0 expedição é infinita. Anulável.
max_memory int A quantidade de memória alocada à sessão para buffer de evento. O valor padrão é de 4 MB. Anulável.
max_event_size int A quantidade de memória reservada para eventos que não se encaixam em buffers de sessão de evento. Se max_event_size exceder o tamanho do buffer calculado, dois buffers adicionais de serão alocados para a sessão de max_event_size evento. Anulável.
memory_partition_mode nchar(1) O local na memória no qual são criados buffers de evento. O modo de partição padrão é G. Não permite valor nulo. memory_partition_mode pode ser:

G - NONE
C - PER_CPU
N - PER_NODE
memory_partition_mode_desc sysname O padrão é NONE. Não permite valor nulo. Pode ser um dos seguintes valores:

NONE. Um único conjunto de buffers é criado na instância do SQL Server.

PER_CPU. Um conjunto de buffers é criado para cada CPU.

PER_NODE. Um conjunto de buffers é criado para nó NUMA (acesso de memória não uniforme).
track_causality bit Habilita ou desabilita o rastreamento de causalidade. Se definido como 1 (ON), o rastreamento será ativado e os eventos relacionados em diferentes conexões de servidor poderão ser correlacionados. A configuração padrão é 0 (OFF). Não permite valor nulo.
startup_state bit O valor determina se a sessão é ou não iniciada automaticamente quando o servidor for iniciado. O padrão é 0. Não permite valor nulo. Pode ser uma das ações a seguir:

0 (OFF). A sessão não é iniciada quando o servidor é iniciado.

1 (ON). A sessão de evento inicia quando o servidor iniciar.

Permissões

O SQL Server 2019 (15.x) e versões anteriores exigem VIEW SERVER STATE permissão no servidor.

O SQL Server 2022 (16.x) e versões posteriores exigem VIEW SERVER PERFORMANCE STATE permissão no servidor.