ネットワーク アクセス イベントシステムテーブルリファレンス

Important

このシステム テーブルは パブリック プレビュー にあります。

ネットワーク アクセス イベント テーブルには、ネットワーク アクセスが拒否されたイベントが記録されます。 各行は、外部ドメインへのブロックされた送信要求や、制限された IP からの受信要求のブロックなど、個々のイベントを表します。 拡張されたネットワークトラフィックログでは、アウトバウンドテーブルは許可されたイベントも記録できます。

アウトバウンド ネットワーク アクセス イベントのシステムテーブルスキーマ

送信ネットワーク アクセス イベント テーブルには、ワークスペースから外部宛先への送信アクセスがエグレス ポリシーによって拒否されるイベントが記録されます。 たとえば、ユーザーがノートブックから "google.com" にアクセスしようとして失敗した場合、イベントはログに記録されます。

テーブル パス: このシステム テーブルは、 system.access.outbound_networkにあります。

列名 データの種類 Description Example
account_id 文字列 Databricks アカウントの ID 7af234db-66d7-4db3-bbf0-956098224879
workspace_id 文字列 イベントが発生したワークスペースの ID 1234567890123456
event_id 文字列 イベントの ID db52a413-7a0a-4d49-b742-7ae5f06bc4b2
destination_type 文字列 宛先の種類。 使用可能な値は、 DNS、 IP、および STORAGE DNS
destination 文字列 ブロックされた宛先の詳細。 宛先の種類に応じて、値はドメイン名、IP アドレス、またはストレージの場所になります。 google.com
dns_event 構造体 DNS 宛先に関する詳細。 DNS 宛先に対してのみ設定されます。それ以外の場合、フィールドは NULL。 { "domain_name":"google.com", "rcode": 3 }
storage_event 構造体 ストレージの宛先に関する詳細。 ストレージの宛先に対してのみ設定されます。それ以外の場合、フィールドは NULL。 { "hostname":"s3://some-bucket", "path": "/some-path", "rejection_reason": "storage-bucket-path-denied" }
event_time timestamp イベントが発生したときのタイムスタンプ 2024-05-01T01:01:01.123
access_type 文字列 発生したアクセス イベントの種類。 DROP
network_source_type 文字列 イベントが発生したワークスペース内で使用される特定の製品またはサービス。 DBSQL、 General Compute、 MLServing、 ML Build、 Apps

サンプル クエリ

次のサンプル クエリは、アカウントの拒否ログに関する分析情報を得るのに役立ちます。

特定の時間範囲の特定のワークスペースのすべての拒否ログを取得する

SELECT
    event_id, destination_type, destination, event_time
FROM
    system.access.outbound_network
WHERE
    event_time > '2025-09-25'
    AND event_time < '2025-09-26'
    AND account_id = :account_id
    AND workspace_id = :workspace_id;

特定のエラーの詳細を確認するには

SELECT
    storage_event.hostname, storage_event.path, storage_event.rejection_reason
FROM
    system.access.outbound_network AS storage_event
WHERE
    event_time > '2024-09-25'
    AND event_time < '2024-09-26'
    AND account_id = <id>
    AND workspace_id = <id>
    AND destination = 'storage path';

受信ネットワーク アクセス イベントのシステム テーブル スキーマ

受信ネットワーク アクセス イベント テーブルには、ワークスペースへの受信アクセスがイングレス ポリシーによって拒否されたイベントが記録されます。 たとえば、ユーザーがブロックされた IP アドレスからワークスペースに接続しようとすると、失敗した試行がログに記録されます。

テーブル パス: このシステム テーブルは、 system.access.inbound_networkにあります。

列名 データの種類 Description Example
account_id 文字列 Databricks アカウントの ID。 7af234db-66d7-4db3-bbf0-956098224879
workspace_id 文字列 イベントが発生したワークスペースの ID。 1234567890123456
event_id 文字列 イベントの ID。 db52a413-7a0a-4d49-b742-7ae5f06bc4b2
request_path 文字列 要求の宛先。 /compute
source 構造体 要求のソース。 IP、プライベート リンク、および関連する属性が含まれています。 { "ip": "10.0.0.1", "private-link": "some-pl-id" }
authenticated_as 文字列 リクエストの認証済み ID。 次のいずれかである必要があります。
  • <user>@<domain-name>
  • <sp-application-id>
  • グループ名
user@databricks.com
event_time timestamp イベントが発生したときのタイムスタンプ。 2024-05-01T01:01:01.123
policy_outcome 文字列 アクセスイベント結果のタイプ。 指定できる値は DENY または DENY_DRY_RUN です。 DENY
rule_label 文字列 要求を拒否したイングレス ルールを識別します。 block-external-ips

サンプル クエリ

次のサンプル クエリは、アカウント内のイングレス拒否ログを分析するのに役立ちます。

過去 2 時間に拒否されたすべての受信要求を取得する

SELECT *
FROM system.access.inbound_network
WHERE event_time >= current_timestamp() - interval 2 hour
ORDER BY event_time DESC;

拒否された要求をソース IP 別にカウントする

SELECT
    source.ip,
    COUNT(*) AS deny_count
FROM
    system.access.inbound_network
WHERE
    event_time >= '2025-09-01'
    AND event_time < '2025-09-02'
    AND account_id = <id>
    AND workspace_id = <id>
GROUP BY
    source.ip
ORDER BY
    deny_count DESC;

特定のエラーの詳細を確認するには

SELECT
    request_path,
    source.ip AS source_ip,
    authenticated_as,
    policy_outcome,
    rule_label
FROM
    system.access.inbound_network
WHERE
    event_time > '2025-09-01'
    AND event_time < '2025-09-02'
    AND account_id = <id>
    AND workspace_id = <id>
    AND request_path = '/compute';

拡張ネットワークトラフィックログ

拡張ネットワークトラフィックのログはプライベートプレビューにあります。 この機能は既存の拒否ログに加え、許可されたアウトバウンドネットワークアクセスイベントも system.access.outbound_network 拡張しています。

拡張ネットワークトラフィックログは、アウトバウンドトラフィックフローログ用の新しいシステムテーブルである system.access.outbound_trafficも導入します。 アウトバウンドトラフィックフローログはプライベートネットワークゲートウェイトラフィックのみをキャプチャします。

アクセスを要求するには、Azure Databricks アカウント チームにお問い合わせください。 詳細は 拡張ネットワークトラフィックログを参照してください。