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: - * - *
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 Unstable, because labels are experimental.
+ * @see Introduction to
+ * labels
*/
@BetaApi
public Map