Skip to content

docs: Add column selection documentation for MySQL, MSSQL, BigQuery, Snowflake, and Redshift sources#17123

Open
inkeep[bot] wants to merge 5 commits into
masterfrom
docs-writer-ai-update-2026-05-29T13-06-54-504Z-ta9945
Open

docs: Add column selection documentation for MySQL, MSSQL, BigQuery, Snowflake, and Redshift sources#17123
inkeep[bot] wants to merge 5 commits into
masterfrom
docs-writer-ai-update-2026-05-29T13-06-54-504Z-ta9945

Conversation

@inkeep
Copy link
Copy Markdown
Contributor

@inkeep inkeep Bot commented May 29, 2026

Changes

This PR adds documentation for the column selection feature that was extended to MySQL, MSSQL, BigQuery, Snowflake, and Redshift sources in PostHog/posthog#60155.

Previously, per-column sync selection was only available for Postgres. Now all SQL sources support this feature, allowing users to:

  • Select specific columns to sync rather than syncing all columns (SELECT *)
  • Reduce sync cost on wide tables
  • Exclude PII columns from HogQL
  • Exclude expensive blob/JSON columns

Files updated

  • contents/docs/cdp/sources/mysql.mdx - Added "Selecting columns" section
  • contents/docs/cdp/sources/microsoft-sql-server.mdx - Added "Selecting columns" section
  • contents/docs/cdp/sources/bigquery.md - Added "Selecting columns" section
  • contents/docs/cdp/sources/snowflake.mdx - Added "Selecting columns" section
  • contents/docs/cdp/sources/redshift.mdx - Added "Selecting columns" section

Each new section documents:

  1. How to select columns during initial source setup
  2. How to change column selection after setup
  3. That primary key columns and incremental sync fields are always synced
  4. The "Sync forward only" vs "Full resync" choice when adding columns to existing syncs

The content follows the pattern established in the Postgres source documentation (contents/docs/cdp/sources/postgres.mdx).


This PR was created by the Inkeep Content Writer agent, which is maintained by the Docs and Wizard team. Please reach out on Slack for help if needed.

inkeep Bot added 5 commits May 29, 2026 13:07
PR #60155 extended per-column sync selection to MSSQL and other SQL sources.
Reflects PR #60155 which extended per-column sync selection
(previously Postgres only) to BigQuery and other SQL sources.
Per-column sync selection is now supported on Redshift (previously Postgres only).
Adds documentation for selecting specific columns during source setup and after setup.

Ref: PostHog/posthog#60155
@inkeep inkeep Bot requested a review from danielcarletti May 29, 2026 13:13
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 29, 2026

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview May 29, 2026 01:27PM

@github-actions
Copy link
Copy Markdown
Contributor

Vale prose linter → found 11 errors, 21 warnings, 3 suggestions in your markdown

Full report → Copy the linter results into an LLM to batch-fix issues.

Linter being weird? Update the rules!

contents/docs/cdp/sources/bigquery.md — 3 errors, 4 warnings, 0 suggestions
Line Severity Message Rule
57:29 warning Capitalize 'Data Pipelines' for PostHog's product. Use 'Data pipelines' for the general industry concept. PostHogBase.ProductNames
79:4 warning 'Uncheck' is a possible misspelling. PostHogBase.Spelling
90:1 error Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. PostHogBase.EnDash
91:1 error Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. PostHogBase.EnDash
91:12 warning 'resync' is a possible misspelling. PostHogBase.Spelling
91:43 warning 'resync' is a possible misspelling. PostHogBase.Spelling
106:189 error Use straight quotes and apostrophes, not curly ones. PostHogDocs.CurlyQuotes
contents/docs/cdp/sources/microsoft-sql-server.mdx — 2 errors, 5 warnings, 1 suggestions
Line Severity Message Rule
16:62 warning 'Entra' is a possible misspelling. PostHogBase.Spelling
29:37 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
33:5 warning Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. PostHogBase.ProductNames
44:4 warning 'Uncheck' is a possible misspelling. PostHogBase.Spelling
57:1 error Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. PostHogBase.EnDash
58:1 error Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. PostHogBase.EnDash
58:10 warning 'resync' is a possible misspelling. PostHogBase.Spelling
58:41 warning 'resync' is a possible misspelling. PostHogBase.Spelling
contents/docs/cdp/sources/mysql.mdx — 2 errors, 4 warnings, 1 suggestions
Line Severity Message Rule
23:37 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
34:5 warning Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. PostHogBase.ProductNames
45:4 warning 'Uncheck' is a possible misspelling. PostHogBase.Spelling
58:1 error Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. PostHogBase.EnDash
59:1 error Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. PostHogBase.EnDash
59:10 warning 'resync' is a possible misspelling. PostHogBase.Spelling
59:41 warning 'resync' is a possible misspelling. PostHogBase.Spelling
contents/docs/cdp/sources/redshift.mdx — 2 errors, 4 warnings, 1 suggestions
Line Severity Message Rule
26:37 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
30:5 warning Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. PostHogBase.ProductNames
43:4 warning 'Uncheck' is a possible misspelling. PostHogBase.Spelling
56:1 error Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. PostHogBase.EnDash
57:1 error Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. PostHogBase.EnDash
57:10 warning 'resync' is a possible misspelling. PostHogBase.Spelling
57:41 warning 'resync' is a possible misspelling. PostHogBase.Spelling
contents/docs/cdp/sources/snowflake.mdx — 2 errors, 4 warnings, 0 suggestions
Line Severity Message Rule
15:5 warning Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. PostHogBase.ProductNames
55:4 warning 'Uncheck' is a possible misspelling. PostHogBase.Spelling
68:1 error Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. PostHogBase.EnDash
69:1 error Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. PostHogBase.EnDash
69:10 warning 'resync' is a possible misspelling. PostHogBase.Spelling
69:41 warning 'resync' is a possible misspelling. PostHogBase.Spelling

@github-actions
Copy link
Copy Markdown
Contributor

Hey ! This docs PR was generated for you by an agent. You're responsible for reviewing and merging it into production.

  1. Review and approve the PR
  2. Merge the PR
    a. Check the preview env and CI build and merge it yourself
    b. Enable auto-merge if you're confident in the changes

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.

0 participants