sys.fn_xe_file_target_read_file (Transact-SQL)sys.fn_xe_file_target_read_file (Transact-SQL)

APLICA-SE A: simSQL Server simBanco de Dados SQL do Azure nãoSQL Data Warehouse do Azure nãoParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Lê arquivos que são criados pelo destino de arquivos assíncronos do mecanismo de Eventos estendidos.Reads files that are created by the Extended Events asynchronous file target. É retornado um evento, em formato XML, por linha.One event, in XML format, is returned per row.

Aviso

SQL Server 2008SQL Server 2008 e SQL Server 2008 R2SQL Server 2008 R2 aceitam resultados de rastreamento gerados no formato XEL e XEM.and SQL Server 2008 R2SQL Server 2008 R2 accept trace results generated in XEL and XEM format. SQL Server 2012 (11.x)SQL Server 2012 (11.x) Suporte estendido de eventos somente resultados de rastreamento no formato XEL.Extended Events only support trace results in XEL format. É recomendável usar o SQL Server Management Studio para ler resultados de rastreamento no formato XEL.We recommend that you use SQL Server Management Studio to read trace results in XEL format.

Ícone de link do tópico Convenções de sintaxe de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxeSyntax

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

ArgumentosArguments

pathpath
O caminho para os arquivos a serem lidos.The path to the files to read. caminho pode conter curingas e incluir o nome de um arquivo.path can contain wildcards and include the name of a file. caminho está nvarchar (260) .path is nvarchar(260). Não há nenhum padrão.There is no default. No contexto do banco de dados SQL, esse valor é uma URL de HTTP para um arquivo no armazenamento do Azure.In the context of Azure SQL Database, this value is an HTTP URL to a file in Azure Storage.

mdpathmdpath
O caminho para o arquivo de metadados que corresponde ao arquivo ou arquivos especificados pelo caminho argumento.The path to the metadata file that corresponds to the file or files specified by the path argument. mdpath está nvarchar (260) .mdpath is nvarchar(260). Não há nenhum padrão.There is no default. Começando com o SQL Server 2016, esse parâmetro pode ser fornecido como nulo.Starting with SQL Server 2016, this parameter can be given as null.

Observação

SQL Server 2012 (11.x)SQL Server 2012 (11.x) não requer o mdpath parâmetro.does not require the mdpath parameter. No entanto, é mantido para compatibilidade com versões anteriores para arquivos de log gerados nas versões anteriores do SQL Server.However, it is maintained for backward compatibility for log files generated in previous versions of SQL Server.

initial_file_nameinitial_file_name
O primeiro arquivo leiam caminho.The first file to read from path. initial_file_name está nvarchar (260) .initial_file_name is nvarchar(260). Não há nenhum padrão.There is no default. Se nulo é especificado como o argumento de todos os arquivos encontrados na caminho são lidos.If null is specified as the argument all the files found in path are read.

Observação

initial_file_name e initial_offset são argumentos emparelhados.initial_file_name and initial_offset are paired arguments. Se você especificar um valor um dos argumentos, deverá especificar um valor para o outro argumento.If you specify a value for either argument you must specify a value for the other argument.

initial_offsetinitial_offset
Usado para especificar o último deslocamento lido anteriormente e o ignora todos os eventos até o deslocamento (inclusive).Used to specify last offset read previously and skips all events up to the offset (inclusive). A enumeração de evento é iniciada após o deslocamento especificado.Event enumeration starts after the offset specified. initial_offset está bigint.initial_offset is bigint. Se nulo é especificado como o argumento do arquivo inteiro será lido.If null is specified as the argument the entire file will be read.

Tabela retornadaTable Returned

Nome da colunaColumn name Tipo de dadosData type DescriçãoDescription
module_guidmodule_guid uniqueidentifieruniqueidentifier O módulo de evento GUID.The event module GUID. Não permite valor nulo.Is not nullable.
package_guidpackage_guid uniqueidentifieruniqueidentifier O pacote de evento GUID.The event package GUID. Não permite valor nulo.Is not nullable.
object_nameobject_name nvarchar(256)nvarchar(256) O nome do evento.The name of the event. Não permite valor nulo.Is not nullable.
event_dataevent_data nvarchar(max)nvarchar(max) Os conteúdos de evento no formato XML.The event contents, in XML format. Não permite valor nulo.Is not nullable.
file_namefile_name nvarchar(260)nvarchar(260) O nome do arquivo que contém o evento.The name of the file that contains the event. Não permite valor nulo.Is not nullable.
file_offsetfile_offset bigintbigint O deslocamento do bloco no arquivo que contém o evento.The offset of the block in the file that contains the event. Não permite valor nulo.Is not nullable.
timestamp_utctimestamp_utc datetime2datetime2 Aplica-se a: SQL Server 2017 (14.x)SQL Server 2017 (14.x) a SQL Server 2017SQL Server 2017 e Banco de dados SQL do AzureAzure SQL Database.Applies to: SQL Server 2017 (14.x)SQL Server 2017 (14.x) through SQL Server 2017SQL Server 2017 and Banco de dados SQL do AzureAzure SQL Database.

A data e hora (fuso horário UTC) do evento.The date and time (UTC timezone) of the event. Não permite valor nulo.Is not nullable.

ComentáriosRemarks

Ler resultados grandes define executando sys. fn_xe_file_target_read_file em Management StudioManagement Studio pode resultar em um erro.Reading large result sets by executing sys.fn_xe_file_target_read_file in Management StudioManagement Studio may result in an error. Use o resultados em arquivo modo (Ctrl + Shift + F) para exportar grandes conjuntos de resultados para um arquivo e ler o arquivo em outra ferramenta em vez disso.Use the Results to File mode (Ctrl+Shift+F) to export large result sets to a file and read the file with another tool instead.

PermissõesPermissions

, é necessário ter permissão VIEW SERVER STATE no servidor.Requires VIEW SERVER STATE permission on the server.

ExemplosExamples

A.A. Recuperando dados de destinos de arquivoRetrieving data from file targets

O exemplo a seguir usa todas as linhas de todos os arquivos.The following example gets all the rows from all the files. Neste exemplo, os destinos de arquivo e metarquivos estão localizados na pasta de rastreamento na unidade C: .In this example the file targets and metafiles are located in the trace folder on the C:\ drive.

SELECT * FROM sys.fn_xe_file_target_read_file('C:\traces\*.xel', 'C:\traces\metafile.xem', null, null);  

Consulte tambémSee Also

Exibições de gerenciamento dinâmico de eventos estendidos Extended Events Dynamic Management Views
Exibições de catálogo de eventos estendidos (Transact-SQL) Extended Events Catalog Views (Transact-SQL)
Eventos estendidosExtended Events