Skip to content

docs(batch-exports): Document BigQuery stage table auto-expiration#18787

Open
inkeep[bot] wants to merge 1 commit into
masterfrom
docs-writer-ai-update-2026-07-22T08-26-08-165Z-58iupq
Open

docs(batch-exports): Document BigQuery stage table auto-expiration#18787
inkeep[bot] wants to merge 1 commit into
masterfrom
docs-writer-ai-update-2026-07-22T08-26-08-165Z-58iupq

Conversation

@inkeep

@inkeep inkeep Bot commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

Changes

Updates the BigQuery batch export documentation to reflect changes from PostHog/posthog#68648:

  1. Clarified permissions: Changed bigquery.tables.delete from optional to required for mutable models, and added a note explaining that query permissions are recommended for all batch exports (with historical fallback support for non-mutable models).

  2. Documented stage table expiration: Added "(with a 1-week expiration as a safety net)" to the merge operation steps, explaining the new automatic cleanup behavior.

  3. New FAQ entry: Added "What happens to stage tables if a batch export fails?" explaining that stage tables now auto-expire after one week, so users don't need to manually clean up orphaned tables after crashes.

Related PR


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.

…ssions

Updates BigQuery batch export docs to reflect PR #68648:
- Stage tables now have a 1-week expiration for automatic cleanup
- bigquery.tables.delete is required (not optional) for mutable models
- Added FAQ about stage table cleanup on failure
- Added note about query permissions being recommended
@github-actions

github-actions Bot commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview Jul 22, 2026 08:41AM

@github-actions

Copy link
Copy Markdown
Contributor

Vale prose linter → found 0 errors, 13 warnings, 1 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/batch-exports/bigquery.mdx — 0 errors, 13 warnings, 1 suggestions
Line Severity Message Rule
59:255 warning Use bold (text) for UI elements, not quotes. PostHogDocs.UIBoldNotQuotes
83:178 warning Use bold (text) for UI elements, not quotes. PostHogDocs.UIBoldNotQuotes
126:3 warning Use 'UUID' instead of 'uuid'. Vale.Terms
132:69 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
134:3 warning 'ip' is a possible misspelling. PostHogBase.Spelling
166:44 warning 'nullable' is a possible misspelling. PostHogBase.Spelling
174:57 warning Use 'ID' instead of 'id'. Vale.Terms
176:57 warning Use 'ID' instead of 'id'. Vale.Terms
203:44 warning 'nullable' is a possible misspelling. PostHogBase.Spelling
264:4 warning 'FAQ' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
291:292 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
293:289 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
301:65 warning 'nullable' is a possible misspelling. PostHogBase.Spelling
307:45 warning 'nullable' is a possible misspelling. PostHogBase.Spelling

@github-actions

Copy link
Copy Markdown
Contributor

Bundle report

Total JS (gzip)

6.73 MiB (no change)

Eager graph (modules shipped in each entrypoint's initial chunks)

Entrypoint Eager size Budget Modules
app 16.15 MiB (no change) report-only 1970
Largest modules in the app closure
Module Size
./src/data/mcp-tools.json 883.1 KiB
css ./node_modules/.pnpm/css-loader@5.2.7_webpack@5.101.3/node_modules/css-loader/dist/cjs.js??ruleSet[1].rules[8].oneOf[1].use[1]!./node_modules/.pnpm/postcss-loader@4.3.0_postcss@8.5.6_webpack@5.101.3/node_modules/postcss-loader/dist/cjs.js??ruleSet[1].rules[8].oneOf[1].use[2]!./src/styles/global.css 743.0 KiB
./src/components/Stickers/Stickers.tsx 696.4 KiB
./node_modules/.pnpm/@radix-ui+react-icons@1.3.2_react@18.3.1/node_modules/@radix-ui/react-icons/dist/react-icons.esm.js 481.4 KiB
./node_modules/.pnpm/rehype-raw@7.0.0/node_modules/rehype-raw/lib/index.js + 29 modules 395.1 KiB
./node_modules/.pnpm/@posthog+icons@0.36.6_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@posthog/icons/dist/posthog-icons.cjs.js 364.8 KiB
./src/hooks/useCustomers.tsx + 54 modules 355.1 KiB
./node_modules/.pnpm/@posthog+icons@0.36.6_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@posthog/icons/dist/posthog-icons.es.js 354.8 KiB
./node_modules/.pnpm/react-markdown@8.0.7_@types+react@16.14.66_react@18.3.1/node_modules/react-markdown/lib/react-markdown.js + 88 modules 351.4 KiB
./node_modules/.pnpm/cloudinary-core@2.14.0_lodash@4.17.21/node_modules/cloudinary-core/cloudinary-core.js 281.9 KiB
./src/components/ProductComparisonTable/index.tsx + 120 modules 278.6 KiB
./src/components/SearchUI/index.tsx + 87 modules 271.9 KiB
./node_modules/.pnpm/d3@7.9.0/node_modules/d3/src/index.js + 208 modules 247.4 KiB
./src/components/Pricing/PricingSlider/Slider.tsx + 87 modules 239.9 KiB
./gatsby-browser.tsx + 43 modules 225.0 KiB

Eager-graph budgets are report-only until a baseline is established. Sizes are gzip of public/**/*.js; eager size is webpack module source bytes for the modules actually shipped in the entrypoint's initial chunks (post-tree-shake).

@github-actions

Copy link
Copy Markdown
Contributor

Hey @tomasfarias! 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

Status: Backlog

Development

Successfully merging this pull request may close these issues.

0 participants