fn_xe_file_target_read_file (Transact-sql)

Makale
10/29/2012

Genişletilmiş olayları zaman uyumsuz dosya hedef tarafından oluşturulan dosyaları okur. xml biçiminde bir olay başına satır döndürülür.

Dikkat
SQL Server 2008 ve SQL Server 2008 xel ve xem biçiminde oluşturulan izleme sonuçları kabul eder. SQL Server 2011 Genişletilmiş olayları sadece izleme sonuçları xel formatlarını destekler. Izleme sonuçları xel formatında okumak için SQL Server Profiler'I kullanmanızı öneririz.

Konu bağlantısı simgesi Transact-SQL Sözdizim Kuralları

Sözdizimi

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

Bağımsız değişkenler

path
Okumak için dosya yolu. pathjoker karakter içeren ve dosya adını içerir. pathis nvarchar(260). Orada hiçbir varsayılan vardır.
mdpath
Belirtilen dosya veya karşılık gelen meta dosya yolunu pathdeğişkeni. mdpathis nvarchar(260). Orada hiçbir varsayılan vardır.

[!NOT]

SQL Server 2011 gerektirmeyen mdpathparametresi. Ancak, SQL Server'ın önceki sürümlerinde oluşturulan günlük dosyaları için geriye dönük uyumluluk için korunur.
initial_file_name
İlk dosyanın okuma path. initial_file_nameis nvarchar(260). Orada hiçbir varsayılan vardır. Eğer nulltüm dosyaları bulunan bağımsız olarak belirtilen pathokuyun.

[!NOT]

initial_file_nameve initial_offseteşli argümanlar. İki bağımsız değişken için bir değer belirtirseniz, diğer bağımsız değişkeni için bir değer belirtmeniz gerekir.
initial_offset
Okumaya başladığı ilk dosya uzaklık. initial_offsetis bigint. Eğer nullbağımsız değişkenini dosyanın tamamını okuyacak gibi belirtilir.

Dönen Tablo

Sütun adı	Veri türü	Açıklama
module_guid	uniqueidentifier	Olay modülü GUID. NULL değil.
package_guid	uniqueidentifier	Olay paket GUID. NULL değil.
object_name	nvarchar(256)	Olay adı. NULL değil.
event_data	nvarchar(max)	Olay içindekiler, xml biçiminde. NULL değil.
file_name	nvarchar(260)	Olayı içeren dosya adı. NULL değil.
file_offset	bigint	Olayı içeren dosya bloğu uzaklığı. NULL değil.

İzinler

Sunucu üzerindeki VIEW server state izni gerektirir.

Örnekler

A.Dosya hedeflerden veri alınıyor

Aşağıdaki örnek, tüm dosyaları için tüm satırları alır. Bu örnekte dosya, hedefleri ve meta, c:\ sürücü izleme klasöründe bulunur.

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

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