Skip to content

docs(bigquery-jdbc): add user guide with connection property and custom endpoint reference - #13878

Open
Neenu1995 wants to merge 11 commits into
mainfrom
pr-1-user-guide-properties
Open

docs(bigquery-jdbc): add user guide with connection property and custom endpoint reference#13878
Neenu1995 wants to merge 11 commits into
mainfrom
pr-1-user-guide-properties

Conversation

@Neenu1995

@Neenu1995 Neenu1995 commented Jul 23, 2026

Copy link
Copy Markdown
Contributor

b/538176465

@Neenu1995
Neenu1995 requested review from a team as code owners July 23, 2026 17:52

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

Copy link
Copy Markdown
Contributor

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 adds a comprehensive User Guide (USER_GUIDE.md) for the Google BigQuery JDBC Driver, detailing configuration, architecture, and common code recipes. The review feedback correctly identifies several inconsistencies in the document, specifically regarding incorrect OAuthType values in the authentication examples (confusing OAuthType=0 for Service Accounts with OAuthType=3 for Application Default Credentials) and mismatches in the Table of Contents headings.

Comment thread java-bigquery-jdbc/USER_GUIDE.md Outdated
Comment thread java-bigquery-jdbc/USER_GUIDE.md Outdated
Comment thread java-bigquery-jdbc/USER_GUIDE.md Outdated
Comment thread java-bigquery-jdbc/USER_GUIDE.md Outdated
Comment thread java-bigquery-jdbc/USER_GUIDE.md Outdated
Comment thread java-bigquery-jdbc/USER_GUIDE.md Outdated
Comment thread java-bigquery-jdbc/USER_GUIDE.md Outdated
Comment thread java-bigquery-jdbc/USER_GUIDE.md Outdated
Comment thread java-bigquery-jdbc/USER_GUIDE.md Outdated
Comment thread java-bigquery-jdbc/USER_GUIDE.md Outdated
…rties

# Please enter a commit message to explain why this merge is necessary,
# especially if it merges an updated upstream into a topic branch.
#
# Lines starting with '#' will be ignored, and an empty message aborts
# the commit.
@Neenu1995

Copy link
Copy Markdown
Contributor Author

/gemini review

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

Copy link
Copy Markdown
Contributor

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 introduces a comprehensive User Guide for the Google BigQuery JDBC Driver, detailing setup, configuration properties, architecture, and common code recipes. The review feedback highlights several critical corrections needed in the documentation's code examples: updating the transaction prerequisite exception from IllegalStateException to SQLException to match the JDBC contract, adding null and type safety checks to the complex types example to prevent runtime exceptions, replacing the stored procedure example with a multi-statement script since standard JDBC OUT parameters are unsupported, and wrapping the Spring Boot YAML connection URL in double quotes to avoid parsing issues.

Comment thread java-bigquery-jdbc/USER_GUIDE.md Outdated
Comment thread java-bigquery-jdbc/USER_GUIDE.md Outdated
Comment thread java-bigquery-jdbc/USER_GUIDE.md Outdated
Comment thread java-bigquery-jdbc/USER_GUIDE.md Outdated
@Neenu1995

Copy link
Copy Markdown
Contributor Author

/gemini review

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

Copy link
Copy Markdown
Contributor

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 introduces a comprehensive User Guide (USER_GUIDE.md) for the Google BigQuery JDBC Driver, detailing configuration, authentication, connection properties, data type mappings, architecture, and common user journeys with code recipes. The review feedback correctly identifies two key improvements: updating the Table of Contents to accurately match the headers in Section 9, and adding a final batch execution check in the ETL ingestion code recipe to prevent potential data loss when the batch size is not a multiple of 500.

Comment thread java-bigquery-jdbc/USER_GUIDE.md Outdated
Comment thread java-bigquery-jdbc/USER_GUIDE.md Outdated
Neenu1995 and others added 4 commits July 24, 2026 12:59
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
…ogle-cloud-java into pr-1-user-guide-properties
Comment thread java-bigquery-jdbc/USER_GUIDE.md Outdated
Comment thread java-bigquery-jdbc/USER_GUIDE.md Outdated
Comment thread java-bigquery-jdbc/USER_GUIDE.md Outdated
Comment thread java-bigquery-jdbc/USER_GUIDE.md Outdated
Comment thread java-bigquery-jdbc/USER_GUIDE.md Outdated
Comment thread java-bigquery-jdbc/USER_GUIDE.md Outdated
Comment thread java-bigquery-jdbc/USER_GUIDE.md Outdated
Comment thread java-bigquery-jdbc/USER_GUIDE.md Outdated
Comment thread java-bigquery-jdbc/USER_GUIDE.md Outdated
Comment thread java-bigquery-jdbc/USER_GUIDE.md Outdated
@Neenu1995
Neenu1995 requested a review from logachev July 28, 2026 19:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants