sys.fn_MSxe_read_event_stream (Transact-SQL)

Aplica-se a:SQL Server Banco de Dados SQL do Azure Instância Gerenciada SQL do Azure

sys.fn_MSxe_read_event_stream retorna dados binários para uso interno pela classe .NET QueryableXEventData . A interface do usuário de eventos estendidos no SQL Server Management Studio (SSMS) usa essa classe para ler dados de sessão de eventos.

Para exibir dados de eventos legíveis por humanos, use uma das seguintes opções em vez de chamar sys.fn_MSxe_read_event_stream diretamente:

Interface do usuário de eventos estendidos no SSMS.
sys.fn_xe_file_target_read_file função com valor de tabela.

Transact-SQL convenções de sintaxe

Sintaxe

sys.fn_MSxe_read_event_stream ( source , source_option )

Arguments

fonte

A fonte específica de dados de eventos retornados pela função. Source é nvarchar(260) sem padrão.

A fonte é interpretada de forma diferente dependendo do valor de source_option:

source_option Interpretação da fonte

0 Source é o nome de uma sessão de evento iniciada.

1 Source é o caminho para os arquivos de log da sessão de eventos a serem lidos.

Quando usado com arquivos no sistema de arquivos local, o código-fonte deve incluir o nome de um arquivo de log de sessão de eventos e pode conter * como curinga.

Quando usada com blobs em um contêiner de Armazenamento do Azure, a origem é uma URL HTTP construída pela concatenação de duas partes:

1. O caminho para um contêiner de armazenamento do Armazenamento do Azure, seguido por uma barra (/).
2. Um prefixo comum para os nomes de blobs no contêiner que devem ser lidos.

Por exemplo, usar https://<storage-account-name>.blob.core.windows.net/container-name>/xe_session como fonte recupera dados de todos os blobs com nomes começando com xe_session, e independentemente do restante do nome do blob, incluindo a extensão. Não é possível especificar caracteres curinga. Uma credencial que permita o acesso ao contêiner de Armazenamento do Azure deve existir.

source_option	Interpretação da fonte
`0`	Source é o nome de uma sessão de evento iniciada.
`1`	Source é o caminho para os arquivos de log da sessão de eventos a serem lidos. Quando usado com arquivos no sistema de arquivos local, o código-fonte deve incluir o nome de um arquivo de log de sessão de eventos e pode conter `` como curinga. Quando usada com blobs em um contêiner de Armazenamento do Azure, a origem* é uma URL HTTP construída pela concatenação de duas partes: 1. O caminho para um contêiner de armazenamento do Armazenamento do Azure, seguido por uma barra (`/`). 2. Um prefixo comum para os nomes de blobs no contêiner que devem ser lidos. Por exemplo, usar `https://<storage-account-name>.blob.core.windows.net/container-name>/xe_session` como fonte recupera dados de todos os blobs com nomes começando com `xe_session`, e independentemente do restante do nome do blob, incluindo a extensão. Não é possível especificar caracteres curinga. Uma credencial que permita o acesso ao contêiner de Armazenamento do Azure deve existir.

source_option

A opção que determina o tipo da fonte de dados do evento. Os valores possíveis são:

Valor	Description
`0`	Retorna dados de eventos do destino event_stream de uma sessão de evento iniciada. A função é executada indefinidamente, retornando novos dados de evento à medida que a sessão os produz.
`1`	Retorna dados de eventos dos arquivos de log de eventos estendidos especificados pela origem.

Tabela retornada

Nome da coluna	Tipo de dados	Description
tipo	int	O tipo de evento. Não anulável.
dados	image	Dados de eventos binários. É anulável.

Comentários

Esta página foi útil?

Last updated on 2025-09-10