Gerir Sessões de Eventos no Explorador de Objetos

Aplica-se a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceBase de dados SQL no Microsoft Fabric

Este tópico discute as ações que pode tomar no Explorador de Objetos que afetam Eventos Estendidos:

• Crie uma Sessão de Eventos Estendidos

• Iniciar ou Parar uma Sessão de Eventos Prolongados

• Exportar uma Sessão de Eventos Estendidos

• Importar um Modelo de Sessão de Eventos Estendidos

• Editar uma Sessão de Eventos Estendidos

• Eliminar uma Sessão de Eventos Estendidos

Crie uma Sessão de Eventos Estendidos

Para mais informações sobre como criar uma sessão de Eventos Estendidos, consulte Criar uma Sessão de Eventos Prolongados.

Iniciar ou Parar uma Sessão de Eventos Prolongados

Pode iniciar ou parar uma sessão de Eventos Estendidos através do Editor de Consultas usando a instrução ALTER EVENT SESSION ou utilizando o nó de Eventos Estendidos do Explorador de Objetos.

Quando interrompe uma sessão de evento, esta deixa de ser listada como uma sessão ativa na sys.dm_xe_sessions vista de gestão dinâmica (DMV). No entanto, a definição da sessão mantém-se intacta e pode reiniciar a sessão novamente. Para remover completamente uma definição de sessão, deve apagar a sessão.

Para iniciar ou terminar uma sessão de Eventos Estendidos, deve possuir a permissão ALTER ANY EVENT SESSION.

Quando interrompe uma sessão que utiliza um destino em memória, como o buffer em anel, a distribuição em compartimentos, o emparelhamento de eventos ou os contadores de eventos síncronos, toda a informação armazenada no buffer da sessão (na coluna target_data do DMV sys.dm_xe_session_targets) será perdida. Para aceder aos dados do evento depois de terminar a sessão, deve guardar os dados antes de a terminar, ou configurar a sessão para usar o alvo do ficheiro.

Iniciar ou Parar uma Sessão de Eventos Estendidos usando o Editor de Consultas

Para iniciar uma sessão, emita as seguintes instruções, substituindo-session_name pelo nome da sessão de Eventos Estendidos:

ALTER EVENT SESSION [session_name]  
ON SERVER  
STATE = START  

Para interromper uma sessão, emita as seguintes instruções, substituindo session_name pelo nome da sessão de Eventos Estendidos:

ALTER EVENT SESSION [session_name]  
ON SERVER  
STATE = STOP  

Iniciar ou Terminar uma Sessão de Eventos Estendidos no Explorador de Objetos

Para iniciar ou parar uma sessão de Eventos Estendidos no Explorador de Objetos, expanda os nós Gestão, Eventos Estendidos e depois Sessões , clique com o botão direito numa sessão e depois clique em Iniciar Sessão ou Parar Sessão.

Exportar um Modelo de Sessão de Eventos Estendidos

Podes exportar uma sessão de Eventos Estendidos usando o Explorador de Objetos e guardá-la como um ficheiro modelo .xml. Por exemplo, pode querer exportar uma sessão e depois aplicar o modelo a uma nova sessão de evento usando o Assistente de Nova Sessão ou o Assistente de Nova Sessão .

Ao exportar uma sessão, certifique-se de guardar o ficheiro modelo num local que utilize o sistema de ficheiros NTFS e de restringir o acesso a utilizadores autorizados a visualizar a informação.

Para exportar uma sessão de Eventos Estendidos no Object Explorer:

1. Expandir Gestão, Eventos Estendidos e depois Sessões

2. Clique com o botão direito na sessão que pretende exportar e selecione Exportar Sessão.

3. Na caixa de diálogo Guardar Como , selecione um local para guardar o ficheiro, escreva o nome do ficheiro na caixa Nome do Ficheiro e depois clique em Guardar.

   Se guardar o ficheiro na localização padrão de modelos do SQL Server Management Studio, o modelo aparecerá na lista suspensa de modelos pré-definidos quando usar o Assistente de Nova Sessão e a janela Nova Sessão.

Importar um Modelo de Sessão de Eventos Estendidos

Usando o Object Explorer, pode importar um modelo para uma sessão de Eventos Estendidos. Por exemplo, pode querer fazer isto para criar uma sessão a partir de um template que foi exportado de outra instância do SQL Server.

Para importar uma sessão de Eventos Estendidos, deve ter as permissões necessárias de ALTERAR QUALQUER SESSÃO DE EVENTOS.

Antes de importar um ficheiro modelo, certifique-se de que o ficheiro é de uma fonte confiável. Os ficheiros modelo devem ser guardados num local que utilize o sistema de ficheiros NTFS e onde o acesso seja restrito a utilizadores autorizados a visualizar a informação.

Para importar uma sessão de Eventos Estendidos:

1. No Object Explorer, expande os nós Gestão e depois Eventos Estendidos .

2. Clique com o botão direito em Sessões e selecione Nova Sessão.

3. Especifique um nome para a sessão.

4. Expande a lista suspensa Template.

5. Clique <em Ficheiro e depois em ...>Abrir e navegue pela sessão (ficheiro XML) que quer importar.

A sessão aparece debaixo do nó Sessões. Por defeito, a sessão não é iniciada.

Editar uma Sessão de Eventos Estendidos

Pode editar uma sessão de Eventos Estendidos no Explorador de Objetos.

Para editar uma sessão de Eventos Estendidos:

1. No Object Explorer, expanda os nós Gestão, Eventos Estendidos e depois Sessões .

2. Clique com o botão direito numa sessão e selecione Propriedades.

3. Na secção Selecionar uma página , selecione a(s) página(s) que pretende editar.

4. Depois de terminares de rever a sessão do evento, clica em OK.

Escrever um script para uma definição de sessão de eventos usando Transact-SQL

Tanto o Assistente de Nova Sessão como o diálogo de Nova Sessão têm uma opção de Script que gera o Transact-SQL que define a sessão de Eventos Estendidos.

Pode aceder ao Transact-SQL de uma sessão de Eventos Estendidos existente clicando com o botão direito no nome da sessão, selecionando Sessão de Script como e depois Criar para.

Eliminar uma Sessão de Eventos Estendidos

Pode eliminar uma sessão de Eventos Estendidos:

• No Editor de Consultas usando DROP EVENT SESSION.

• No Object Explorer.

Quando elimina uma sessão de evento, toda a informação de configuração é removida e a definição da sessão deixa de aparecer na vista de catálogo sys.server_event_sessions.

Para eliminar uma sessão de Eventos Estendidos, deve ter a permissão ALTERAR QUALQUER SESSÃO DE EVENTO.

Para eliminar uma sessão de Eventos Estendidos no Explorador de Objetos:

1. Expandir os nós Gestão, Eventos Estendidos e em seguida Sessões.

2. Clique com o botão direito numa sessão e selecione Eliminar.

3. Na caixa de diálogo Eliminar Objeto, clique em OK.

4. Depois de terminares de rever a sessão do evento, clica em OK.

Para eliminar uma sessão de Eventos Estendidos no Editor de Consultas, emita as seguintes instruções, substituindo-session_name pelo nome da sessão de Eventos Estendidos que pretende eliminar:

DROP EVENT SESSION [session_name]  
ON SERVER