監査ログ システム テーブル リファレンス

この記事では、監査ログ テーブル スキーマを概説し、監査ログ システム テーブルで使用できるサンプル クエリを提供して、アカウントの一般的な使用に関する質問に回答します。 監査ログ イベントの詳細については、「診断ログ リファレンス」を参照してください。

監査ログ システム テーブルは system.access.audit にあります。

監査ログに関する考慮事項

• ほとんどの監査ログは、ワークスペースのリージョンでのみ使用できます。
• Unity Catalog アカウント レベルのログのみすべてのリージョンで使用できます。
• アカウント レベルの監査ログは 0 として workspace_id に記録されます。

監査ログ システム テーブル スキーマ

監査ログ システム テーブルでは、次のスキーマが使用されます。

サンプル クエリ

次のセクションには、監査ログ システム テーブルに関する分析情報を得るために使用できるサンプル クエリが含まれています。 これらのクエリを機能させるには、中かっこ内の値を独自の {{}} パラメーターに置き換えます。

この記事には、次のクエリの例が含まれています。

• このテーブルにアクセスできるユーザーは誰ですか?
• 最終日にテーブルにアクセスしたユーザーはどれですか?
• ユーザーはどのテーブルにアクセスしましたか?
• セキュリティ保護可能なすべてのオブジェクトのアクセス許可の変更を表示する
• 最近実行したノートブック コマンドを表示する

このテーブルにアクセスできるユーザーは誰ですか?

このクエリでは information_schema を使用して、テーブルに対するアクセス許可を持つユーザーを調べます。

SELECT DISTINCT(grantee) AS `ACCESSIBLE BY`
FROM system.information_schema.table_privileges
WHERE table_schema = '{{schema_name}}' AND table_name = '{{table_name}}'
  UNION
    SELECT table_owner
    FROM system.information_schema.tables
    WHERE table_schema = '{{schema_name}}' AND table_name = '{{table}}'
  UNION
    SELECT DISTINCT(grantee)
    FROM system.information_schema.schema_privileges
    WHERE schema_name = '{{schema_name}}'

最終日にテーブルにアクセスしたユーザーはどれですか?

SELECT
  user_identity.email as `User`,
  IFNULL(request_params.full_name_arg,
    request_params.name)
    AS `Table`,
    action_name AS `Type of Access`,
    event_time AS `Time of Access`
FROM system.access.audit
WHERE (request_params.full_name_arg = '{{catalog.schema.table}}'
  OR (request_params.name = '{{table_name}}'
  AND request_params.schema_name = '{{schema_name}}'))
  AND action_name
    IN ('createTable','getTable','deleteTable')
  AND event_date > now() - interval '1 day'
ORDER BY event_date DESC

ユーザーはどのテーブルにアクセスしましたか?

SELECT
        action_name as `EVENT`,
        event_time as `WHEN`,
        IFNULL(request_params.full_name_arg, 'Non-specific') AS `TABLE ACCESSED`,
        IFNULL(request_params.commandText,'GET table') AS `QUERY TEXT`
FROM system.access.audit
WHERE user_identity.email = '{{User}}'
        AND action_name IN ('createTable',
'commandSubmit','getTable','deleteTable')
        -- AND datediff(now(), event_date) < 1
        -- ORDER BY event_date DESC

結果の例

セキュリティ保護可能なすべてのオブジェクトのアクセス許可の変更を表示する

このクエリは、アカウントで発生したすべてのアクセス許可の変更に対するイベントを返します。 クエリは、変更を行ったユーザー、セキュリティ保護可能なオブジェクトの種類と名前、および行われた特定の変更を返します。

SELECT event_time, user_identity.email, request_params.securable_type, request_params.securable_full_name, request_params.changes
FROM system.access.audit
WHERE service_name = 'unityCatalog'
  AND action_name = 'updatePermissions'
ORDER BY 1 DESC

最近実行したノートブック コマンドを表示する

このクエリは、最後に実行されたノートブック コマンドと、コマンドを実行したユーザーを返します。

SELECT event_time, user_identity.email, request_params.commandText
FROM system.access.audit
WHERE action_name = `runCommand`
ORDER BY event_time DESC
LIMIT 100