Skip to content

Clarify Switchback subentity setup is on Assignment SQL, not FactSQL#728

Open
bertilhatt wants to merge 1 commit into
mainfrom
docs/clarify-switchback-factsql-subentity
Open

Clarify Switchback subentity setup is on Assignment SQL, not FactSQL#728
bertilhatt wants to merge 1 commit into
mainfrom
docs/clarify-switchback-factsql-subentity

Conversation

@bertilhatt

@bertilhatt bertilhatt commented Jun 11, 2026

Copy link
Copy Markdown
Contributor

Summary

The Switchback docs' Updates to FactSQL section told users to "click edit and add a new subentity that corresponds to the Switchback entity" on the FactSQL page. That control does not exist on Fact SQL — it caused confusion for a customer setting up a switchback who could not find any way to "add a subentity to the fact."

Validated against the backend code (eppo repo):

  • Subentities are a property of the Assignment SQL (assignment_source_subentities, surfaced in the UI via Add Subentities, gated behind the clustered-analysis flag). There is no subentity control on Fact SQL.
  • For switchback/clustered analysis, facts join to assignments on fact.subject = assignment.subentity (getSubjectSelectTermsassignmentJoinColumn = 'subentity' in unified-blocks.ts). The fact's subject is just a normal entity column (metricEventEntity.entityColumnName).
  • So the real requirement is: the Fact SQL must expose an entity column for the analysis entity (the subentity, e.g. users), and metrics are defined on that subentity — not on the cluster/switchback entity. This matches the existing "you do not need to make changes to metrics" note.

Changes

  • Add a Configure the analysis entity (subentity) subsection explaining that the subentity is configured on the Assignment SQL via Add Subentities (with a note that it's part of clustered analysis and may be flag-gated).
  • Rewrite Updates to FactSQL to state the actual requirement: the Fact SQL must surface the analysis entity column (added like any other entity), with no per-fact "subentity" step.

Test plan

  • Docs preview renders the two subsections correctly under "Configure Switchback assignments".

The "Updates to FactSQL" section instructed users to "add a new subentity"
on the FactSQL page, but subentities are configured on the Assignment SQL
(via "Add Subentities", part of clustered analysis). FactSQL only needs to
expose the analysis entity column so events join to switchback assignments.

Co-authored-by: Cursor <cursoragent@cursor.com>
@netlify

netlify Bot commented Jun 11, 2026

Copy link
Copy Markdown

Deploy Preview for eppo-data-docs ready!

Name Link
🔨 Latest commit ed6834f
🔍 Latest deploy log https://app.netlify.com/projects/eppo-data-docs/deploys/6a2a7be5be388c0008b4bd86
😎 Deploy Preview https://deploy-preview-728--eppo-data-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant