Skip to content

Conversation

@Arunodoy18
Copy link

Please add a meaningful description for your change here


Thank you for your contribution! Follow this checklist to help us incorporate your contribution quickly and easily:

  • Mention the appropriate issue in your description (for example: addresses #123), if applicable. This will automatically add a link to the pull request in the issue. If you would like the issue to automatically close on merging the pull request, comment fixes #<ISSUE NUMBER> instead.
  • Update CHANGES.md with noteworthy changes.
  • If this contribution is large, please file an Apache Individual Contributor License Agreement.

See the Contributor Guide for more tips on how to make review process smoother.

To check the build health, please visit https://github.com/apache/beam/blob/master/.test-infra/BUILD_STATUS.md

GitHub Actions Tests Status (on master branch)

Build python source distribution and wheels
Python tests
Java tests
Go tests

See CI.md for more information about GitHub Actions CI or the workflows README to see a list of phrases to trigger workflows.

This commit adds support for escaping and unescaping glob wildcard characters
in file path specifications, addressing the issue where files with literal
glob metacharacters (*, ?, {, }) in their names cannot be matched.

Changes:
- Added escapeGlobWildcards(String spec) method to escape glob metacharacters
  by prefixing them with backslash
- Added unescapeGlobWildcards(String spec) method to remove backslash prefixes
  from escaped glob characters
- Added comprehensive test cases for both methods including round-trip testing

These utilities provide the foundation for allowing users to treat glob
metacharacters as literals when they appear in actual filenames.

Fixes BEAM-13231
When CDC (Change Data Capture) is enabled with STORAGE_WRITE_API method,
the system was incorrectly using PENDING streams instead of the default
stream, causing an IllegalStateException due to checkState validation.

Changes:
- Fixed StorageApiWriteUnshardedRecords to use default stream when CDC is enabled
- Added comprehensive test case to prevent regression

CDC requires default streams because PENDING streams don't support the
RowMutationInformation functionality needed for upserts and deletes.

Fixes apache#31422
@gemini-code-assist
Copy link
Contributor

Summary of Changes

Hello @Arunodoy18, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request primarily resolves an IllegalStateException that occurred when utilizing Change Data Capture (CDC) with the BigQuery Storage Write API, as identified in issue #31422. The fix involves ensuring the usesCdc flag is correctly passed through the BigQuery write pipeline. Additionally, new utility functions for escaping and unescaping glob wildcard characters in file paths have been introduced in the FileSystems class, along with corresponding unit tests to ensure their correct functionality.

Highlights

  • BigQuery CDC Fix: Addressed issue [Bug]: Issue with IllegalStateException in STORAGE_WRITE_API method in BigQueryIO #31422 by correctly propagating the usesCdc flag within the BigQuery Storage API write path, resolving an IllegalStateException when using Change Data Capture with the Storage Write API.
  • Glob Wildcard Utilities: Introduced new utility methods escapeGlobWildcards and unescapeGlobWildcards in FileSystems.java to handle escaping and unescaping of glob wildcard characters (*, ?, {, }) in file paths.
  • Unit Tests: Added comprehensive unit tests for the new glob wildcard utility methods and a specific test case to verify the BigQuery CDC fix with the Storage Write API.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@github-actions
Copy link
Contributor

Checks are failing. Will not request review until checks are succeeding. If you'd like to override that behavior, comment assign set of reviewers

…AT_LEAST_ONCE

- Updated JavaDoc to reflect that triggeringFrequency applies to FILE_LOADS,
  STORAGE_WRITE_API, and STORAGE_API_AT_LEAST_ONCE methods
- Fixed validation logic in expand() to require triggeringFrequency for
  STORAGE_API_AT_LEAST_ONCE when writing unbounded PCollections
- Removed conflicting warning that incorrectly stated STORAGE_API_AT_LEAST_ONCE
  ignores triggeringFrequency
- Added comprehensive test cases to verify proper validation behavior:
  * Test failure when triggeringFrequency is missing for unbounded collections
  * Test success when triggeringFrequency is provided for unbounded collections
  * Test success for bounded collections without triggeringFrequency requirement
- Updated error messages to include all three supported methods

This ensures consistent behavior across all BigQuery write methods that support
triggered writes for unbounded collections.
@Arunodoy18
Copy link
Author

Hi, I'm a first-time contributor.
Could someone please approve the workflows so CI can run?
Also, let me know if I need to fix anything from my side.
Thank you!

@stankiewicz
Copy link
Contributor

stankiewicz commented Nov 24, 2025

@Arunodoy18 tests are triggered whenever you commit something. if there are flakes type the action name from ( ) brackets.

@stankiewicz
Copy link
Contributor

Also @Arunodoy18 , please check https://www.apache.org/legal/generative-tooling.html

When providing contributions authored using generative AI tooling, a recommended practice is for contributors to indicate the tooling used to create the contribution. This should be included as a token in the source control commit message, for example including the phrase “Generated-by: ”. This allows for future release tooling to be considered that pulls this content into a machine parsable Tooling-Provenance file."

@stankiewicz
Copy link
Contributor

please also split those 3 commits into 3 seperate PRs, it looks like you are trying to fix 3 different issues, which is great, but it shouldn't be one PR.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants