Composite Primary Keys for AI-Agent Datasets

[gregagi]

Content

• Title: Composite Primary Keys for AI-Agent Datasets
• Slug: /blog/composite-primary-key-ai-agents
• Target: composite primary key (590 US monthly volume, KD 0; refreshed 2026-08-06)
• Selected as the highest-priority unshipped candidate in the Rowset SEO content ledger.

Research

Primary sources include PostgreSQL constraint documentation, Django composite-primary-key documentation, RFC 3986, RFC 8785, and Rowset product documentation. The supporting brief records each important claim and its verification source.

The post contributes the original SCOPE identity contract: Scope, Components, Ownership, Percent-encode, and Evolution.

Side checks

• AI SEO: direct definition first, extractable answer blocks, clean heading hierarchy, explicit entity coverage, dated primary-source attribution, FAQ, and renderer-supported BlogPosting schema.
• Product-led SEO: connects multi-field identity to the Rowset single index column, by-index operations, retries, relationships, schema instructions, MCP/REST paths, and migration decisions. It explicitly avoids claiming native multi-column SQL key support.

Files changed

• One complete blog post and its research brief
• SEO content ledger, link inventory, and sync metadata
• Two contextual inbound links from existing Rowset posts
• Changelog entry

Validation

• Blog content parser: pass
• BlogPosting schema generation: pass
• Frontmatter validation: pass
• SEO word-count floor: pass (1,492 words)
• Composite-index collision/encoding examples: pass
• Internal links: new article has 2 inbound links and 9 internal links
• git diff --check: pass
• Host blog test suite: blocked because the local PostgreSQL service is unavailable (18 setup errors; connection refused). GitHub CI is the authoritative full test run.

[github-actions]

Review Gate Summary

All enabled ReviewGate review angles passed.

Confidence Score: 5/5

Review angle	Score	Findings
General	5/5	0
Adversarial	5/5	0

Runtime phase	Duration
Queue	0.00s
Startup	7.69s
Model review	19.72s
Publish	1.45s

Findings: 0 total, 0 blocking, 0 inline candidates
Notes: 3 note(s) in the JSON artifact.

No findings. Re-run ReviewGate if new commits land.

Important Files Changed

No files require special attention from this review.

Flowchart

flowchart TD
    A["Pull request update"] --> B["ReviewGate analyzes the latest commit"]
    B --> C["Model review stages"]
    C --> D["Structured JSON artifact"]
    D --> E["Confidence Score: 5/5"]
    D --> F["Canonical PR summary comment"]
    F --> G["Human or agent fixes findings"]
    E --> H["Status: passed"]

Loading

_{Reviews on this PR: 2 runs. Changed lines analyzed: 0. Total cost: $0.0040. Latest commit analyzed: b4adedf33f76199441074e3bd354e8b26344a1f2.}