sys.fn_get_audit_file (Transact-SQL)

Det här argumentet måste innehålla både en sökväg (enhetsbeteckning eller nätverksresurs) och ett filnamn som kan innehålla ett jokertecken. En enda asterisk (*) kan användas för att samla in flera filer från en granskningsfiluppsättning. Till exempel:

• \<path>\* – Samla in alla granskningsfiler på den angivna platsen.

• <path>\LoginsAudit_{GUID}* – Samla in alla granskningsfiler som har det angivna namnet och GUID-paret.

• <path>\LoginsAudit_{GUID}_00_29384.sqlaudit – Samla in en specifik granskningsfil.

Det här argumentet används för att ange en blob-URL (inklusive lagringsslutpunkten och containern). Även om det inte stöder ett asterisk-jokertecken kan du använda ett partiellt filnamnsprefix (i stället för det fullständiga blobnamnet) för att samla in flera filer (blobbar) som börjar med det här prefixet. Till exempel:

• <Storage_endpoint>/<Container>/<ServerName>/<DatabaseName>/ – samlar in alla granskningsfiler (blobar) för den specifika databasen.

• <Storage_endpoint>/<Container>/<ServerName>/<DatabaseName>/<AuditName>/<CreationDate>/<FileName>.xel – samlar in en specifik granskningsfil (blob).

SQL Server 2019 (15.x) och tidigare versioner kräver CONTROL SERVER behörighet på servern.

SQL Server 2022 (16.x) och senare versioner kräver VIEW SERVER SECURITY AUDIT behörighet på servern.

Kräver behörigheten CONTROL DATABASE.

• Serveradministratörer kan komma åt granskningsloggar för alla databaser på servern.

• Icke-serveradministratörer kan bara komma åt granskningsloggar från den aktuella databasen.

• Blobbar som inte uppfyller ovanstående villkor hoppas över (en lista över överhoppade blobar visas i frågeutdatameddelandet). Funktionen returnerar endast loggar från blobar som åtkomst tillåts för.

Det här exemplet läser från en fil med namnet \\serverName\Audit\HIPAA_AUDIT.sqlaudit.

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

Ett fullständigt exempel på hur du skapar en granskning finns i SQL Server Audit (Database Engine).

Det här exemplet läser från en fil med namnet ShiraServer/MayaDB/SqlDbAuditing_Audit/2017-07-14/10_45_22_173_1.xel:

SELECT *
FROM sys.fn_get_audit_file(
    'https://mystorage.blob.core.windows.net/sqldbauditlogs/ShiraServer/MayaDB/SqlDbAuditing_Audit/2017-07-14/10_45_22_173_1.xel',
    DEFAULT,
    DEFAULT
);
GO

Det här exemplet läser från samma fil som tidigare visats, men med fler T-SQL-satser (TOP, ORDER BYoch WHERE -satsen för filtrering av granskningsposter som returneras av funktionen):

SELECT TOP 10 *
FROM sys.fn_get_audit_file(
    'https://mystorage.blob.core.windows.net/sqldbauditlogs/ShiraServer/MayaDB/SqlDbAuditing_Audit/2017-07-14/10_45_22_173_1.xel',
    DEFAULT,
    DEFAULT
)
WHERE server_principal_name = 'admin1'
ORDER BY event_time;
GO

Information om hur du konfigurerar Azure SQL Database-granskning finns i Komma igång med SQL Database-granskning.