[iennae]

…nearest-neighbor vector search

Problem:
The BigQuery documentation (https://cloud.google.com/bigquery/docs/vector-search) needs a standalone, tested Python code sample demonstrating how to run approximate nearest-neighbor vector search (region tag bigquery_vector_search).

Solution:

• Add vector_search(project_id: str, dataset_id: str, table_id: str) -> None in bigquery/vector_search/bigquery_vector_search.py (Find top-K nearest neighbors using VECTOR_SEARCH with an indexed embedding table and fraction_lists_to_search.)
• Add unit tests (bigquery/vector_search/bigquery_vector_search_test.py) covering both the success path and API error handling (GoogleAPICallError)

Description

Fixes #

Checklist

Testing

• I have tested this change on a live environment and verified it works as intended.

Compliance & Style

• I have followed the Sample Guidelines.
• The README is updated with all relevant information (if applicable).
• If this PR adds a new sample directory: I updated the CODEOWNERS file.

---

Post-Approval Actions

• Please merge this PR for me once it is approved

[snippet-bot]

Here is the summary of changes.

You are about to add 1 region tag.

• bigquery/vector_search/bigquery_vector_search.py:15, tag bigquery_vector_search

---

This comment is generated by snippet-bot.
If you find problems with this result, please file an issue at:
https://github.com/googleapis/repo-automation-bots/issues.
To update this comment, add snippet-bot:force-run label or use the checkbox below:

• Refresh this comment

[gemini-code-assist]

Code Review

This pull request introduces a new Python sample for BigQuery Vector Search, including unit tests and configuration files. The feedback suggests removing the redundant Python version environment marker from the test requirements and updating the ignored_versions in the Nox configuration to ensure only the oldest (3.10) and newest (3.13) supported Python versions are tested.

[gemini-code-assist]

According to the general rules, environment markers for Python versions older than 3.10 should not be specified because Python versions below 3.10 are no longer supported. The environment marker ; python_version >= "3.10" is redundant and can be removed.

pytest==9.0.3

References

1. Do not specify fallback dependency versions or environment markers for Python versions older than 3.10, as Python versions below 3.10 are no longer supported.

[gemini-code-assist]

According to the general rules, only the oldest and newest supported Python releases should be tested in test configurations, ignoring intermediate versions. Since Python 3.10 is the oldest supported version and Python 3.13 is the newest, we should test 3.10 and 3.13, while ignoring the intermediate versions 3.11 and 3.12.

Suggested change

	"ignored_versions": ["2.7", "3.7", "3.8", "3.9", "3.10", "3.11"],
	"ignored_versions": ["2.7", "3.7", "3.8", "3.9", "3.11", "3.12"],

References

1. Only test the oldest and newest supported Python releases in test configurations (such as noxfile_config.py), ignoring intermediate versions.

[XrossFox]

LGTM, i have a nitpick, but no changes are neccessary.

[XrossFox]

This is more of a nitpick, not necessary to actually change the code. This should work, but patching should aim to modify the module's instance rather that the dependency, instead of patching "google.cloud.bigquery.Client", it should target "bigquery_vector_search.bigquery.Client", this could have side effects, but probably not a big deal in the current context.