Skip to content

docs(meta-db): warn that SUPERSET_META_DB_LIMIT truncates tables before joins#41302

Open
rusackas wants to merge 1 commit into
masterfrom
docs/meta-db-join-limit-caveat
Open

docs(meta-db): warn that SUPERSET_META_DB_LIMIT truncates tables before joins#41302
rusackas wants to merge 1 commit into
masterfrom
docs/meta-db-join-limit-caveat

Conversation

@rusackas

Copy link
Copy Markdown
Member

SUMMARY

Addresses #36304. When the Superset meta database (ENABLE_SUPERSET_META_DB) joins across underlying databases, SUPERSET_META_DB_LIMIT (default 1000) is applied to each underlying table before the in-memory join runs, not to the final result. If any joined table has more rows than the limit, only the first SUPERSET_META_DB_LIMIT rows of that table are read, so matching rows can be silently dropped and the join can return incomplete or empty results with no error. The existing docs mention the per-table limit but don't warn that it can silently produce wrong results. This adds a :::warning admonition next to the existing SUPERSET_META_DB_LIMIT prose explaining the behavior and the workaround (raise the limit above your largest joined table, or set it to None for small tables). Docs-only; the underlying behavior is left for a separate fix decision, so the issue stays open.

TESTING INSTRUCTIONS

Docs only. No code changes.

ADDITIONAL INFORMATION

  • Has associated issue: ENABLE_SUPERSET_META_DB feature works incorrectly #36304
  • Required feature flags:
  • Changes UI
  • Includes DB Migration (follow approval process in SIP-59)
    • Migration is atomic, supports rollback & is backwards-compatible
    • Confirm DB migration upgrade and downgrade tested
    • Runtime estimates and downtime expectations provided
  • Introduces new feature or API
  • Removes existing feature or API

…re joins

Addresses #36304. The Superset meta database applies SUPERSET_META_DB_LIMIT
(default 1000) to each underlying table before the in-memory join runs, so a
join over tables larger than the limit can silently return incomplete or empty
results. Document this caveat near the existing SUPERSET_META_DB_LIMIT prose.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@dosubot dosubot Bot added the doc:user User / Superset documentation label Jun 23, 2026
@bito-code-review

bito-code-review Bot commented Jun 23, 2026

Copy link
Copy Markdown
Contributor

Code Review Agent Run #ae66a4

Actionable Suggestions - 0
Review Details
  • Files reviewed - 1 · Commit Range: 2c63a83..2c63a83
    • docs/user_docs_versioned_docs/version-6.0.0/configuration/databases.mdx
  • Files skipped - 0
  • Tools
    • Whispers (Secret Scanner) - ✔︎ Successful
    • Detect-secrets (Secret Scanner) - ✔︎ Successful

Bito Usage Guide

Commands

Type the following command in the pull request comment and save the comment.

  • /review - Manually triggers a full AI review.

  • /pause - Pauses automatic reviews on this pull request.

  • /resume - Resumes automatic reviews.

  • /resolve - Marks all Bito-posted review comments as resolved.

  • /abort - Cancels all in-progress reviews.

Refer to the documentation for additional commands.

Configuration

This repository uses Superset You can customize the agent settings here or contact your Bito workspace admin at evan@preset.io.

Documentation & Help

AI Code Review powered by Bito Logo

@github-actions github-actions Bot added the doc Namespace | Anything related to documentation label Jun 23, 2026
@netlify

netlify Bot commented Jun 23, 2026

Copy link
Copy Markdown

Deploy Preview for superset-docs-preview ready!

Name Link
🔨 Latest commit 2c63a83
🔍 Latest deploy log https://app.netlify.com/projects/superset-docs-preview/deploys/6a39d772a3f3310008006398
😎 Deploy Preview https://deploy-preview-41302--superset-docs-preview.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

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

doc:user User / Superset documentation doc Namespace | Anything related to documentation size/XS

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant