sys.fn_trace_gettable (Transact-SQL)

Şunlar için geçerlidir: SQL Server

Bir veya daha fazla iz dosyasının içeriğini tablo şeklinde döndürür.

Important

Bu özellik, SQL Server'ın gelecek bir sürümünde kaldırılacaktır. Bu özelliği yeni geliştirme çalışmalarında kullanmaktan kaçının ve şu anda bu özelliği kullanan uygulamaları değiştirmeyi planlayın. Bunun yerine Genişletilmiş Olaylar'ı kullanın.

Transact-SQL söz dizimi kuralları

Syntax

  
fn_trace_gettable ( 'filename' , number_files )

Arguments

'dosya adı'
İlk okunacak iz dosyasını belirtir. Dosya adınvarchar(256)'dır ve varsayılan yoktur.

number_files
Okunacak rollover dosya sayısını belirtir. Bu sayı, dosya adında belirtilen ilk dosyayı da içerir. number_filesbir int.

Remarks

Eğer number_filesvarsayılan olarak belirtilmişse, fn_trace_gettable tüm rollover dosyalarını izin sonuna kadar okur. fn_trace_gettable , belirtilen iz için geçerli olan tüm sütunların bulunduğu bir tablo döndürür. Daha fazla bilgi için sp_trace_setevent (Transact-SQL) sayfasına bakınız.

fn_trace_gettable fonksiyonunun, orijinal iz dosyası adının alt çizgi ve sayısal değerle biterse ( bu seçenek number_files argümanı kullanılarak belirtildiğinde) rollover dosyalarını yüklemeyeceğini unutmayın. (Bu, bir dosya döndüğünde otomatik olarak eklenen alt çizgi ve sayı için geçerli değildir.) Bir çözüm olarak, iz dosyalarını yeniden adlandırarak orijinal dosya adındaki alt çizgileri kaldırabilirsiniz. Örneğin, orijinal dosya Trace_Oct_5.trc ve rollover dosyası Trace_Oct_5_1.trc isimliyse, dosyaları TraceOct5.trc ve TraceOct5_1.trc olarak yeniden adlandırabilirsiniz.

Bu fonksiyon, yürütüldiği instance'da hâlâ aktif olan bir izi okuyabilir.

Permissions

Sunucuda ALTER TRACE izni gerektirir.

Examples

A. İz dosyasından satır içe aktarmak için fn_trace_gettable kullanımı

Aşağıdaki örnek, bir fn_trace_gettable ifadenin cümlesinin FROM içinde çağrı yaparSELECT...INTO.

USE AdventureWorks2022;  
GO  
SELECT * INTO temp_trc  
FROM fn_trace_gettable('c:\temp\mytrace.trc', default);  
GO

B. fn_trace_gettable kullanarak SQL Server tablosuna yüklenebilen bir IDENTITY sütunlu bir tabloyu döndürmek

Aşağıdaki örnek, fonksiyonu bir SELECT...INTO ifadenin parçası olarak çağırır ve tabloya IDENTITYyüklenebilen bir temp_trc sütunlu bir tablo döndürür.

USE AdventureWorks2022;  
GO  
SELECT IDENTITY(int, 1, 1) AS RowNumber, * INTO temp_trc  
FROM fn_trace_gettable('c:\temp\mytrace.trc', default);  
GO

İlgili içerik

  • Last updated on