Partilhar via


sys.dm_xe_objects (Transact-SQL)

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

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

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

  • Ações. As ações são executadas de forma síncrona quando os eventos são ativados. Uma ação pode adicionar dados de tempo de execução a um evento.

  • Alvos. Os alvos consomem eventos, seja de forma síncrona na thread que lança o evento ou assíncrona numa thread fornecida pelo sistema.

  • Predicados. As fontes de predicados recuperam valores das fontes de eventos para utilização em operações de comparação. As comparações de predicados comparam tipos de dados específicos e retornam um valor booleano.

  • Tipos. Os tipos encapsulam o comprimento e as características da coleção de bytes, que são necessárias para interpretar os dados.

Nome da coluna Tipo de dados Description
nome nvarchar(60) O nome do objeto. O nome é único dentro de um pacote para um tipo específico de objeto. Não é anulável.
tipo_de_objeto nvarchar(60) O tipo do objeto. object_type é um dos seguintes:

evento

ação

destino

pred_source

pred_compare

tipo

Não é anulável.
package_guid uniqueidentifier O GUID do pacote que expõe esta ação. Existe uma relação muitos-para-um com sys.dm_xe_packages.package_id. Não é anulável.
descrição Nvarchar(256) Uma descrição da ação. A descrição é definida pelo autor do pacote. Não é anulável.
capabilities int Um bitmap que descreve as capacidades do objeto. É anulável.
capabilities_desc Nvarchar(256) Lista todas as capacidades do objeto. É anulável.

Capacidades que se aplicam a todos os tipos de objetos

-
Privado. O único objeto disponível para uso interno, e que não pode ser acedido através do CREATE/ALTER EVENT SESSION DDL. Os eventos e metas de auditoria enquadram-se nesta categoria, além de um pequeno número de objetos usados internamente.

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

Capacidades de Eventos

-
No_block. O evento está num caminho de código crítico que não pode bloquear por nenhuma razão. Eventos com esta funcionalidade não podem ser adicionados a nenhuma sessão de eventos que especifique NO_EVENT_LOSS.

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

Capacidades que se aplicam a todos os tipos de objetos

-
Process_whole_buffers. O alvo consome buffers de eventos de cada vez, em vez de evento a evento.

-
Solteiro. Apenas uma instância do alvo pode existir num processo. Embora várias sessões de evento possam referenciar o mesmo alvo singleton, na verdade só existe uma instância, e essa instância verá cada evento único apenas uma vez. Isto é importante se o alvo for adicionado a múltiplas sessões que recolhem o mesmo evento.

-
Síncrono. O destino é executado no thread que está a produzir o evento, antes de o controlo ser devolvido à linha de código que chama.
type_name nvarchar(60) O nome para pred_source e pred_compare objetos. É anulável.
type_package_guid uniqueidentifier O GUID do pacote que expõe o tipo em que este objeto opera. É anulável.
type_size int O tamanho, em bytes, do tipo de dado. Isto aplica-se apenas a tipos de objetos válidos. É anulável.

Permissions

Requer permissão VER ESTADO DO SERVIDOR no servidor.

Permissões para SQL Server 2022 e posterior

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

Cardinalidades de relacionamento

De Para Relacionamento
sys.dm_xe_objects.package_guid sys.dm_xe_packages.guid Muitos para um

Próximos passos

Saiba mais sobre conceitos relacionados nos seguintes artigos: