sys.dm_xe_objects (Transact-SQL)

  • Artigo

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

  • action

  • target

  • 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 um com sys.dm_xe_packages.package_id. Não permite valor nulo.

description

nvarchar(256)

Uma descrição da ação. description é definido pelo autor do pacote. Não permite valor nulo.

capabilities

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

    • Private. 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

Requer a permissão VIEW SERVER STATE no servidor.

Cardinalidades da relação

De

Para

Relação

sys.dm_xe_objects.package_guid

sys.dm_xe_packages.guid

Muitos para um

Consulte também

Referência

Exibições e funções de gerenciamento dinâmico (Transact-SQL)