Audit Events

Appearance

クエリジョブ ​

クエリジョブは、コネクション経由で SQL を実行する際に作成されるジョブです。 ノートブックなどから SQL を実行する度に作成され、実行結果の取得やエクスポートに利用されます。

どの経路から実行されたかは context に入ります （query_job.create のサンプルを参照）。

イベント一覧 ​

イベントリソース説明
query_job.createquery_jobクエリジョブが作成された
query_job.get_resultquery_jobクエリジョブの結果が取得された
query_job.start_exportquery_jobクエリ結果のエクスポートが開始された
query_job.get_download_urlquery_jobエクスポート結果のダウンロード URL が取得された
query_job.cancelquery_jobクエリジョブがキャンセルされた

イベント詳細 ​

query_job.create プレビュー ​

記録期間: 2026-09-15 〜

クエリジョブの作成を記録します。

フィールド値
event.codequery_job.create
scope.typeworkspace
resource.typequery_job
references（なし）
query実行した SQL
outbound（なし）
change（なし）
grant（なし）
extra（なし）

query ​

実行を要求した SQL が入ります。結果取得（query_job.get_result）には取得範囲のみが入り、SQL 本文は入りません。

サンプル ​

保存済クエリからの実行 ​
json
{
  "event": {
    "code": "query_job.create",
    ...
  },
  "scope": {
    "type": "workspace",
    ...
  },
  "resource": {
    "type": "query_job",
    "uid": "job_0193fa2c",
    "name": null,
    "path": "connection/63e1be654aa70ad689601bef/query_job/job_0193fa2c",
    "parts": [
      {
        "type": "connection",
        "uid": "63e1be654aa70ad689601bef",
        "name": "BigQuery Prod"
      },
      {
        "type": "query_job",
        "uid": "job_0193fa2c",
        "name": null
      }
    ],
    ...
  },
  "query": {
    "type": "sql",
    "text": "SELECT 1"
  },
  ...
}
ノートブックの編集画面からの実行 ​

どのノートブック・どのページからの実行かは context.notebook から辿れます。

json
{
  "event": {
    "code": "query_job.create",
    ...
  },
  "scope": {
    "type": "workspace",
    ...
  },
  "resource": {
    "type": "query_job",
    "uid": "job_0193fa2c",
    "name": null,
    "path": "connection/63e1be654aa70ad689601bef/query_job/job_0193fa2c",
    "parts": [
      {
        "type": "connection",
        "uid": "63e1be654aa70ad689601bef",
        "name": "BigQuery Prod"
      },
      {
        "type": "query_job",
        "uid": "job_0193fa2c",
        "name": null
      }
    ],
    ...
  },
  "context": {
    "notebook": {
      "notebook": {
        "type": "notebook",
        "uid": "63e1be654aa70ad689601bf3",
        "name": "Sales KPI"
      },
      "page": {
        "type": "notebook_page",
        "uid": "671ecbbf2990c63fea3b3a26",
        "name": "Overview"
      }
    }
  },
  "query": {
    "type": "sql",
    "text": "SELECT 1"
  },
  ...
}
レポートの閲覧中の実行 ​

どのレポート・どのページからの実行かは context.report から辿れます。

json
{
  "event": {
    "code": "query_job.create",
    ...
  },
  "scope": {
    "type": "workspace",
    ...
  },
  "resource": {
    "type": "query_job",
    "uid": "job_0193fa2c",
    "name": null,
    "path": "connection/63e1be654aa70ad689601bef/query_job/job_0193fa2c",
    "parts": [
      {
        "type": "connection",
        "uid": "63e1be654aa70ad689601bef",
        "name": "BigQuery Prod"
      },
      {
        "type": "query_job",
        "uid": "job_0193fa2c",
        "name": null
      }
    ],
    ...
  },
  "context": {
    "report": {
      "report": {
        "type": "report",
        "uid": "63e1be654aa70ad689601bf5",
        "name": "Weekly Dashboard"
      },
      "notebook": {
        "type": "notebook",
        "uid": "63e1be654aa70ad689601bf3",
        "name": "Sales KPI"
      },
      "page": {
        "type": "notebook_page",
        "uid": "671ecbbf2990c63fea3b3a26",
        "name": "Overview"
      }
    }
  },
  "query": {
    "type": "sql",
    "text": "SELECT 1"
  },
  ...
}
署名付き埋め込みの閲覧中の実行 ​

actor は APIキーになります。どの埋め込みの誰による操作かは context.signed_embed から補えます。

json
{
  "event": {
    "code": "query_job.create",
    ...
  },
  "scope": {
    "type": "workspace",
    ...
  },
  "resource": {
    "type": "query_job",
    "uid": "job_0193fa2c",
    "name": null,
    "path": "connection/63e1be654aa70ad689601bef/query_job/job_0193fa2c",
    "parts": [
      {
        "type": "connection",
        "uid": "63e1be654aa70ad689601bef",
        "name": "BigQuery Prod"
      },
      {
        "type": "query_job",
        "uid": "job_0193fa2c",
        "name": null
      }
    ],
    ...
  },
  "context": {
    "signed_embed": {
      "signed_embed": {
        "type": "signed_embed",
        "uid": "671e4c2f9a1b3d0012ab34cd",
        "name": "Partner Embed"
      },
      "notebook": {
        "type": "notebook",
        "uid": "63e1be654aa70ad689601bf3",
        "name": "Sales KPI"
      },
      "page": {
        "type": "notebook_page",
        "uid": "671ecbbf2990c63fea3b3a26",
        "name": "Overview"
      },
      "token_user_id": "user:1234567890"
    }
  },
  "query": {
    "type": "sql",
    "text": "SELECT 1"
  },
  ...
}
ワークフローのスケジュール実行からの実行 ​

actor はワークフローになります。どのワークフローのどの実行・ステップからの操作かは context.workflow から補えます。スケジュール実行では起動したユーザーは入りません。

json
{
  "event": {
    "code": "query_job.create",
    ...
  },
  "scope": {
    "type": "workspace",
    ...
  },
  "resource": {
    "type": "query_job",
    "uid": "job_0193fa2c",
    "name": null,
    "path": "connection/63e1be654aa70ad689601bef/query_job/job_0193fa2c",
    "parts": [
      {
        "type": "connection",
        "uid": "63e1be654aa70ad689601bef",
        "name": "BigQuery Prod"
      },
      {
        "type": "query_job",
        "uid": "job_0193fa2c",
        "name": null
      }
    ],
    ...
  },
  "context": {
    "workflow": {
      "workflow": {
        "type": "workflow",
        "uid": "63e1be654aa70ad689601bf8",
        "name": "Nightly Refresh"
      },
      "workflow_job": {
        "type": "workflow_job",
        "uid": "wjob_01"
      },
      "step": {
        "type": "workflow_step",
        "uid": "runQuery_1"
      }
    }
  },
  "query": {
    "type": "sql",
    "text": "SELECT 1"
  },
  ...
}
ワークフローの「今すぐ実行」からの実行 ​

actor はワークフローになります。起動したユーザーは context.workflow.triggered_by から補えます。

json
{
  "event": {
    "code": "query_job.create",
    ...
  },
  "scope": {
    "type": "workspace",
    ...
  },
  "resource": {
    "type": "query_job",
    "uid": "job_0193fa2c",
    "name": null,
    "path": "connection/63e1be654aa70ad689601bef/query_job/job_0193fa2c",
    "parts": [
      {
        "type": "connection",
        "uid": "63e1be654aa70ad689601bef",
        "name": "BigQuery Prod"
      },
      {
        "type": "query_job",
        "uid": "job_0193fa2c",
        "name": null
      }
    ],
    ...
  },
  "context": {
    "workflow": {
      "workflow": {
        "type": "workflow",
        "uid": "63e1be654aa70ad689601bf8",
        "name": "Nightly Refresh"
      },
      "workflow_job": {
        "type": "workflow_job",
        "uid": "wjob_01"
      },
      "step": {
        "type": "workflow_step",
        "uid": "runQuery_1"
      },
      "triggered_by": {
        "type": "user",
        "uid": "63e1be654aa70ad689601bec",
        "email_addr": "taro@example.com"
      }
    }
  },
  "query": {
    "type": "sql",
    "text": "SELECT 1"
  },
  ...
}
ワークフローの runReport ステップからの実行 ​

actor はワークフロー。context.workflow と context.report を併記します。

json
{
  "event": {
    "code": "query_job.create",
    ...
  },
  "scope": {
    "type": "workspace",
    ...
  },
  "resource": {
    "type": "query_job",
    "uid": "job_0193fa2c",
    "name": null,
    "path": "connection/63e1be654aa70ad689601bef/query_job/job_0193fa2c",
    "parts": [
      {
        "type": "connection",
        "uid": "63e1be654aa70ad689601bef",
        "name": "BigQuery Prod"
      },
      {
        "type": "query_job",
        "uid": "job_0193fa2c",
        "name": null
      }
    ],
    ...
  },
  "context": {
    "report": {
      "report": {
        "type": "report",
        "uid": "63e1be654aa70ad689601bf5",
        "name": "Weekly Dashboard"
      },
      "notebook": {
        "type": "notebook",
        "uid": "63e1be654aa70ad689601bf3",
        "name": "Sales KPI"
      },
      "page": {
        "type": "notebook_page",
        "uid": "671ecbbf2990c63fea3b3a26",
        "name": "Overview"
      }
    },
    "workflow": {
      "workflow": {
        "type": "workflow",
        "uid": "63e1be654aa70ad689601bf8",
        "name": "Nightly Refresh"
      },
      "workflow_job": {
        "type": "workflow_job",
        "uid": "wjob_01"
      },
      "step": {
        "type": "workflow_step",
        "uid": "runReport_1"
      }
    }
  },
  "query": {
    "type": "sql",
    "text": "SELECT 1"
  },
  ...
}
AIエージェントのツールによる実行 ​

どのセッションのどのツールからの実行かは context.ai_agent から辿れます。

json
{
  "event": {
    "code": "query_job.create",
    ...
  },
  "scope": {
    "type": "workspace",
    ...
  },
  "resource": {
    "type": "query_job",
    "uid": "job_0193fa2c",
    "name": null,
    "path": "connection/63e1be654aa70ad689601bef/query_job/job_0193fa2c",
    "parts": [
      {
        "type": "connection",
        "uid": "63e1be654aa70ad689601bef",
        "name": "BigQuery Prod"
      },
      {
        "type": "query_job",
        "uid": "job_0193fa2c",
        "name": null
      }
    ],
    ...
  },
  "context": {
    "ai_agent": {
      "ai_profile": {
        "type": "ai_profile",
        "uid": "63e1be654aa70ad689601c10",
        "name": "Default"
      },
      "session": {
        "type": "agent_session",
        "uid": "63e1be654aa70ad689601c01",
        "name": "Weekly sales analysis"
      },
      "tool": "run_sql"
    }
  },
  "query": {
    "type": "sql",
    "text": "SELECT 1"
  },
  ...
}
MCPクライアントからの直接実行 ​

AIエージェントセッションを経由しないため、ai_agent は付きません。

json
{
  "event": {
    "code": "query_job.create",
    ...
  },
  "scope": {
    "type": "workspace",
    ...
  },
  "resource": {
    "type": "query_job",
    "uid": "job_0193fa2c",
    "name": null,
    "path": "connection/63e1be654aa70ad689601bef/query_job/job_0193fa2c",
    "parts": [
      {
        "type": "connection",
        "uid": "63e1be654aa70ad689601bef",
        "name": "BigQuery Prod"
      },
      {
        "type": "query_job",
        "uid": "job_0193fa2c",
        "name": null
      }
    ],
    ...
  },
  "context": {
    "mcp": {
      "client": {
        "type": "mcp_client",
        "uid": "cursor-dcr-01",
        "name": "Cursor"
      },
      "oauth_session": {
        "type": "mcp_oauth_session",
        "uid": "oauth_sess_01"
      },
      "scopes": [
        "sql:execute",
        "support:read"
      ]
    }
  },
  "query": {
    "type": "sql",
    "text": "SELECT 1"
  },
  ...
}
MCPクライアントから起動したAIエージェントによる実行 ​

実行経路とMCP接続の両方を記録するため、ai_agent と mcp が並びます。

json
{
  "event": {
    "code": "query_job.create",
    ...
  },
  "scope": {
    "type": "workspace",
    ...
  },
  "resource": {
    "type": "query_job",
    "uid": "job_0193fa2c",
    "name": null,
    "path": "connection/63e1be654aa70ad689601bef/query_job/job_0193fa2c",
    "parts": [
      {
        "type": "connection",
        "uid": "63e1be654aa70ad689601bef",
        "name": "BigQuery Prod"
      },
      {
        "type": "query_job",
        "uid": "job_0193fa2c",
        "name": null
      }
    ],
    ...
  },
  "context": {
    "ai_agent": {
      "ai_profile": {
        "type": "ai_profile",
        "uid": "63e1be654aa70ad689601c10",
        "name": "Default"
      },
      "session": {
        "type": "agent_session",
        "uid": "63e1be654aa70ad689601c01",
        "name": "Weekly sales analysis"
      },
      "tool": "run_sql"
    },
    "mcp": {
      "client": {
        "type": "mcp_client",
        "uid": "cursor-dcr-01",
        "name": "Cursor"
      },
      "oauth_session": {
        "type": "mcp_oauth_session",
        "uid": "oauth_sess_01"
      },
      "scopes": [
        "agent:execute"
      ]
    }
  },
  "query": {
    "type": "sql",
    "text": "SELECT 1"
  },
  ...
}

query_job.get_result プレビュー ​

記録期間: 2026-09-15 〜

クエリジョブの結果取得を記録します。

フィールド値
event.codequery_job.get_result
scope.typeworkspace
resource.typequery_job
references（なし）
query結果取得の範囲
outbound（なし）
change（なし）
grant（なし）
extra（なし）

query ​

ジョブ結果をどの範囲で取り出したかが入ります。SQL 本文は付きません。

サンプル ​

基本的な結果取得 ​
json
{
  "event": {
    "code": "query_job.get_result",
    ...
  },
  "scope": {
    "type": "workspace",
    ...
  },
  "resource": {
    "type": "query_job",
    "uid": "job_0193fa2c",
    "name": null,
    "path": "connection/63e1be654aa70ad689601bef/query_job/job_0193fa2c",
    "parts": [
      {
        "type": "connection",
        "uid": "63e1be654aa70ad689601bef",
        "name": "BigQuery Prod"
      },
      {
        "type": "query_job",
        "uid": "job_0193fa2c",
        "name": null
      }
    ],
    ...
  },
  "query": {
    "type": "job_result",
    "limit": 1000
  },
  ...
}
ワークフローの runReport ステップからの結果取得 ​

context.workflow と context.report を併記します。

json
{
  "event": {
    "code": "query_job.get_result",
    ...
  },
  "scope": {
    "type": "workspace",
    ...
  },
  "resource": {
    "type": "query_job",
    "uid": "job_0193fa2c",
    "name": null,
    "path": "connection/63e1be654aa70ad689601bef/query_job/job_0193fa2c",
    "parts": [
      {
        "type": "connection",
        "uid": "63e1be654aa70ad689601bef",
        "name": "BigQuery Prod"
      },
      {
        "type": "query_job",
        "uid": "job_0193fa2c",
        "name": null
      }
    ],
    ...
  },
  "context": {
    "report": {
      "report": {
        "type": "report",
        "uid": "63e1be654aa70ad689601bf5",
        "name": "Weekly Dashboard"
      },
      "notebook": {
        "type": "notebook",
        "uid": "63e1be654aa70ad689601bf3",
        "name": "Sales KPI"
      },
      "page": {
        "type": "notebook_page",
        "uid": "671ecbbf2990c63fea3b3a26",
        "name": "Overview"
      }
    },
    "workflow": {
      "workflow": {
        "type": "workflow",
        "uid": "63e1be654aa70ad689601bf8",
        "name": "Nightly Refresh"
      },
      "workflow_job": {
        "type": "workflow_job",
        "uid": "wjob_01"
      },
      "step": {
        "type": "workflow_step",
        "uid": "runReport_1"
      }
    }
  },
  "query": {
    "type": "job_result",
    "limit": 1000
  },
  ...
}

query_job.start_export プレビュー ​

記録期間: 2026-09-15 〜

クエリ結果のエクスポート開始を記録します。

フィールド値
event.codequery_job.start_export
scope.typeworkspace
resource.typequery_job
references（なし）
query（なし）
outbound（なし）
change（なし）
grant（なし）
extra（なし）

サンプル ​

json
{
  "event": {
    "code": "query_job.start_export",
    ...
  },
  "scope": {
    "type": "workspace",
    ...
  },
  "resource": {
    "type": "query_job",
    "uid": "job_0193fa2c",
    "name": null,
    "path": "connection/63e1be654aa70ad689601bef/query_job/job_0193fa2c",
    "parts": [
      {
        "type": "connection",
        "uid": "63e1be654aa70ad689601bef",
        "name": "BigQuery Prod"
      },
      {
        "type": "query_job",
        "uid": "job_0193fa2c",
        "name": null
      }
    ],
    ...
  },
  ...
}

query_job.get_download_url プレビュー ​

記録期間: 2026-09-15 〜

エクスポート結果のダウンロード URL の取得を記録します。

フィールド値
event.codequery_job.get_download_url
scope.typeworkspace
resource.typequery_job
references（なし）
query（なし）
outbound（なし）
change（なし）
grant（なし）
extra（なし）

サンプル ​

json
{
  "event": {
    "code": "query_job.get_download_url",
    ...
  },
  "scope": {
    "type": "workspace",
    ...
  },
  "resource": {
    "type": "query_job",
    "uid": "job_0193fa2c",
    "name": null,
    "path": "connection/63e1be654aa70ad689601bef/query_job/job_0193fa2c",
    "parts": [
      {
        "type": "connection",
        "uid": "63e1be654aa70ad689601bef",
        "name": "BigQuery Prod"
      },
      {
        "type": "query_job",
        "uid": "job_0193fa2c",
        "name": null
      }
    ],
    ...
  },
  ...
}

query_job.cancel プレビュー ​

記録期間: 2026-09-15 〜

クエリジョブのキャンセルを記録します。

フィールド値
event.codequery_job.cancel
scope.typeworkspace
resource.typequery_job
references（なし）
query（なし）
outbound（なし）
change（なし）
grant（なし）
extra（なし）

サンプル ​

json
{
  "event": {
    "code": "query_job.cancel",
    ...
  },
  "scope": {
    "type": "workspace",
    ...
  },
  "resource": {
    "type": "query_job",
    "uid": "job_0193fa2c",
    "name": null,
    "path": "connection/63e1be654aa70ad689601bef/query_job/job_0193fa2c",
    "parts": [
      {
        "type": "connection",
        "uid": "63e1be654aa70ad689601bef",
        "name": "BigQuery Prod"
      },
      {
        "type": "query_job",
        "uid": "job_0193fa2c",
        "name": null
      }
    ],
    ...
  },
  ...
}

Codatum Audit Events 監査ログイベントカタログ

© Codatum Inc.