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.
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::
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::
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