sys.fn_get_audit_file (Transact-SQL)

Cet argument doit inclure à la fois un chemin d'accès (lettre de lecteur ou partage réseau) et un nom de fichier qui peut inclure un caractère générique. Un astérisque unique (*) peut être utilisé pour collecter plusieurs fichiers à partir d’un jeu de fichiers d’audit. Par exemple :

• \<path>\* - Collecter tous les fichiers d’audit à l’emplacement spécifié.

• <path>\LoginsAudit_{GUID}* - Collectez tous les fichiers d’audit qui ont le nom et la paire GUID spécifiés.

• <path>\LoginsAudit_{GUID}_00_29384.sqlaudit - Collecter un fichier d’audit spécifique.

Cet argument est utilisé pour spécifier une URL d’objet blob (y compris le point de terminaison de stockage et le conteneur). Bien qu’il ne prend pas en charge un caractère générique astérisque, vous pouvez utiliser un préfixe de nom de fichier partiel (blob) (au lieu du nom d’objet blob complet) pour collecter plusieurs fichiers (objets blob) qui commencent par ce préfixe. Par exemple :

• <Storage_endpoint>/<Container>/<ServerName>/<DatabaseName>/ - collecte tous les fichiers d’audit (objets blob) pour la base de données spécifique.

• <Storage_endpoint>/<Container>/<ServerName>/<DatabaseName>/<AuditName>/<CreationDate>/<FileName>.xel - collecte un fichier d’audit spécifique (objet blob).

Nécessite l’autorisation CONTROL SERVER.

Nécessite l’autorisation CONTROL DATABASE.

• Les administrateurs de serveur peuvent accéder aux journaux d’audit de toutes les bases de données sur le serveur.

• Les administrateurs non serveurs peuvent uniquement accéder aux journaux d’audit à partir de la base de données active.

• Les objets blob qui ne répondent pas aux critères ci-dessus sont ignorés (une liste d’objets blob ignorés s’affiche dans le message de sortie de requête). La fonction retourne des journaux uniquement à partir d’objets blob pour lesquels l’accès est autorisé.

Cet exemple lit à partir d'un fichier nommé \\serverName\Audit\HIPAA_AUDIT.sqlaudit.

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

Pour obtenir un exemple complet de création d’audit, consultez SQL Server Audit (moteur de base de données).

Cet exemple lit à partir d’un fichier nommé 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

Cet exemple lit le même fichier que précédemment, mais avec d’autres clauses T-SQL (TOPet ORDER BYWHERE clause pour le filtrage des enregistrements d’audit retournés par la fonction) :

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

Pour plus d’informations sur la configuration de l’audit Azure SQL Database, consultez Prise en main de l’audit SQL Database.