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 */