sys.fn_get_audit_file (Transact-SQL)

Este argumento debe incluir una ruta de acceso (letra de unidad o recurso compartido de red) y un nombre de archivo que pueda contener un carácter comodín. Se puede usar un único asterisco (*) para recopilar varios archivos de un conjunto de archivos de auditoría. Por ejemplo:

• \<path>\* - Recopilar todos los archivos de auditoría en la ubicación especificada.

• <path>\LoginsAudit_{GUID}* - Recopilar todos los archivos de auditoría que tienen el nombre y el par GUID especificados.

• <path>\LoginsAudit_{GUID}_00_29384.sqlaudit - Recopilar un archivo de auditoría específico.

Este argumento se usa para especificar una dirección URL de blob (incluido el punto de conexión de almacenamiento y el contenedor). Aunque no admite un comodín asterisco, puede usar un prefijo de nombre de archivo parcial (blob) (en lugar del nombre de blob completo) para recopilar varios archivos (blobs) que comiencen por este prefijo. Por ejemplo:

• <Storage_endpoint>/<Container>/<ServerName>/<DatabaseName>/ : recopila todos los archivos de auditoría (blobs) de la base de datos específica.

• <Storage_endpoint>/<Container>/<ServerName>/<DatabaseName>/<AuditName>/<CreationDate>/<FileName>.xel : recopila un archivo de auditoría específico (blob).

Requiere el permiso CONTROL SERVER.

Requiere el permiso CONTROL DATABASE.

• Los administradores del servidor pueden acceder a los registros de auditoría de todas las bases de datos del servidor.

• Los administradores que no son de servidor solo pueden acceder a los registros de auditoría desde la base de datos actual.

• Los blobs que no cumplen los criterios anteriores se omiten (se muestra una lista de blobs omitidos en el mensaje de salida de la consulta). La función devuelve registros solo de blobs para los que se permite el acceso.

En este ejemplo se lee un archivo denominado \\serverName\Audit\HIPAA_AUDIT.sqlaudit.

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

Para ver un ejemplo completo de cómo crear una auditoría, vea SQL Server Audit (motor de base de datos).

En este ejemplo se lee de un archivo denominado 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

En este ejemplo se lee del mismo archivo que se mostró anteriormente, pero con más cláusulas T-SQL (TOP, ORDER BYy WHERE para filtrar los registros de auditoría devueltos por la función):

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

Para obtener información sobre cómo configurar la auditoría de Azure SQL Database, consulte Introducción a la auditoría de SQL Database.