{
  "license": "CC BY 4.0",
  "recipe": {
    "slug": "database-query-time-impact",
    "title": "Rank Database Queries by Total Time Impact",
    "testedWith": "Apache DataFusion 45.2.0",
    "lastReviewed": "2026-07-28"
  },
  "contract": {
    "tableName": "database_query_events",
    "schema": [
      {
        "name": "timestamp_utc",
        "type": "Timestamp",
        "description": "Query completion time."
      },
      {
        "name": "database_system",
        "type": "Utf8",
        "description": "Database system name."
      },
      {
        "name": "operation_name",
        "type": "Utf8",
        "description": "SELECT, INSERT, or another controlled operation."
      },
      {
        "name": "query_fingerprint",
        "type": "Utf8",
        "description": "Normalized statement shape without values."
      },
      {
        "name": "duration_ms",
        "type": "Float64",
        "description": "Application-observed query duration."
      },
      {
        "name": "request_id",
        "type": "Utf8",
        "description": "Safe parent request identifier."
      }
    ]
  },
  "query": "SELECT\n  database_system,\n  operation_name,\n  query_fingerprint,\n  COUNT(*) AS calls,\n  SUM(duration_ms) AS total_time_ms,\n  approx_percentile_cont(duration_ms, 0.95) AS p95_duration_ms,\n  COUNT(DISTINCT request_id) AS affected_requests\nFROM database_query_events\nWHERE timestamp_utc >= now() - INTERVAL '24 hours'\nGROUP BY database_system, operation_name, query_fingerprint\nORDER BY total_time_ms DESC\nLIMIT 20;",
  "fixtureKind": "schema-example",
  "inputRows": [
    {
      "timestamp_utc": "2026-07-28T10:00:00Z",
      "database_system": "database_system_example_1",
      "operation_name": "operation_name_example_1",
      "query_fingerprint": "query_fingerprint_example_1",
      "duration_ms": 12,
      "request_id": "request_id_example_1"
    },
    {
      "timestamp_utc": "2026-07-28T11:00:00Z",
      "database_system": "database_system_example_2",
      "operation_name": "operation_name_example_2",
      "query_fingerprint": "query_fingerprint_example_2",
      "duration_ms": 37,
      "request_id": "request_id_example_2"
    },
    {
      "timestamp_utc": "2026-07-28T12:00:00Z",
      "database_system": "database_system_example_3",
      "operation_name": "operation_name_example_3",
      "query_fingerprint": "query_fingerprint_example_3",
      "duration_ms": 24,
      "request_id": "request_id_example_3"
    }
  ],
  "illustrativeInputRows": [
    {
      "timestamp_utc": "2026-07-28T10:00:00Z",
      "database_system": "database_system_example_1",
      "operation_name": "operation_name_example_1",
      "query_fingerprint": "query_fingerprint_example_1",
      "duration_ms": 12,
      "request_id": "request_id_example_1"
    },
    {
      "timestamp_utc": "2026-07-28T11:00:00Z",
      "database_system": "database_system_example_2",
      "operation_name": "operation_name_example_2",
      "query_fingerprint": "query_fingerprint_example_2",
      "duration_ms": 37,
      "request_id": "request_id_example_2"
    },
    {
      "timestamp_utc": "2026-07-28T12:00:00Z",
      "database_system": "database_system_example_3",
      "operation_name": "operation_name_example_3",
      "query_fingerprint": "query_fingerprint_example_3",
      "duration_ms": 24,
      "request_id": "request_id_example_3"
    }
  ],
  "expectedOutput": {
    "columns": [
      "database_system",
      "operation_name",
      "query_fingerprint",
      "calls",
      "total_time_ms",
      "p95_duration_ms",
      "affected_requests"
    ],
    "rows": [
      {
        "database_system": "postgresql",
        "operation_name": "SELECT",
        "query_fingerprint": "project-list-v4",
        "calls": 18400,
        "total_time_ms": 1288000,
        "p95_duration_ms": 142,
        "affected_requests": 9200
      },
      {
        "database_system": "postgresql",
        "operation_name": "SELECT",
        "query_fingerprint": "monthly-report-v2",
        "calls": 420,
        "total_time_ms": 924000,
        "p95_duration_ms": 4180,
        "affected_requests": 410
      }
    ]
  },
  "notes": [
    "The compact input rows demonstrate field names and JSON types; they are not claimed to generate the displayed aggregate by themselves.",
    "The expected output is deterministic synthetic review data for the documented output shape.",
    "Adapt time windows, thresholds, identities, and business definitions before operational use."
  ]
}