Skip to content

Conversation

@shuoweil
Copy link
Contributor

@shuoweil shuoweil commented Jan 21, 2026

** This PR is not ready for review. **

Introduces "Deferred Execution Mode" for the interactive Table Widget. By default, the widget now displays a preview with a "Run Query and Display Widget" button instead of immediately executing potentially expensive BigQuery jobs. This enhances cost control and prevents accidental large data fetches in interactive environments like Jupyter Notebooks.

Key Changes

  • Deferred Execution: TableWidget now defaults to a deferred state. Users must explicitly click "Run Query" to execute the job and load data.
  • Global Configuration: Added bigframes.options.display.anywidget_deferred (default: True) to allow users to toggle this behavior globally or programmatically.
  • UI Experience:
    • Added a clear "preview" state for deferred widgets.
    • Fixed visual "shaking" issues during table re-renders.
    • Improved height stabilization to prevent layout shifts.
  • Documentation: Updated notebooks/dataframes/anywidget_mode.ipynb with examples of deferred mode and how to disable it.

Verified at

Fixes #<460865443> 🦕

@shuoweil shuoweil self-assigned this Jan 21, 2026
@shuoweil shuoweil requested review from a team as code owners January 21, 2026 18:25
@review-notebook-app
Copy link

Check out this pull request on  ReviewNB

See visual diffs & provide feedback on Jupyter Notebooks.


Powered by ReviewNB

@product-auto-label product-auto-label bot added the size: l Pull request size is large. label Jan 21, 2026
@shuoweil shuoweil removed the request for review from TrevorBergeron January 21, 2026 18:25
@product-auto-label product-auto-label bot added the api: bigquery Issues related to the googleapis/python-bigquery-dataframes API. label Jan 21, 2026
@shuoweil shuoweil marked this pull request as draft January 21, 2026 18:26
@shuoweil shuoweil marked this pull request as ready for review January 21, 2026 21:13
@shuoweil shuoweil marked this pull request as draft January 22, 2026 00:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

api: bigquery Issues related to the googleapis/python-bigquery-dataframes API. size: l Pull request size is large.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant