diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQuery.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQuery.java index f2de6cd0da05..00a9b7a3fcb9 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQuery.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQuery.java @@ -397,7 +397,7 @@ public static DatasetDeleteOption deleteContents() { } } - /** Class for specifying table list options. */ + /** Class for specifying model list options. */ class ModelListOption extends Option { private static final long serialVersionUID = 8660294969063322498L; @@ -528,7 +528,7 @@ public static ModelOption fields(ModelField... fields) { } } - /** Class for specifying table get, create and update options. */ + /** Class for specifying routine get, create and update options. */ class RoutineOption extends Option { private static final long serialVersionUID = -1723870122095226772L; @@ -538,8 +538,8 @@ private RoutineOption(BigQueryRpc.Option option, Object value) { } /** - * Returns an option to specify the routines's fields to be returned by the RPC call. If this - * option is not provided all model's fields are returned. {@code RoutineOption.fields} can be + * Returns an option to specify the routine's fields to be returned by the RPC call. If this + * option is not provided all routine's fields are returned. {@code RoutineOption.fields} can be * used to specify only the fields of interest. */ public static RoutineOption fields(RoutineField... fields) { @@ -634,7 +634,7 @@ public static JobListOption parentJobId(String parentJobId) { /** * Returns an option to specify the job's fields to be returned by the RPC call. If this option - * is not provided all job's fields are returned. {@code JobOption.fields()} can be used to + * is not provided all job's fields are returned. {@code JobListOption.fields()} can be used to * specify only the fields of interest. {@link Job#getJobId()}, {@link JobStatus#getState()}, * {@link JobStatus#getError()} as well as type-specific configuration (e.g. {@link * QueryJobConfiguration#getQuery()} for Query Jobs) are always returned, even if not specified. @@ -647,7 +647,7 @@ public static JobListOption fields(JobField... fields) { } } - /** Class for specifying table get and create options. */ + /** Class for specifying job get, create, and query options. */ class JobOption extends Option { private static final long serialVersionUID = -3111736712316353664L; @@ -1083,7 +1083,7 @@ public int hashCode() { *
{@code
* String projectId = "my_project_id";
* String datasetName = "my_dataset_name";
- * String tableName = "my_model_name";
+ * String modelName = "my_model_name";
* ModelId modelId = ModelId.of(projectId, datasetName, modelName);
* boolean deleted = bigquery.delete(modelId);
* if (deleted) {
@@ -1106,8 +1106,8 @@ public int hashCode() {
* {@code
* String projectId = "my_project_id";
* String datasetId = "my_dataset_id";
- * String routineId = "my_routine_id";
- * RoutineId routineId = RoutineId.of(projectId, datasetId, routineId);
+ * String routineName = "my_routine_id";
+ * RoutineId routineId = RoutineId.of(projectId, datasetId, routineName);
* boolean deleted = bigquery.delete(routineId);
* if (deleted) {
* // the routine was deleted
@@ -1133,21 +1133,15 @@ public int hashCode() {
* Updates dataset information.
*
* Example of updating a dataset by changing its description.
- *
*
*
{@code
- * // String datasetName = "my_dataset_name";
- * // String tableName = "my_table_name";
- * // String newDescription = "new_description";
- *
- * Table beforeTable = bigquery.getTable(datasetName, tableName);
- * TableInfo tableInfo = beforeTable.toBuilder().setDescription(newDescription).build();
- * Table afterTable = bigquery.update(tableInfo);
+ * String datasetName = "my_dataset_name";
+ * String newDescription = "new_description";
+ * Dataset beforeDataset = bigquery.getDataset(datasetName);
+ * DatasetInfo datasetInfo = beforeDataset.toBuilder().setDescription(newDescription).build();
+ * Dataset afterDataset = bigquery.update(datasetInfo);
* }
*
- *
- *
* @throws BigQueryException upon failure
*/
Dataset update(DatasetInfo datasetInfo, DatasetOption... options);
@@ -1269,7 +1263,7 @@ public int hashCode() {
* String projectId = "my_project_id";
* String datasetName = "my_dataset_name";
* String modelName = "my_model_name";
- * ModelId modelId = ModelId.of(projectId, datasetName, tableName);
+ * ModelId modelId = ModelId.of(projectId, datasetName, modelName);
* Model model = bigquery.getModel(modelId);
* }
*
diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Connection.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Connection.java
index 83ea0fc0dcbe..24254ce8118f 100644
--- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Connection.java
+++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Connection.java
@@ -46,23 +46,22 @@ public interface Connection {
*
* Example of running a query.
*
- *
- * {
- * @code
- * ConnectionSettings connectionSettings =
- * ConnectionSettings.newBuilder()
- * .setRequestTimeout(10L)
- * .setMaxResults(100L)
- * .setUseQueryCache(true)
- * .build();
- * Connection connection = bigquery.createConnection(connectionSettings);
- * String selectQuery = "SELECT corpus FROM `bigquery-public-data.samples.shakespeare` GROUP BY corpus;";
- * BigQueryResult bqResultSet = connection.executeSelect(selectQuery)
- * ResultSet rs = bqResultSet.getResultSet();
- * while (rs.next()) {
- * System.out.printf("%s,", rs.getString("corpus"));
- * }
- *
+ * {@code
+ * ConnectionSettings connectionSettings =
+ * ConnectionSettings.newBuilder()
+ * .setRequestTimeout(10000L)
+ * .setMaxResults(100L)
+ * .setUseQueryCache(true)
+ * .build();
+ * Connection connection = bigquery.createConnection(connectionSettings);
+ * String selectQuery =
+ * "SELECT corpus FROM `bigquery-public-data.samples.shakespeare` GROUP BY corpus;";
+ * BigQueryResult bqResultSet = connection.executeSelect(selectQuery);
+ * ResultSet rs = bqResultSet.getResultSet();
+ * while (rs.next()) {
+ * System.out.printf("%s,", rs.getString("corpus"));
+ * }
+ * }
*
* @param sql a static SQL SELECT statement
* @return a ResultSet that contains the data produced by the query
@@ -97,29 +96,28 @@ BigQueryResult executeSelect(
*
* Example of running a query.
*
- *
- * {
- * @code
- * ConnectionSettings connectionSettings =
- * ConnectionSettings.newBuilder()
- * .setUseReadAPI(true)
- * .build();
- * Connection connection = bigquery.createConnection(connectionSettings);
- * String selectQuery = "SELECT corpus FROM `bigquery-public-data.samples.shakespeare` GROUP BY corpus;";
- * ListenableFuture<ExecuteSelectResponse> executeSelectFuture = connection.executeSelectAsync(selectQuery);
+ * {@code
+ * ConnectionSettings connectionSettings =
+ * ConnectionSettings.newBuilder()
+ * .setUseReadAPI(true)
+ * .build();
+ * Connection connection = bigquery.createConnection(connectionSettings);
+ * String selectQuery =
+ * "SELECT corpus FROM `bigquery-public-data.samples.shakespeare` GROUP BY corpus;";
+ * ListenableFuture executeSelectFuture =
+ * connection.executeSelectAsync(selectQuery);
* ExecuteSelectResponse executeSelectRes = executeSelectFuture.get();
*
- * if(!executeSelectRes.getIsSuccessful()){
- * throw executeSelectRes.getBigQuerySQLException();
+ * if (!executeSelectRes.getIsSuccessful()) {
+ * throw executeSelectRes.getBigQuerySQLException();
* }
*
- * BigQueryResult bigQueryResult = executeSelectRes.getBigQueryResult();
+ * BigQueryResult bigQueryResult = executeSelectRes.getResultSet();
* ResultSet rs = bigQueryResult.getResultSet();
* while (rs.next()) {
- * System.out.println(rs.getString(1));
+ * System.out.println(rs.getString("corpus"));
* }
- *
- *
+ * }
*
* @param sql a static SQL SELECT statement
* @return a ListenableFuture that is used to get the data produced by the query
@@ -135,43 +133,40 @@ ListenableFuture executeSelectAsync(String sql)
*
* Example of running a query.
*
- *
- * {
- * @code
- * ConnectionSettings connectionSettings =
- * ConnectionSettings.newBuilder()
- * .setUseReadAPI(true)
- * .build();
- * Connection connection = bigquery.createConnection(connectionSettings);
- * String selectQuery =
- * "SELECT TimestampField, StringField, BooleanField FROM "
- * + MY_TABLE
- * + " WHERE StringField = @stringParam"
- * + " AND IntegerField IN UNNEST(@integerList)";
- * QueryParameterValue stringParameter = QueryParameterValue.string("stringValue");
- * QueryParameterValue intArrayParameter =
- * QueryParameterValue.array(new Integer[] {3, 4}, Integer.class);
- * Parameter stringParam =
- * Parameter.newBuilder().setName("stringParam").setValue(stringParameter).build();
- * Parameter intArrayParam =
- * Parameter.newBuilder().setName("integerList").setValue(intArrayParameter).build();
- * List<Parameter> parameters = ImmutableList.of(stringParam, intArrayParam);
- *
- * ListenableFuture<ExecuteSelectResponse> executeSelectFut =
- * connection.executeSelectAsync(selectQuery, parameters);
+ * {@code
+ * ConnectionSettings connectionSettings =
+ * ConnectionSettings.newBuilder()
+ * .setUseReadAPI(true)
+ * .build();
+ * Connection connection = bigquery.createConnection(connectionSettings);
+ * String selectQuery =
+ * "SELECT TimestampField, StringField, BooleanField FROM "
+ * + MY_TABLE
+ * + " WHERE StringField = @stringParam"
+ * + " AND IntegerField IN UNNEST(@integerList)";
+ * QueryParameterValue stringParameter = QueryParameterValue.string("stringValue");
+ * QueryParameterValue intArrayParameter =
+ * QueryParameterValue.array(new Integer[] {3, 4}, Integer.class);
+ * Parameter stringParam =
+ * Parameter.newBuilder().setName("stringParam").setValue(stringParameter).build();
+ * Parameter intArrayParam =
+ * Parameter.newBuilder().setName("integerList").setValue(intArrayParameter).build();
+ * List parameters = ImmutableList.of(stringParam, intArrayParam);
+ *
+ * ListenableFuture executeSelectFuture =
+ * connection.executeSelectAsync(selectQuery, parameters);
* ExecuteSelectResponse executeSelectRes = executeSelectFuture.get();
*
- * if(!executeSelectRes.getIsSuccessful()){
- * throw executeSelectRes.getBigQuerySQLException();
+ * if (!executeSelectRes.getIsSuccessful()) {
+ * throw executeSelectRes.getBigQuerySQLException();
* }
*
- * BigQueryResult bigQueryResult = executeSelectRes.getBigQueryResult();
+ * BigQueryResult bigQueryResult = executeSelectRes.getResultSet();
* ResultSet rs = bigQueryResult.getResultSet();
* while (rs.next()) {
- * System.out.println(rs.getString(1));
+ * System.out.println(rs.getString("StringField"));
* }
- *
- *
+ * }
*
* @param sql SQL SELECT query
* @param parameters named or positional parameters. The set of query parameters must either be
diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/ConnectionImpl.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/ConnectionImpl.java
index e949297fe0cc..9416caf708ef 100644
--- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/ConnectionImpl.java
+++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/ConnectionImpl.java
@@ -272,29 +272,28 @@ private BigQueryResult getExecuteSelectResponse(
*
* Example of running a query.
*
- *
- * {
- * @code
- * ConnectionSettings connectionSettings =
- * ConnectionSettings.newBuilder()
- * .setUseReadAPI(true)
- * .build();
- * Connection connection = bigquery.createConnection(connectionSettings);
- * String selectQuery = "SELECT corpus FROM `bigquery-public-data.samples.shakespeare` GROUP BY corpus;";
- * ListenableFuture executeSelectFuture = connection.executeSelectAsync(selectQuery);
+ * {@code
+ * ConnectionSettings connectionSettings =
+ * ConnectionSettings.newBuilder()
+ * .setUseReadAPI(true)
+ * .build();
+ * Connection connection = bigquery.createConnection(connectionSettings);
+ * String selectQuery =
+ * "SELECT corpus FROM `bigquery-public-data.samples.shakespeare` GROUP BY corpus;";
+ * ListenableFuture executeSelectFuture =
+ * connection.executeSelectAsync(selectQuery);
* ExecuteSelectResponse executeSelectRes = executeSelectFuture.get();
*
- * if(!executeSelectRes.getIsSuccessful()){
- * throw executeSelectRes.getBigQuerySQLException();
+ * if (!executeSelectRes.getIsSuccessful()) {
+ * throw executeSelectRes.getBigQuerySQLException();
* }
*
- * BigQueryResult bigQueryResult = executeSelectRes.getBigQueryResult();
+ * BigQueryResult bigQueryResult = executeSelectRes.getResultSet();
* ResultSet rs = bigQueryResult.getResultSet();
* while (rs.next()) {
- * System.out.println(rs.getString(1));
+ * System.out.println(rs.getString("corpus"));
* }
- *
- *
+ * }
*
* @param sql a static SQL SELECT statement
* @return a ListenableFuture that is used to get the data produced by the query
@@ -374,43 +373,40 @@ public void onFailure(Throwable t) {
*
* Example of running a query.
*
- *
- * {
- * @code
- * ConnectionSettings connectionSettings =
- * ConnectionSettings.newBuilder()
- * ..setUseReadAPI(true)
- * .build();
- * Connection connection = bigquery.createConnection(connectionSettings);
- * String selectQuery =
- * "SELECT TimestampField, StringField, BooleanField FROM "
- * + MY_TABLE
- * + " WHERE StringField = @stringParam"
- * + " AND IntegerField IN UNNEST(@integerList)";
- * QueryParameterValue stringParameter = QueryParameterValue.string("stringValue");
- * QueryParameterValue intArrayParameter =
- * QueryParameterValue.array(new Integer[] {3, 4}, Integer.class);
- * Parameter stringParam =
- * Parameter.newBuilder().setName("stringParam").setValue(stringParameter).build();
- * Parameter intArrayParam =
- * Parameter.newBuilder().setName("integerList").setValue(intArrayParameter).build();
- * List parameters = ImmutableList.of(stringParam, intArrayParam);
+ * {@code
+ * ConnectionSettings connectionSettings =
+ * ConnectionSettings.newBuilder()
+ * .setUseReadAPI(true)
+ * .build();
+ * Connection connection = bigquery.createConnection(connectionSettings);
+ * String selectQuery =
+ * "SELECT TimestampField, StringField, BooleanField FROM "
+ * + MY_TABLE
+ * + " WHERE StringField = @stringParam"
+ * + " AND IntegerField IN UNNEST(@integerList)";
+ * QueryParameterValue stringParameter = QueryParameterValue.string("stringValue");
+ * QueryParameterValue intArrayParameter =
+ * QueryParameterValue.array(new Integer[] {3, 4}, Integer.class);
+ * Parameter stringParam =
+ * Parameter.newBuilder().setName("stringParam").setValue(stringParameter).build();
+ * Parameter intArrayParam =
+ * Parameter.newBuilder().setName("integerList").setValue(intArrayParameter).build();
+ * List parameters = ImmutableList.of(stringParam, intArrayParam);
*
- * ListenableFuture executeSelectFut =
- * connection.executeSelectAsync(selectQuery, parameters);
+ * ListenableFuture executeSelectFuture =
+ * connection.executeSelectAsync(selectQuery, parameters);
* ExecuteSelectResponse executeSelectRes = executeSelectFuture.get();
*
- * if(!executeSelectRes.getIsSuccessful()){
- * throw executeSelectRes.getBigQuerySQLException();
+ * if (!executeSelectRes.getIsSuccessful()) {
+ * throw executeSelectRes.getBigQuerySQLException();
* }
*
- * BigQueryResult bigQueryResult = executeSelectRes.getBigQueryResult();
+ * BigQueryResult bigQueryResult = executeSelectRes.getResultSet();
* ResultSet rs = bigQueryResult.getResultSet();
* while (rs.next()) {
- * System.out.println(rs.getString(1));
+ * System.out.println(rs.getString("StringField"));
* }
- *
- *
+ * }
*
* @param sql SQL SELECT query
* @param parameters named or positional parameters. The set of query parameters must either be
diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Dataset.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Dataset.java
index 18606e701368..957937841f22 100644
--- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Dataset.java
+++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Dataset.java
@@ -297,7 +297,7 @@ public Page list(TableListOption... options) {
* Example of getting a table in the dataset.
*
*
{@code
- * String tableName = “my_table”;
+ * String tableName = "my_table";
* Table table = dataset.get(tableName);
* }
*
@@ -321,8 +321,8 @@ public Table get(String tableId, TableOption... options) {
* Example of creating a table in the dataset with schema and time partitioning.
*
*
{@code
- * String tableName = “my_table”;
- * String fieldName = “my_field”;
+ * String tableName = "my_table";
+ * String fieldName = "my_field";
* Schema schema = Schema.of(Field.of(fieldName, LegacySQLTypeName.STRING));
* StandardTableDefinition definition = StandardTableDefinition.newBuilder()
* .setSchema(schema)
diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/DatasetInfo.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/DatasetInfo.java
index 5dcd91c6349c..97c599d44d41 100644
--- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/DatasetInfo.java
+++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/DatasetInfo.java
@@ -180,9 +180,10 @@ public abstract Builder setDefaultEncryptionConfiguration(
* do not have explicit collation specified. A change to this field affects only tables created
* afterwards, and does not alter the existing tables. The following values are supported:
*
- * * 'und:ci': undetermined locale, case insensitive. * '': empty string. Default to
- * case-sensitive behavior. (-- A wrapper is used here because it is possible to set the value
- * to the empty string. --) (-- api-linter: standard-fields=disabled --)
+ *
+ * - {@code 'und:ci'}: undetermined locale, case insensitive.
+ *
- {@code ''}: empty string. Default to case-sensitive behavior.
+ *
*/
public abstract Builder setDefaultCollation(String defaultCollation);
diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Field.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Field.java
index e0204aae807c..c4a8bee7c2cd 100644
--- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Field.java
+++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Field.java
@@ -247,8 +247,8 @@ public Builder setScale(Long scale) {
/**
* Precision can be used to constrain the maximum number of total digits allowed for NUMERIC or
- * BIGNUMERIC types. It is invalid to set values for Precision for types other than // NUMERIC
- * or BIGNUMERIC. For NUMERIC type, acceptable values for Precision must be: 1 ≤ (Precision -
+ * BIGNUMERIC types. It is invalid to set values for Precision for types other than NUMERIC or
+ * BIGNUMERIC. For NUMERIC type, acceptable values for Precision must be: 1 ≤ (Precision -
* Scale) ≤ 29. Values for Scale must be: 0 ≤ Scale ≤ 9. For BIGNUMERIC type, acceptable values
* for Precision must be: 1 ≤ (Precision - Scale) ≤ 38. Values for Scale must be: 0 ≤ Scale ≤
* 38.
@@ -303,9 +303,10 @@ public Builder setDefaultValueExpression(String defaultValueExpression) {
* Optional. Field collation can be set only when the type of field is STRING. The following
* values are supported:
*
- * * 'und:ci': undetermined locale, case insensitive. * '': empty string. Default to
- * case-sensitive behavior. (-- A wrapper is used here because it is possible to set the value
- * to the empty string. --)
+ *
+ * - {@code 'und:ci'}: undetermined locale, case insensitive.
+ *
- {@code ''}: empty string. Default to case-sensitive behavior.
+ *
*/
public Builder setCollation(String collation) {
this.collation = collation;
diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/FieldValue.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/FieldValue.java
index b19514d106a0..db8a4bb914a6 100644
--- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/FieldValue.java
+++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/FieldValue.java
@@ -237,9 +237,8 @@ public long getTimestampValue() {
}
/**
- * Returns this field's value as a {@code String}, representing a timestamp as an Instant. This
- * method should only be used if the corresponding field has {@link LegacySQLTypeName#TIMESTAMP}
- * type.
+ * Returns this field's value as an {@link Instant}. This method should only be used if the
+ * corresponding field has {@link LegacySQLTypeName#TIMESTAMP} type.
*
* @throws ClassCastException if the field is not a primitive type
* @throws NumberFormatException if the field's value could not be converted to {@link Long}
diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/FieldValueList.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/FieldValueList.java
index 18d2155a583f..444ef16b173c 100644
--- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/FieldValueList.java
+++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/FieldValueList.java
@@ -58,7 +58,7 @@ public FieldValue get(int index) {
}
/**
- * Gets field value by index.
+ * Gets field value by name.
*
* @param name field name (defined in schema)
* @throws IllegalArgumentException if schema is not provided or if {@code name} was not found in
diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/InsertAllRequest.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/InsertAllRequest.java
index ce93800987f7..33fda8a3329d 100644
--- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/InsertAllRequest.java
+++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/InsertAllRequest.java
@@ -69,7 +69,7 @@ public final class InsertAllRequest implements Serializable {
* rowContent.put("bytesFieldName", "DQ4KDQ==");
* rowContent.put("recordFieldName", recordContent);
* rowContent.put("numericFieldName", "1298930929292.129593272");
- * RowToInsert row = new RowToInsert("rowId", rowContent);
+ * RowToInsert row = RowToInsert.of("rowId", rowContent);
* }
*
* @see
@@ -197,7 +197,7 @@ public Builder addRow(RowToInsert rowToInsert) {
* Example usage of adding a row with associated id:
*
*
{@code
- * InsertAllRequest.Builder builder = InsertAllRequest.builder(tableId);
+ * InsertAllRequest.Builder builder = InsertAllRequest.newBuilder(tableId);
* List repeatedFieldValue = Arrays.asList(1L, 2L);
* Map recordContent = new HashMap();
* recordContent.put("subfieldName1", "value");
@@ -225,7 +225,7 @@ public Builder addRow(String id, Map content) {
* Example usage of adding a row without an associated id:
*
*
{@code
- * InsertAllRequest.Builder builder = InsertAllRequest.builder(tableId);
+ * InsertAllRequest.Builder builder = InsertAllRequest.newBuilder(tableId);
* List repeatedFieldValue = Arrays.asList(1L, 2L);
* Map recordContent = new HashMap();
* recordContent.put("subfieldName1", "value");
diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Model.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Model.java
index 64ef0e4a7345..7ccf3b817471 100644
--- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Model.java
+++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Model.java
@@ -29,7 +29,7 @@
/**
* A Google BigQuery ML Model.
*
- * Objects of this class are immutable. Operations that modify the table like {@link #update}
+ *
Objects of this class are immutable. Operations that modify the model like {@link #update}
* return a new object. To get a {@code Model} object with the most recent information use {@link
* #reload}.
*/
@@ -152,7 +152,7 @@ public Model build() {
/**
* Check if this model exists.
*
- * @return {@code true} if this table exists, {@code false} otherwise
+ * @return {@code true} if this model exists, {@code false} otherwise
* @throws BigQueryException upon failure
*/
public boolean exists() {
@@ -175,7 +175,7 @@ public Model reload(ModelOption... options) {
* Updates the model's information with this model's information. Dataset and model identifiers
* cannot be updated. A new {@code Model} object is returned.
*
- * @param options dataset options
+ * @param options model options
* @return a {@code Model} object with updated information
* @throws BigQueryException upon failure
*/
diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/QueryJobConfiguration.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/QueryJobConfiguration.java
index 8fc78b3edc73..2543a55df4c0 100644
--- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/QueryJobConfiguration.java
+++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/QueryJobConfiguration.java
@@ -1238,8 +1238,8 @@ public static Builder newBuilder(String query) {
}
/**
- * Returns a BigQuery Copy Job for the given the query to be run. Job's id is chosen by the
- * service.
+ * Returns a BigQuery Query Job configuration for the given query to be run. Job's id is chosen by
+ * the service.
*/
public static QueryJobConfiguration of(String query) {
return newBuilder(query).build();
diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/QueryParameterValue.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/QueryParameterValue.java
index f847c1d6adfc..4f82fbd4508f 100644
--- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/QueryParameterValue.java
+++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/QueryParameterValue.java
@@ -201,7 +201,7 @@ public Map getStructValues() {
@Nullable
abstract Map getStructValuesInner();
- /** Returns the struct values of this parameter. The returned map, if not null, is immutable. */
+ /** Returns the range values of this parameter. */
@Nullable
public Range getRangeValues() {
return getRangeValuesInner();
diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/RemoteFunctionOptions.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/RemoteFunctionOptions.java
index 0f31e9c66296..855755305a47 100644
--- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/RemoteFunctionOptions.java
+++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/RemoteFunctionOptions.java
@@ -30,15 +30,15 @@ public abstract class RemoteFunctionOptions implements Serializable {
public abstract static class Builder {
/**
- * Sets Endpoint argument Endpoint of the user-provided remote service, e.g.
- * ```https://us-east1-my_gcf_project.cloudfunctions.net/remote_add```
+ * Sets the endpoint of the user-provided remote service, for example {@code
+ * https://us-east1-my_gcf_project.cloudfunctions.net/remote_add}.
*/
public abstract Builder setEndpoint(String endpoint);
/**
* Fully qualified name of the user-provided connection object which holds the authentication
- * information to send requests to the remote service. Format:
- * ```\"projects/{projectId}/locations/{locationId}/connections/{connectionId}\"```
+ * information to send requests to the remote service. Format: {@code
+ * projects/{projectId}/locations/{locationId}/connections/{connectionId}}.
*/
public abstract Builder setConnection(String connection);
diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Table.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Table.java
index 56c6558555f1..5e9206450b1e 100644
--- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Table.java
+++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Table.java
@@ -288,7 +288,7 @@ public Table reload(TableOption... options) {
* Table updatedTable = table.toBuilder().setDescription("new description").build().update();
* }
*
- * @param options dataset options
+ * @param options table options
* @return a {@code Table} object with updated information
* @throws BigQueryException upon failure
*/