Eventos Estendidos
funcionalLista sessões de Eventos Estendidos com estado de execução e detalhes por sessão; iniciar e parar geram script primeiro.
Duas grades lado a lado: a da esquerda lista as sessões com o estado de inicialização e se cada uma está em execução no momento; selecione uma e Mostrar eventos e destinos
preenche a grade da direita com os eventos e alvos dessa sessão. Iniciar e parar uma sessão é com foco em scripts: Gerar script de início e Gerar script de parada
abrir exatamente o ALTER EVENT SESSION … STATE = START|STOP instrução em uma aba para revisão, em vez de executar direto do diálogo - o rodapé diz isso.
sys.database_event_sessions). Aberto pela paleta de comandos, ele lista as sessões de escopo de servidor da instância; no Azure SQL Database, que só tem sessões de escopo de banco de dados, ele volta para elas automaticamente.
Abrindo isso
- Para um banco de dados: clique com o botão direito no banco de dados no explorador e escolha Ferramentas › Eventos Estendidos.... O SQLly ativa esse banco de dados primeiro. O título do diálogo termina em (escopo do banco de dados).
- Para toda a instância: executar Eventos Estendidos... do paleta de comandos. O título termina em (escopo do servidor). Se o catálogo no escopo do servidor não puder ser lido, como no Azure SQL Database - o painel tenta de novo no escopo do banco de dados e o título avisa.
Verificando uma sessão e interrompendo-a
Suponha que um colega tenha deixado uma sessão de rastreamento em execução e você queira confirmar o que ela captura antes de desligá-la:
- Abra Eventos Estendidos. A grade à esquerda lista cada sessão por nome com
startup_state(se começar com o servidor) eis_running(1quando estiver ativo agora mesmo). - Selecione a linha da sessão e pressione Mostrar eventos e destinos. A grade à direita, intitulada Eventos e alvos - <session>, lista
event_nameetarget_namepares, comosql_batch_completedescritos para umevent_filealvo. - Pressione Gerar script de parada. O diálogo se fecha e uma aba de consulta se abre com a instrução, que você revisa e executa por conta própria:
ALTER EVENT SESSION [long_running_queries] ON SERVER STATE = STOP;
Do banco de dados que a instrução indica ON DATABASE em vez disso.
Gerar script de início produz a mesma instrução com STATE = START. Os nomes das sessões são colocados entre colchetes com qualquer ] duplicado, então nomes incomuns estão seguros.
Botões
| Botão | O que faz |
|---|---|
| Atualizar | Relê a lista de sessões e limpa a grade de detalhes. |
| Mostrar eventos e destinos | Carrega os eventos e destinos da sessão selecionada na grade à direita. |
| Gerar script de início / Gerar script de parada | Abre o ALTER EVENT SESSION instrução para a sessão selecionada em uma nova aba de consulta. Nada é executado a partir do diálogo. |
Sem nenhuma linha selecionada, as ações informam para selecionar uma sessão primeiro em vez de adivinhar.
Permissões e limites
- Ler metadados do Extended Events requer
VIEW SERVER STATE, ouVIEW DATABASE STATEno Azure SQL. Se a lista não puder ser lida, o painel mostra o erro do servidor com esse lembrete. - O painel lista sessões e suas configurações; ele não cria sessões nem lê dados de eventos capturados. Escreva
CREATE EVENT SESSIONem uma aba de consulta e leia os destinos com as funções usuais, comosys.fn_xe_file_target_read_file.
Família SQL Server, Extended Events é um recurso do SQL Server. Em outros motores, o item de menu indica isso; no ClickHouse ele aponta para system.query_log e system.trace_log, que Insights de consulta já lê.