{
  "schema": "vedokrok.public-item.v1",
  "release_id": "VEDOKROK-SEL-5d86e1b23401e578",
  "url": "/knowledge/count-rows-and-non-null-values-separately",
  "id": "MHC-D-RESEARCH-9728",
  "version": "0.1.0",
  "title": "Count rows and non-null values separately",
  "summary": "A row can exist even when the invoice does not.",
  "kind": "principle",
  "body": "COUNT(*) counts input rows; COUNT(invoice.id) skips rows where that ID is NULL. A LEFT JOIN can retain a supplier through a row with NULL invoice values, so a row count is not automatically an invoice count. Choose the count that answers the report's question.",
  "limits": [
    "Empty strings and whitespace are not SQL NULL automatically. Repeated values are counted again; define missingness and row meaning before interpreting the gap."
  ],
  "topics": [
    "critical-thinking"
  ],
  "intents": [],
  "source_ids": [
    "pg-agg",
    "pg-joins"
  ],
  "evidence": [
    {
      "claim": "COUNT(*) counts rows while COUNT(expression) counts only input rows with a non-null expression.",
      "source_id": "pg-agg",
      "role": "supports",
      "note": "Claim limit: Scalar expression counting in PostgreSQL 18. These are counts of input rows, not automatically distinct entities or valid field values; join and filter rules determine the input. No planner or performance guarantee.\nSource reading history: selected_passages; 2026-10-11; Section 9.21, Table 9.62: count and sum; paragraph on aggregates with no selected rows. PostgreSQL 18 count and sum definitions, including empty-input behavior, rechecked on 2026-10-11. Selected passages ground the row/value/total distinction, not production execution or the effectiveness of the drafted reporting workflow.\nAgent release review: PostgreSQL 18 table expressions, NULL comparisons and aggregates, the UK Government Data Quality Framework and Microsoft Power Query profiling documentation were checked at the cited sections. The original examples and scope limits remain attached.",
      "locator": "Section 9.21 Aggregate Functions, count"
    },
    {
      "claim": "In PostgreSQL, LEFT JOIN adds a row with NULL right-hand values when no pair satisfies ON. A later WHERE condition keeps only rows for which it is true; a right-hand equality test rejects these NULL rows, while a NULL-accepting condition can retain them.",
      "source_id": "pg-joins",
      "role": "supports",
      "note": "Claim limit: PostgreSQL 18 logical row semantics, not a planner or performance guarantee. A NULL-accepting WHERE condition does not recreate rows already lost because their key matched only nonqualifying right-hand records.\nSource reading history: selected_passages; 2026-10-11; Sections 7.2.1.1 Joined Tables; 7.2.1.3 Subqueries; 7.2.2 WHERE; 7.2.3 GROUP BY. Version 18 passages rechecked on 2026-10-11: matching row pairs, full ON conditions, derived tables, filtering and grouping. Grounds SQL semantics, not every engine's behavior or the effectiveness of the drafted reporting workflow.\nAgent release review: PostgreSQL 18 table expressions, NULL comparisons and aggregates, the UK Government Data Quality Framework and Microsoft Power Query profiling documentation were checked at the cited sections. The original examples and scope limits remain attached.",
      "locator": "Section 7.2.1.1 LEFT OUTER JOIN and ON-versus-WHERE example; Section 7.2.2 WHERE"
    }
  ],
  "use_when": [
    "You need to count invoices or check whether a field is filled."
  ],
  "avoid_when": [
    "Empty strings and whitespace are not SQL NULL automatically. Repeated values are counted again; define missingness and row meaning before interpreting the gap."
  ],
  "steps": [
    "Calculate both counts for the same filters and groups; include a known case with no match.",
    "Use a field that cannot be NULL in a real invoice when counting matched invoices."
  ],
  "example": "A supplier with no matching invoice gets COUNT(*) = 1 and COUNT(invoice.id) = 0 in its group after a LEFT JOIN.",
  "check": "For each total, name what is counted: result rows or rows with a non-null field. Neither count alone proves a distinct entity total.",
  "published_at": "2026-11-12T18:37:40Z",
  "review": {
    "kind": "agent",
    "label": "Agent editorial and scoped source review",
    "reviewed_at": "2026-11-12T18:37:40Z"
  },
  "knowledge_origin": {
    "release_id": "MHC-RPUB-20261112-20287590",
    "corpus_commit": "20287590ddd3999b7492df232822b6a0f7d114b1",
    "manifest_sha256": "2a987660d12de0ce2bde77a421424f7762af1ff77872ef41093fecc33db74a95",
    "projection_sha256": "2807da39bbe6a3dee2db32a76675ac5185f5a33e8b0a5cdd0c22a4731f3378a0",
    "published_at": "2026-11-12T18:37:40Z"
  },
  "editorial_overlay": null,
  "editorial": null,
  "notices": [],
  "sources": [
    {
      "id": "pg-agg",
      "title": "PostgreSQL 18: Aggregate Functions",
      "url": "https://www.postgresql.org/docs/18/functions-aggregate.html"
    },
    {
      "id": "pg-joins",
      "title": "PostgreSQL 18: Table Expressions",
      "url": "https://www.postgresql.org/docs/18/queries-table-expressions.html"
    }
  ],
  "relations": [],
  "collections": [
    {
      "id": "RC-MHC-UNION-DATA-JOINS-QUALITY-DIAGNOSTICS-2026",
      "title": "Diagnose data joins and quality before trusting a report",
      "url": "/collections/diagnose-data-joins-and-quality-before-trusting-a-report"
    }
  ],
  "topic_hubs": [
    {
      "id": "critical-thinking",
      "title": "Critical thinking and evidence",
      "url": "/topics/critical-thinking"
    }
  ],
  "solution_packs": []
}
