sys.dm_xe_objects (Transact-SQL)

  • Artigo

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do Azure

Retorna uma linha para cada objeto exposto por um pacote de evento. Os objetos podem ser um dos seguintes:

  • Eventos. Os eventos indicam pontos de interesse em um caminho de execução. Todos os eventos contêm informações sobre um ponto de interesse.

  • Ações. As ações são executadas sincronicamente quando os eventos têm início. Uma ação pode acrescentar dados em tempo de execução a um evento.

  • Destinos. Os destinos consomem eventos de forma síncrona no thread que aciona o evento ou de forma assíncrona em um thread fornecido pelo sistema.

  • Predicados. Fontes de predicado recuperam valores de fontes de evento para uso em operações de comparação. As comparações de predicado comparam tipos de dados específicos e retornam um valor booliano.

  • Tipos. Os tipos encapsulam o comprimento e as características da coleção de bytes que é exigida para interpretar os dados.

Nome da coluna Tipo de dados Descrição
name nvarchar(60) O nome do objeto. name é exclusivo dentro de um pacote para um tipo de objeto específico. Não permite valor nulo.
object_type nvarchar(60) O tipo do objeto. object_type é um dos seguintes:

event

ação

destino

pred_source

pred_compare

type

Não permite valor nulo.
package_guid uniqueidentifier A GUID para o pacote que expõe esta ação. Há uma relação muitos para uma com sys.dm_xe_packages.package_id. Não permite valor nulo.
descrição nvarchar(256) Uma descrição da ação. description é definido pelo autor do pacote. Não permite valor nulo.
funcionalidades int Um bitmap que descreve as funcionalidades do objeto. Permite valor nulo.
capabilities_desc nvarchar(256) Lista todas as funcionalidades do objeto. Permite valor nulo.

Recursos que se aplicam a todos os tipos de objeto

-
Privado. O único objeto disponível para uso interno e que não pode ser acessado via CREATE/ALTER EVENT SESSION DDL. Audite eventos e destinos nesta categoria além de um número pequeno de objetos usados internamente.

===============

Recursos de eventos

-
No_block. O evento está em um caminho de código crítico que não pode ser bloqueado por nenhuma razão. Eventos com essa capacidade não podem ser adicionados a nenhuma sessão de evento que especifique NO_EVENT_LOSS.

===============

Recursos que se aplicam a todos os tipos de objeto

-
Process_whole_buffers. O destino consome buffers de eventos de uma vez, em vez de evento após evento.

-
Singleton. Somente uma instância do destino pode existir em um processo. Embora várias sessões de evento possam referenciar o mesmo destino singleton, há realmente só uma instância e essa instância visualizará cada evento exclusivo somente uma vez. Isso será importante se o destino for adicionado a várias sessões que coletam o mesmo evento.

-
Synchronous. O destino é executado no thread que está gerando o evento, antes de o controle ser retornado à linha de código de chamada.
type_name nvarchar(60) O nome para objetos pred_source e pred_compare. Permite valor nulo.
type_package_guid uniqueidentifier O GUID do pacote que expõe o tipo no qual este objeto opera. Permite valor nulo.
type_size int O tamanho, em bytes, do tipo de dados. Isto só é para tipos de objeto válidos. Permite valor nulo.

Permissões

, é necessário ter permissão VIEW SERVER STATE no servidor.

Permissões para SQL Server 2022 e posteriores

Requer a permissão VIEW SERVER PERFORMANCE STATE no servidor.

Cardinalidades de relação

De Para Relação
sys.dm_xe_objects.package_guid sys.dm_xe_packages.guid Muitos para um

Próximas etapas

Saiba mais sobre conceitos relacionados nos seguintes artigos: