sys.fn_get_audit_file (Transact-SQL)

この引数には、パス (ドライブ文字またはネットワーク共有) とファイル名の両方を含める必要があります。ファイル名にはワイルドカードを使用できます。 1 つのアスタリスク (*) を使用して、監査ファイル セットから複数のファイルを収集できます。 次に例を示します。

• \<path>\* - 指定した場所にあるすべての監査ファイルを収集します。

• <path>\LoginsAudit_{GUID}* - 指定した名前と GUID のペアを持つすべての監査ファイルを収集します。

• <path>\LoginsAudit_{GUID}_00_29384.sqlaudit - 特定の監査ファイルを収集します。

この引数は、BLOB URL (ストレージ エンドポイントとコンテナーを含む) を指定するために使用されます。 アスタリスク ワイルドカードはサポートされていませんが、部分ファイル (BLOB) 名プレフィックス (完全な BLOB 名ではなく) を使用して、このプレフィックスで始まる複数のファイル (BLOB) を収集できます。 次に例を示します。

• <Storage_endpoint>/<Container>/<ServerName>/<DatabaseName>/ - 特定のデータベースのすべての監査ファイル (BLOB) を収集します。

• <Storage_endpoint>/<Container>/<ServerName>/<DatabaseName>/<AuditName>/<CreationDate>/<FileName>.xel - 特定の監査ファイル (BLOB) を収集します。

CONTROL SERVER アクセス許可が必要です。

CONTROL DATABASE アクセス許可が必要です。

• サーバー管理者は、サーバー上のすべてのデータベースの監査ログにアクセスできます。

• サーバー管理者以外は、現在のデータベースからの監査ログにのみアクセスできます。

• 上記の条件を満たしていない BLOB はスキップされます (スキップされた BLOB の一覧がクエリ出力メッセージに表示されます)。 この関数は、アクセスが許可されている BLOB からのみログを返します。

この例では、\\serverName\Audit\HIPAA_AUDIT.sqlaudit という名前のファイルから読み取ります。

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

監査を作成する方法の完全な例については、「SQL Server Audit (データベース エンジン)」を参照してください。

この例では、 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

この例では、前に示したのと同じファイルから読み取りますが、さらに多くの T-SQL 句 (TOP、 ORDER BY、および関数によって返される監査レコードをフィルター処理するための WHERE 句) を使用します。

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

Azure SQL Database 監査の設定の詳細については、「 Get Started with SQL Database auditing(SQL Database 監査の開始)!」を参照してください。