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..690f1f79b5d5 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 @@ -1601,16 +1601,6 @@ TableResult listTableData( * } * } * - * This method supports query-related preview features via environmental variables (enabled by - * setting the {@code QUERY_PREVIEW_ENABLED} environment variable to "TRUE"). Specifically, this - * method supports: - * - * - * - * The behaviour of these preview features is controlled by the bigquery service as well - * * @throws BigQueryException upon failure * @throws InterruptedException if the current thread gets interrupted while waiting for the query * to complete 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..ea5fcdbda4fd 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 @@ -35,9 +35,11 @@ /** * Google BigQuery Dataset information. A dataset is a grouping mechanism that holds zero or more - * tables. Datasets are the lowest level unit of access control; you cannot control access at the - * table level. + * tables. Access controls can be configured at the dataset level as well as on individual resources + * such as tables and views. * + * @see + * Control access to resources with IAM * @see * Managing Jobs, Datasets, and Projects */ diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/InsertAllResponse.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/InsertAllResponse.java index 9a75f5cbd6ae..471bf7e39d2a 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/InsertAllResponse.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/InsertAllResponse.java @@ -65,8 +65,8 @@ public List getErrorsFor(long index) { } /** - * Returns {@code true} if no row insertion failed, {@code false} otherwise. If {@code false} - * {@link #getInsertErrors()} returns an empty map. + * Returns {@code true} if one or more row insertions failed, {@code false} otherwise. If {@code + * false}, {@link #getInsertErrors()} returns an empty map. */ public boolean hasErrors() { return !insertErrors.isEmpty(); diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/LoadConfiguration.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/LoadConfiguration.java index 58cf986706a5..a03ba0fdb51b 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/LoadConfiguration.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/LoadConfiguration.java @@ -95,7 +95,7 @@ interface Builder { * Sets whether BigQuery should allow extra values that are not represented in the table schema. * If {@code true}, the extra values are ignored. If {@code false}, records with extra columns * are treated as bad records, and if there are too many bad records, an invalid error is - * returned in the job result. By default unknown values are not allowed. + * returned in the job result. Defaults to {@code false} (unknown values are not allowed). */ Builder setIgnoreUnknownValues(Boolean ignoreUnknownValues); @@ -193,9 +193,9 @@ interface Builder { /** * Returns whether BigQuery should allow extra values that are not represented in the table - * schema. If {@code true}, the extra values are ignored. If {@code true}, records with extra + * schema. If {@code true}, the extra values are ignored. If {@code false}, records with extra * columns are treated as bad records, and if there are too many bad records, an invalid error is - * returned in the job result. By default unknown values are not allowed. + * returned in the job result. Defaults to {@code false} (unknown values are not allowed). */ Boolean ignoreUnknownValues(); 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..454cd2c5bc74 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 @@ -73,7 +73,8 @@ * calling {@link #of(Object, StandardSQLTypeName)} with the value and a particular * StandardSQLTypeName enum value. * - *

Struct parameters are currently not supported. + *

Use {@link #array(Object[], StandardSQLTypeName)} for array parameters and {@link + * #struct(Map)} for struct parameters. */ @AutoValue public abstract class QueryParameterValue implements Serializable { diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Range.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Range.java index 8d244fbeb069..78ca8cad5806 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Range.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Range.java @@ -23,13 +23,21 @@ import java.io.Serializable; import javax.annotation.Nullable; +/** + * Represents a BigQuery {@code RANGE} value, which defines a contiguous range between two {@code + * DATE}, {@code DATETIME}, or {@code TIMESTAMP} bounds. + * + * @see BigQuery + * Range type + */ @AutoValue public abstract class Range implements Serializable { private static final long serialVersionUID = 1L; /** Returns the start value of the range. A null value represents an unbounded start. */ public FieldValue getStart() { - // The supported Range types [DATE, TIME, TIMESTAMP] are all Attribute.PRIMITIVE. + // The supported Range types [DATE, DATETIME, TIMESTAMP] are all Attribute.PRIMITIVE. return FieldValue.of(Attribute.PRIMITIVE, getStartInner()); } @@ -38,7 +46,7 @@ public FieldValue getStart() { /** Returns the end value of the range. A null value represents an unbounded end. */ public FieldValue getEnd() { - // The supported Range types [DATE, TIME, TIMESTAMP] are all Attribute.PRIMITIVE. + // The supported Range types [DATE, DATETIME, TIMESTAMP] are all Attribute.PRIMITIVE. return FieldValue.of(Attribute.PRIMITIVE, getEndInner()); } @@ -96,7 +104,11 @@ public static Range of(String value) throws IllegalArgumentException { * Creates an instance of {@code Range} from a string representation. * *

The expected string format is: "[start, end)", where start and end are string format of - * [DATE, TIME, TIMESTAMP]. + * [DATE, DATETIME, TIMESTAMP]. + * + * @see BigQuery + * Range type */ public static Range of(String value, FieldElementType type) throws IllegalArgumentException { checkNotNull(value); diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/TableInfo.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/TableInfo.java index b3236f4c3d59..cba38ec86010 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/TableInfo.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/TableInfo.java @@ -145,12 +145,12 @@ public abstract static class Builder { /** * Sets the labels applied to this table. * - *

Unstable, because labels are experimental. - * *

When used with {@link BigQuery#update(TableInfo, TableOption...)}, setting {@code labels} * to {@code null} removes all labels; otherwise all keys that are mapped to {@code null} values * are removed and other keys are updated to their respective values. + * + * @see Introduction to + * labels */ @BetaApi public abstract Builder setLabels(Map labels); @@ -619,8 +619,8 @@ public BigInteger getNumRows() { /** * Return a map for labels applied to the table. * - *

Unstable, because labels are experimental. + * @see Introduction to + * labels */ @BetaApi public Map getLabels() {