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.

Cuidado
O SQL Server 2008 e o SQL Server 2008 R2 aceitam resultados de rastreamento gerados no formato XEL e XEM. Os Eventos Estendidos do SQL Server 2012 oferecem suporte apenas a resultados de rastreamento no formato XEL. É recomendável usar o SQL Server Management Studio para ler resultados de rastreamento no formato XEL.

Convenções da sintaxe Transact-SQL

Sintaxe

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

Argumentos

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

• mdpath
  O caminho para o arquivo de metadados correspondente ao(s) arquivo(s) especificado(s) pelo argumento path. mdpath é nvarchar(260). Não há nenhum padrão.

  Observação
  O SQL Server 2012 não requer o parâmetro mdpath. No entanto, é mantido para compatibilidade com versões anteriores para arquivos de log gerados nas versões anteriores do SQL Server.

• 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çã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
  Usado para especificar o último deslocamento lido anteriormente e o ignora todos os eventos até o deslocamento (inclusive). A enumeração de evento é iniciada após o deslocamento especificado. 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 a 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);

Consulte também

Referência

Exibições de gerenciamento dinâmico de eventos estendidos

exibições do catálogo de eventos estendidos (Transact-SQL)

Conceitos

Eventos estendidos