HelpDatabase Reference › DNA_KitSummary

DNA_KitSummary Table

The DNA_KitSummary table is a per-kit rollup of how much data has been gathered for each test kit. Each row holds the counts — matches, in-common-with relationships, chromosome segments, surnames, ancestors, and trees — for a single kit, along with when those counts were last refreshed. It lets the app display kit totals without re-counting the underlying detail tables every time.

Primary key: KitIdentifier is the primary key (a string), so there is exactly one summary row per kit. Refreshing a kit’s summary replaces its existing row.

Column Reference

ColumnTypeDescription
KitIdentifierstring (PK)The kit’s identifier (the kit GUID), uppercased. One summary row per kit.
CompanystringThe testing company the kit belongs to (for example A*, FTDNA, MyHeritage, 23andMe, Gedmatch).
KitNamestringDisplay name of the kit.
MatchCountintNumber of distinct matches gathered for the kit.
ICWCountintNumber of in-common-with (shared match) relationships gathered for the kit.
ChromosomeCountintNumber of chromosome/segment rows gathered for the kit.
SurnameCountintNumber of distinct surnames found in the kit’s match trees.
AncestorCountintNumber of distinct tree individuals (ancestors) found across the kit’s match trees.
TreeCountintNumber of match trees associated with the kit.
LastUpdatedstringTimestamp of when the summary was last recomputed.

How It’s Populated

The summary is recomputed by a single routine that runs per kit. It executes company-specific aggregate queries over the underlying match, ICW, chromosome, and tree tables, then writes the result with an insert-or-replace so the kit’s single row is refreshed in place. LastUpdated is set to the current time at each refresh.

Some consumers read only kits that already have meaningful data — for example, lookups that filter to rows where MatchCount and ICWCount are both greater than zero.

Related Tables

  • DNA_Kits — the kit registry the summary is keyed against; its kit GUID corresponds to KitIdentifier.
  • Per-service match / ICW / chromosome / tree tables — the detail tables the counts are aggregated from (for example, the A* and FTDNA match, ICW, chromosome, and tree tables).