Skip to content

feat(warehouse-sources): add catalog search aliases for connector alternate names - #70294

Merged
Gilbert09 merged 1 commit into
masterfrom
posthog-code/dwh-catalog-search-aliases
Jul 13, 2026
Merged

feat(warehouse-sources): add catalog search aliases for connector alternate names#70294
Gilbert09 merged 1 commit into
masterfrom
posthog-code/dwh-catalog-search-aliases

Conversation

@Gilbert09

Copy link
Copy Markdown
Member

Problem

Session-replay observations of real users in the data-warehouse new-source onboarding flow show people searching the connector catalog by an alternate name and finding nothing:

  • A user typed "fb" trying to reach Meta Ads. The catalog only knew the keywords facebook ads / instagram ads, so a short query like fb (and even bare facebook) didn't match, and the connector stayed hidden.
  • A user searched "sql" looking for a relational database source. Postgres only carried postgresql, MySQL had no keywords, and MSSQL only had sql server, so a bare sql query didn't reliably surface any of them.

The catalog already supports search aliases via each source's keywords list (indexed by the Fuse search alongside name/label/category) — the affected connectors were just missing the obvious ones.

Changes

Add the missing lowercase keyword aliases:

  • Meta Ads: facebook, instagram, fb
  • Postgres: sql
  • MySQL: sql, mariadb (the connector already handles MariaDB credentials)
  • MSSQL: sql, mssql

No search-plumbing change — these feed the existing keywords field.

How did you test this code?

The Python toolchain isn't bootstrapped in this sandbox, so I couldn't run the suite locally; CI will run it. The change is pure data — lowercase strings appended to existing keywords lists — which satisfies the existing format check in test_source_categories.py::test_source_keywords_are_a_list_of_strings (asserts every keyword is a lowercase string). Ruff check + format pass on all four files.

Docs update

No docs update needed.

🤖 Agent context

Autonomy: Fully autonomous

Authored by Claude Code (Opus 4.8) from Replay Vision observations of the data-warehouse onboarding flow. The friction ("users can't find a connector by the name they search") recurred across sessions; this is the self-contained, low-risk slice. Deeper themes (OAuth transient-error copy, Google Ads MCC-vs-client ID hinting) were left as recommendations since existing maintainer PRs already cover that ground.


Created with PostHog Code

… found by alternate names

Users browsing the new-source catalog search for connectors by an alternate
name and come up empty: "fb"/"facebook" doesn't surface Meta Ads (the search
only knew "facebook ads"/"instagram ads"), and "sql" doesn't surface the
relational database sources.

Add the missing lowercase keyword aliases to the affected source configs:
- Meta Ads: facebook, instagram, fb
- Postgres: sql
- MySQL: sql, mariadb (the connector already handles MariaDB)
- MSSQL: sql, mssql

These flow through the existing `keywords` field into the catalog's Fuse
search — no search-plumbing change needed.

Generated-By: PostHog Code
Task-Id: 39d9ec17-acb3-486d-ba03-e733fba10d18
@github-actions

Copy link
Copy Markdown
Contributor

Hey @Gilbert09! 👋

It looks like your git author email on this PR isn't your @posthog.com address (owerstom@gmail.com). Since you're on the PostHog team, it's worth pointing your local git author email at your @posthog.com address. Why it matters:

  • Consistent work identity in git history — internal tooling that attributes commits to team members keys off your @posthog.com address.
  • Keeps team contributions easy to tell apart from external community ones when scanning history.

You can fix it for this repo with:

git config user.email "you@posthog.com"

Or set it globally with git config --global user.email "you@posthog.com". No need to redo this PR — just a nudge for next time. 🙂

@pr-assigner-resolver-posthog
pr-assigner-resolver-posthog Bot requested a review from a team July 12, 2026 13:58
@greptile-apps

greptile-apps Bot commented Jul 12, 2026

Copy link
Copy Markdown
Contributor

Reviews (1): Last reviewed commit: "feat(warehouse-sources): add catalog sea..." | Re-trigger Greptile

@Gilbert09 Gilbert09 added the stamphog Request AI approval (no full review) label Jul 12, 2026 — with PostHog

@stamphog stamphog Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Purely additive search-keyword data change to the connector catalog, outside risky territory, by an owning-team author with strong familiarity; the sole reviewer concern was addressed and acknowledged.

  • Author wrote 100% of the modified lines and has 50 merged PRs in these paths (familiarity STRONG).
  • Gilbert09, greptile-apps[bot] reviewed the current head.
Gate mechanics and policy version
Gate Result
prerequisites all clear
deny-list no deny categories matched
size 7L, 4F substantive — within ceiling
tier T1-agent / T1b-small (7L, 4F, single-area, feat)
stamphog 2.0.0b3 .stamphog/policy.yml @ dc71029 · reviewed head 05a5df6

@trunk-io

trunk-io Bot commented Jul 12, 2026

Copy link
Copy Markdown

Static BadgeStatic BadgeStatic BadgeStatic Badge

View Full Report ↗︎Docs

@Gilbert09
Gilbert09 merged commit 819e9cb into master Jul 13, 2026
385 of 389 checks passed
@Gilbert09
Gilbert09 deleted the posthog-code/dwh-catalog-search-aliases branch July 13, 2026 10:00
@deployment-status-posthog

deployment-status-posthog Bot commented Jul 13, 2026

Copy link
Copy Markdown

Deploy status

Environment Status Deployed At Workflow
dev ✅ Deployed 2026-07-13 11:21 UTC Run
prod-us ✅ Deployed 2026-07-13 11:34 UTC Run
prod-eu ✅ Deployed 2026-07-13 11:36 UTC Run

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

stamphog Request AI approval (no full review)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant