Skip to content

Conversation

@gkevinzheng
Copy link
Contributor

Using the new data client for sample_row_keys

Fixes #1167

@gkevinzheng gkevinzheng requested review from a team as code owners December 19, 2025 18:22
@product-auto-label product-auto-label bot added the size: s Pull request size is small. label Dec 19, 2025
@product-auto-label product-auto-label bot added api: bigtable Issues related to the googleapis/python-bigtable API. samples Issues that are directly related to samples. labels Dec 19, 2025
@gemini-code-assist
Copy link

Summary of Changes

Hello @gkevinzheng, 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 updates the sample_row_keys method within the Bigtable client library to integrate with a new internal data client implementation. The change involves refactoring the method to delegate to an internal implementation and then wrapping the results into SampleRowKeysResponse objects, ensuring that the method continues to function as expected while leveraging the modernized client architecture. This update maintains external API compatibility while improving the underlying mechanism.

Highlights

  • Refactored sample_row_keys Method: The sample_row_keys method in google/cloud/bigtable/table.py has been refactored to utilize an internal _table_impl.sample_row_keys() call, effectively 'shimming' its implementation.
  • Updated Return Type: The method now returns a generator that yields data_messages_v2_pb2.SampleRowKeysResponse objects, providing a more structured and consistent output.
  • Unit Test Alignment: The corresponding unit test test_table_sample_row_keys in tests/unit/v2_client/test_table.py has been updated to reflect and verify the new return type and behavior of the sample_row_keys method.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

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.

Copy link

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request refactors the sample_row_keys method to use the new data client, which is a good step in modernizing the library. However, this change introduces a behavioral difference by switching from a streaming response to buffering all results in memory, which could impact performance for large tables. I've added a comment with more details on this. The accompanying test changes are well-written and correctly validate the new implementation.

Comment on lines +785 to 790
return (
data_messages_v2_pb2.SampleRowKeysResponse(
row_key=row_key, offset_bytes=offset_bytes
)
for row_key, offset_bytes in self._table_impl.sample_row_keys()
)

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

high

This change alters the behavior of sample_row_keys from streaming results to buffering them in memory. The new implementation using self._table_impl.sample_row_keys() collects all row key samples into a list before this method yields them. The previous implementation returned a streaming iterator from the gRPC call.

This can lead to significantly increased memory consumption for tables with a large number of sample keys.

Additionally, the docstring for this method is now inaccurate. It states that the method returns a cancel-able iterator (GrpcRendezvous), but it now returns a generator that is not cancel-able and is backed by an in-memory list. The docstring should be updated to reflect this new behavior and warn about the potential for increased memory usage.

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

Labels

api: bigtable Issues related to the googleapis/python-bigtable API. samples Issues that are directly related to samples. size: s Pull request size is small.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants