From fcbf6fb9374cbfdc7f064275f46b14276cf492d2 Mon Sep 17 00:00:00 2001 From: Lawrence Qiu Date: Fri, 20 Nov 2026 20:12:35 +0000 Subject: [PATCH 1/2] docs(bigquery): replace broken troubleshooting-errors links Replace all 7 occurrences of the dead https://cloud.google.com/bigquery/troubleshooting-errors link (HTTP 404) across java-bigquery: - Point API HTTP status code and ErrorProto reason references (BigQueryError, BigQueryException, BigQuerySQLException, JobStatus, SimpleApp) to https://docs.cloud.google.com/bigquery/docs/errors. - Add https://docs.cloud.google.com/bigquery/docs/error-messages as a companion @see link on BigQueryException for client-side and connectivity errors (such as Java read timeouts and SSL errors). Verified with fmt:check, checkstyle:check, and test-compile. --- .../java/com/google/cloud/bigquery/BigQueryError.java | 3 +-- .../java/com/google/cloud/bigquery/BigQueryException.java | 8 +++++--- .../com/google/cloud/bigquery/BigQuerySQLException.java | 4 ++-- .../main/java/com/google/cloud/bigquery/JobStatus.java | 6 ++---- .../src/main/java/com/example/bigquery/SimpleApp.java | 2 +- 5 files changed, 11 insertions(+), 12 deletions(-) diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQueryError.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQueryError.java index ef638aa1bed7..87594051fc44 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQueryError.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQueryError.java @@ -72,8 +72,7 @@ public BigQueryError(String reason, String location, String message) { /** * Returns short error code that summarizes the error. * - * @see Troubleshooting - * Errors + * @see Troubleshooting Errors */ public String getReason() { return reason; diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQueryException.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQueryException.java index c42ff6327527..5ad62b9f6007 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQueryException.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQueryException.java @@ -30,12 +30,14 @@ /** * BigQuery service exception. * - * @see Google Cloud BigQuery - * error codes + * @see Google Cloud BigQuery error + * codes + * @see Google Cloud BigQuery + * error messages */ public final class BigQueryException extends BaseHttpServiceException { - // see: https://cloud.google.com/bigquery/troubleshooting-errors + // see: https://docs.cloud.google.com/bigquery/docs/errors private static final Set RETRYABLE_ERRORS = ImmutableSet.of( new Error(500, null), new Error(502, null), new Error(503, null), new Error(504, null)); diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQuerySQLException.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQuerySQLException.java index 672c6ad3faee..f139bbd3047f 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQuerySQLException.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQuerySQLException.java @@ -22,8 +22,8 @@ /** * BigQuery service exception. * - * @see Google Cloud BigQuery - * error codes + * @see Google Cloud BigQuery error + * codes */ public final class BigQuerySQLException extends SQLException { diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/JobStatus.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/JobStatus.java index 3ac24293c653..926724def872 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/JobStatus.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/JobStatus.java @@ -114,8 +114,7 @@ public State getState() { * Returns the final error result of the job. If present, indicates that the job has completed and * was unsuccessful. * - * @see Troubleshooting - * Errors + * @see Troubleshooting Errors */ @Nullable public BigQueryError getError() { @@ -126,8 +125,7 @@ public BigQueryError getError() { * Returns all errors encountered during the running of the job. Errors here do not necessarily * mean that the job has completed or was unsuccessful. * - * @see Troubleshooting - * Errors + * @see Troubleshooting Errors */ public List getExecutionErrors() { return executionErrors; diff --git a/java-bigquery/samples/snippets/src/main/java/com/example/bigquery/SimpleApp.java b/java-bigquery/samples/snippets/src/main/java/com/example/bigquery/SimpleApp.java index 7b72bb0f9409..e75837cad3da 100644 --- a/java-bigquery/samples/snippets/src/main/java/com/example/bigquery/SimpleApp.java +++ b/java-bigquery/samples/snippets/src/main/java/com/example/bigquery/SimpleApp.java @@ -71,7 +71,7 @@ public static void simpleApp(String projectId) { && queryJob.getStatus().getExecutionErrors().size() > 0) { // TODO(developer): Handle errors here. An error here do not necessarily mean that the job // has completed or was unsuccessful. - // For more details: https://cloud.google.com/bigquery/troubleshooting-errors + // For more details: https://docs.cloud.google.com/bigquery/docs/errors throw new RuntimeException("An unhandled error has occurred"); } // [END bigquery_simple_app_query] From ab59be022b4cc21314efca52b3136dbc141cddfa Mon Sep 17 00:00:00 2001 From: Lawrence Qiu Date: Fri, 20 Nov 2026 20:51:53 +0000 Subject: [PATCH 2/2] docs(bigquery): clarify error documentation link labels --- .../java/com/google/cloud/bigquery/BigQueryError.java | 3 ++- .../java/com/google/cloud/bigquery/BigQueryException.java | 8 ++++---- .../com/google/cloud/bigquery/BigQuerySQLException.java | 4 ++-- .../main/java/com/google/cloud/bigquery/JobStatus.java | 6 ++++-- 4 files changed, 12 insertions(+), 9 deletions(-) diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQueryError.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQueryError.java index 87594051fc44..41465bfe11ac 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQueryError.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQueryError.java @@ -72,7 +72,8 @@ public BigQueryError(String reason, String location, String message) { /** * Returns short error code that summarizes the error. * - * @see Troubleshooting Errors + * @see BigQuery API HTTP status and + * error codes */ public String getReason() { return reason; diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQueryException.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQueryException.java index 5ad62b9f6007..212b4c4d3e6a 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQueryException.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQueryException.java @@ -30,10 +30,10 @@ /** * BigQuery service exception. * - * @see Google Cloud BigQuery error - * codes - * @see Google Cloud BigQuery - * error messages + * @see BigQuery API HTTP status and + * error codes + * @see BigQuery client and + * connectivity error messages */ public final class BigQueryException extends BaseHttpServiceException { diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQuerySQLException.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQuerySQLException.java index f139bbd3047f..aa0191e917f9 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQuerySQLException.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQuerySQLException.java @@ -22,8 +22,8 @@ /** * BigQuery service exception. * - * @see Google Cloud BigQuery error - * codes + * @see BigQuery API HTTP status and + * error codes */ public final class BigQuerySQLException extends SQLException { diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/JobStatus.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/JobStatus.java index 926724def872..ecd48c375350 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/JobStatus.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/JobStatus.java @@ -114,7 +114,8 @@ public State getState() { * Returns the final error result of the job. If present, indicates that the job has completed and * was unsuccessful. * - * @see Troubleshooting Errors + * @see BigQuery API HTTP status and + * error codes */ @Nullable public BigQueryError getError() { @@ -125,7 +126,8 @@ public BigQueryError getError() { * Returns all errors encountered during the running of the job. Errors here do not necessarily * mean that the job has completed or was unsuccessful. * - * @see Troubleshooting Errors + * @see BigQuery API HTTP status and + * error codes */ public List getExecutionErrors() { return executionErrors;