Skip to content

docs(bigquery): clarify BigQueryException isRetryable IOException and getCode details - #39

Open
lqiu96 wants to merge 1 commit into
mainfrom
docs/bq-2h-clarify-bigqueryexception-retryability-and-code
Open

lqiu96 wants to merge 1 commit into
mainfrom
docs/bq-2h-clarify-bigqueryexception-retryability-and-code

Conversation

@lqiu96

@lqiu96 lqiu96 commented Nov 21, 2026

Copy link
Copy Markdown
Owner

Follow-up to googleapis#15125 tightening two empirically verified details on BigQueryException:

  • Distinguish getCode() == 0 for job-execution errors surfaced from JobStatus (such as Job.reload() and non-query Job.waitFor()) from query execution errors surfaced via jobs.getQueryResults (such as BigQuery.query() and query Job.waitFor()), which carry the RPC HTTP status code.
  • Clarify that isRetryable() returns true only for HTTP 500/502/503/504 and specific transient socket or SSL IOException subclasses (SocketTimeoutException, SocketException, etc.), and false for HTTP 4xx errors (including 403 rate limits and 429), JobStatus code 0 errors, and other IOException types such as EOFException.

Verified with fmt:check, Checkstyle, test-compile, strict javadoc -Xdoclint:syntax,html,reference, and live BigQuery + API checks.

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.

1 participant