sys.database_event_sessions (Banco de Dados SQL do Azure e Instância Gerenciada de SQL do Azure)

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

Lista todas as definições de sessão de evento no escopo do banco de dados que existem no banco de dados atual. Para obter informações sobre sessões de eventos ativas no escopo do banco de dados, consulte sys.dm_xe_database_sessions.

O Banco de Dados SQL do Azure dá suporte apenas a sessões no escopo do banco de dados. A Instância Gerenciada de SQL do Azure dá suporte a sessões no escopo do banco de dados e no escopo do servidor. As sessões no escopo do servidor são recomendadas para instâncias gerenciadas: saiba mais em CREATE EVENT SESSION.

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 é anulável. É um dentre:

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. É um dentre:

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 de desempenho no servidor quando os buffers de evento forem rapidamente cheios. 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 causar redução no desempenho detectável enquanto a sessão de evento está ativa. Para destinos de arquivo de evento no Banco de Dados SQL do Azure, comporta-se da mesma forma que ALLOW_SINGLE_EVENT_LOSS. Para obter mais informações, consulte EVENT_RETENTION_MODE.
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 1 a 2147483648 e -1. Um valor de -1 indica que a latência de distribuição é infinita. Permite valor nulo.
max_memory int A quantidade de memória alocada à sessão para buffer de evento. O valor padrão é de 4 MB. Permite valor nulo.
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, serão alocados dois buffers adicionais de max_event_size à sessão de evento. Permite valor nulo.
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 é anulável. memory_partition_mode é um dos:

G - NONE

C - PER_CPU

N - PER_NODE
memory_partition_mode_desc sysname O padrão é NONE. Não permite valor nulo. É um dentre:

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á habilitado e eventos relacionados em conexões de servidor diferentes podem 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. É um dentre:

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

Exige a permissão VIEW DATABASE STATE.

Próximas etapas

Saiba mais sobre conceitos relacionados nos seguintes artigos: