Skip to content

Deprecate implicit legacy SQL default in BigQuery operators#67113

Open
VladaZakharova wants to merge 1 commit into
apache:mainfrom
VladaZakharova:bq-legacy-sql
Open

Deprecate implicit legacy SQL default in BigQuery operators#67113
VladaZakharova wants to merge 1 commit into
apache:mainfrom
VladaZakharova:bq-legacy-sql

Conversation

@VladaZakharova
Copy link
Copy Markdown
Contributor

Deprecates the implicit use_legacy_sql=True default in older BigQuery operators.

BigQuery now recommends GoogleSQL, and legacy SQL availability is restricted after June 1, 2026 depending on prior usage. This change keeps the current runtime behavior for compatibility, but emits an AirflowProviderDeprecationWarning when use_legacy_sql is omitted and Airflow falls back to the old legacy SQL default.
Documentation: https://docs.cloud.google.com/bigquery/docs/legacy-sql-feature-availability#:~:text=BigQuery%20monitors%20the%20use%20of,after%20the%20evaluation%20period%20ends.

Users can avoid the warning by choosing explicitly:

use_legacy_sql=False to use GoogleSQL.
use_legacy_sql=True if they intentionally still need legacy SQL.
The warning applies only to the implicit default. Explicit legacy SQL usage remains supported.

This also updates BigQuery operator and connection docs with guidance about GoogleSQL and legacy SQL availability.


Was generative AI tooling used to co-author this PR?
  • Yes (please specify the tool below)

  • Read the Pull Request Guidelines for more information. Note: commit author/co-author name and email in commits become permanently public when merged.
  • For fundamental code changes, an Airflow Improvement Proposal (AIP) is needed.
  • When adding dependency, check compliance with the ASF 3rd Party License Policy.
  • For significant user-facing changes create newsfragment: {pr_number}.significant.rst, in airflow-core/newsfragments. You can add this file in a follow-up commit after the PR is created so you know the PR number.

@VladaZakharova VladaZakharova requested a review from shahar1 as a code owner May 18, 2026 13:21
@boring-cyborg boring-cyborg Bot added area:providers kind:documentation provider:google Google (including GCP) related issues labels May 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:providers kind:documentation provider:google Google (including GCP) related issues

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant