Compartilhar via

  • Artigo

sys.fn_xe_file_target_read_file (Transact-SQL)

Lê arquivos que são criados pelo destino de arquivos assíncronos do mecanismo de Eventos estendidos. É retornado um evento, em formato XML, por linha.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

sys.fn_xe_file_target_read_file ( path, mdpath, initial_file_name, initial_offset )

Argumentos

  • path
    O caminho dos arquivos que serão lidos. path pode conter curingas e incluir o nome de um arquivo. path é nvarchar(260). Não há nenhum padrão.

  • mdpath
    O caminho do arquivo de metadados correspondente ao arquivo ou aos arquivos especificados pelo argumento path. mdpath é nvarchar(260). Não há nenhum padrão.

  • initial_file_name
    O primeiro arquivo que será lido do path. initial_file_name é nvarchar(260). Não há nenhum padrão. Se null for especificado como o argumento, todos os arquivos localizados em path serão lidos.

    ObservaçãoObservação

    initial_file_name e initial_offset são argumentos emparelhados. Se você especificar um valor um dos argumentos, deverá especificar um valor para o outro argumento.

  • initial_offset
    O deslocamento no primeiro arquivo onde a leitura começa. initial_offset é bigint. Se null for especificado como o argumento, o arquivo inteiro será lido.

Tabela retornada

Nome da coluna

Tipo de dados

Descrição

module_guid

uniqueidentifier

O módulo de evento GUID. Não permite valor nulo.

package_guid

uniqueidentifier

O pacote de evento GUID. Não permite valor nulo.

object_name

nvarchar(256)

O nome do evento. Não permite valor nulo.

event_data

nvarchar(max)

Os conteúdos de evento no formato XML. Não permite valor nulo.

file_name

nvarchar(260)

O nome do arquivo que contém o evento. Não permite valor nulo.

file_offset

bigint

O deslocamento do bloco no arquivo que contém o evento. Não permite valor nulo.

Permissões

Requer permissão VIEW SERVER STATE no servidor.

Exemplos

A. Recuperando dados de destinos de arquivo

O exemplo a seguir usa todas as linhas de todos os arquivos. Neste exemplo, os destinos de arquivo e metarquivos estão localizados na pasta de rastreamento na unidade C: \.

select * from sys.fn_xe_file_target_read_file('C:\traces\*.xel', 'C:\traces\metafile.xem', null, null)