Aracılığıyla paylaş


fn_get_audit_file (Transact-SQL)

Bir sunucu denetimi tarafından oluşturulan denetim dosyasından bilgi verir.Daha fazla bilgi için bkz:SQL Server denetim anlama.

Topic link iconTransact-SQL sözdizimi kuralları

fn_get_audit_file ( file_pattern, {default | initial_file_name | NULL }, {default | audit_file_offset | NULL } )

Bağımsız değişkenler

  • file_pattern
    Denetim dosyası için dizin yolunu ve dosya adını belirtir küme okunacak.Bu bağımsız değişkeni bir yol (sürücü veya ağ paylaşımı) hem de bir joker karakter içeren bir dosya adı içermelidir.Bir denetim dosyasından birden çok dosya almak için tek bir yıldız (*) kullanılabilir küme.Örneğin:

    • <yol>\* - Tüm denetim dosyaları belirtilen konuma. , toplama

    • <yol>\LoginsAudit_{GUID} - Belirtilen ad ve GUID çifti. tüm denetim dosyaları toplama

    • <yol>\LoginsAudit_{GUID}_00_29384.sqlaudit - Bir özel denetim. toplamak

    Not

    yol olmayan bir dosya adı kalıbını geçirerek, bir hata oluşturur.

  • initial_file_name
    Denetim kayıtlarını okumaya başlamak için Denetim dosya kümesinde belirli bir dosya adını ve yolunu belirtir.

    Not

    The initial_file_name argument must contain valid entries or must contain either the default | NULL value.

  • audit_file_offset
    Bilinen bir konuma için initial_file_name belirtilen dosyayı belirtir.Bu bağımsız değişkeni kullanıldığında, işlev okuma arabelleği belirtilen uzaklık hemen ilk kayıt sırasında başlar.

    Not

    The audit_file_offset argument must contain valid entries or must contain either the default | NULL value.

Dönen Tablolar

Aşağıdaki tabloda, bu işlev tarafından döndürülen Denetim dosyasının içeriği açıklanır.

sütun Name:

Tür

Açıklama

event_time

datetime2

Tarih ve saat denetlenebilir eylemin ne zaman harekete geçirilir.Null değil.

sequence_number

int

Denetimleri için yazma arabelleği sığmayacak kadar büyük olan bir tek denetim kaydı içindeki kayıtların sırasını izler.Null değil.

action_id

char(4)

Eylem kimliği.Null değil.

başarılı oldu

bit

1 = başarı

0 = başarısız

Gösterir mi eylem başarılı olayı başlatılır.Null değil.Oturum açma olayları dışındaki tüm olaylar için bu yalnızca izin onay başarılı veya başarısız oldu, işlem olmayan bildirir.

permission_bitmask

bigint

Bazı eylemler, bu izinler, erişim izni olan, reddedilen veya iptal olur.

is_column_permission

bit

1 = true

0 = false

Bu bayrak gösteren bir sütun düzey izni yok.Null değil.Sayı 0 olduğunda permission_bitmask = 0.

session_id

int

Kimliğini oturum, olay üzerine.Null değil.

server_principal_id

int

Oturum açma içerik kimliği, eylem içinde gerçekleştirilir.Null değil.

database_principal_id

int

Veritabanı kullanıcı bağlamı Kimliğini, eylem içinde gerçekleştirilir.Null değil.Bu, 0 döndürür uygulanmaz.Örneğin, bir sunucu işlemi.

target_server_principal_id

int

DENY/GRANT/REVOKE işlem üzerinde gerçekleştirilir sunucu asıl adı.Null değil.Geçerli değil, 0 döndürür.

target_database_principal_id

int

Veritabanını patron, DENY/GRANT/REVOKE işlemi gerçekleştirilir.Null değil.Geçerli değil, 0 döndürür.

object_id

int

Denetim oluştuğu varlık kimliği.Bu özellikler şunlardır::

  • Sunucu nesneleri

  • Veritabanları

  • Veritabanı nesneleri

  • Şema nesneleri

Null değil.0 Döndürür varlık, sunucunun veya Denetim değilse, bir nesnede gerçekleştirilen düzey.Örneğin, kimlik doğrulaması.

class_type

char(2)

Denetim üzerinde oluşan denetlenebilir varlık türü.Null değil.

session_server_principal_name

sysname

Oturumun sunucu asıl adı.Null.

server_principal_name

sysname

Geçerli oturum açma.Null.

server_principal_sid

varbinary

Geçerli oturum açma SID'si.Null.

database_principal_name

sysname

yükleme işlemine izin verilmez..Null.Yok, NULL döndürür.

target_server_principal_name

sysname

Eylem hedef oturum açın.Null.NULL olmayan (varsa) döndürür.

target_server_principal_sid

varbinary

Hedef oturum açma SID'si.Null.NULL olmayan (varsa) döndürür.

target_database_principal_name

sysname

Hedef kullanıcı eylem.Null.NULL olmayan (varsa) döndürür.

server_instance_name

nvarchar(120)

Denetim oluştuğu sunucusu örneğinin adı.Standart server\örnek biçimi kullanılır.

veritabanı_adı

sysname

Veritabanı bağlamında, eylem oluştu.Null.Sunucuda oluşan denetimleri için null döndürür düzey.

schema_name

sysname

Eylemin gerçekleştiği şema belirtir.Null.null bir şema dışındaki denetimleri oluşan verir.

object_name

sysname

Denetim oluştuğu varlığın adı.Bu özellikler şunlardır::

  • Sunucu nesneleri

  • Veritabanları

  • Veritabanı nesneleri

  • Şema nesneleri

Null.Sunucunun varlık olması veya bir nesne düzeyinde denetim gerçekleştirilmez verir NULL.Örneğin, kimlik doğrulaması.

deyim

nvarchar(4000)

Varsa, TSQL deyim.Null.NULL olmayan (varsa) döndürür.

additional_information

nvarchar(4000)

Yalnızca tek bir olay için geçerli olan benzersiz bilgiler XML olarak gönderilir.Denetlenebilir eylemleri az sayıda bu tür bilgiler içerir.

Null.Olay tarafından bildirilen ek bilgi olduğunda NULL döndürür.

Dosya_adı

varchar(260)

yol ve adı denetim günlük dosyasının kaydı geldi.Null değil.

audit_file_offset

bigint

Arabellek uzaklığı Denetim kaydını içeren dosya.Null değil.

Remarks

,file_patternbağımsız değişken geçirildi içinfn_get_audit_filebir yol veya dosya yok, başvuran veya dosya bir denetim dosyası değil,MSG_INVALID_AUDIT_FILE hata iletisini.

İzinler

GerektirenCONTROL SERVERizin.

Örnekler

Bu örnek okur adlı bir dosya\\serverName\Audit\HIPPA_AUDIT.sqlaudit.

SELECT * FROM sys.fn_get_audit_file ('\\serverName\Audit\HIPPA_AUDIT.sqlaudit',default,default);
GO

Bir denetim oluşturma hakkında tam bir örnek için bkz:SQL Server denetim anlama.

See Also

Reference

Other Resources