diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Acl.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Acl.java index d52124092a83..b2315756592b 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Acl.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Acl.java @@ -34,7 +34,7 @@ * Project roles affect your ability to run jobs or manage the project, while dataset roles affect * how you can access or modify the data inside a project. * - * @see Access Control + * @see Access Control */ public final class Acl implements Serializable { @@ -47,7 +47,9 @@ public final class Acl implements Serializable { /** * Dataset roles supported by BigQuery. * - * @see Dataset Roles + * @see Dataset + * Roles */ public static final class Role extends StringEnumValue { private static final long serialVersionUID = -1992679397135956912L; @@ -298,7 +300,7 @@ public static final class Group extends Entity { /** * Creates a Group entity given its identifier. Identifier can be either a + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/datasets#Dataset.FIELDS.access"> * special group identifier or a group email. */ public Group(String identifier) { @@ -308,7 +310,7 @@ public Group(String identifier) { /** * @return Returns group's identifier, can be either a + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/datasets#Dataset.FIELDS.access"> * special group identifier or a group email. */ public String getIdentifier() { 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..85cd81cf1a64 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 @@ -45,7 +45,8 @@ public interface BigQuery extends Service, AutoCloseable { /** * Fields of a BigQuery Dataset resource. * - * @see Dataset + * @see Dataset * Resource */ enum DatasetField implements FieldSelector { @@ -116,7 +117,8 @@ public String toString() { /** * Fields of a BigQuery Table resource. * - * @see Table + * @see Table * Resource */ enum TableField implements FieldSelector { @@ -160,9 +162,8 @@ public String getSelector() { /** * Metadata of a BigQuery Table. * - * @see Table - * Resource + * @see TableMetadataView */ enum TableMetadataView { BASIC, @@ -174,7 +175,8 @@ enum TableMetadataView { /** * Fields of a BigQuery Model resource. * - * @see Model + * @see Model * Resource */ enum ModelField implements FieldSelector { @@ -209,7 +211,8 @@ public String getSelector() { /** * Fields of a BigQuery Routine resource. * - * @see Routine + * @see Routine * Resource */ enum RoutineField implements FieldSelector { @@ -242,8 +245,8 @@ public String getSelector() { /** * Fields of a BigQuery Job resource. * - * @see Job Resource - * + * @see Job + * Resource */ enum JobField implements FieldSelector { CONFIGURATION("configuration"), @@ -281,7 +284,7 @@ private DatasetListOption(BigQueryRpc.Option option, Object value) { /** * Returns an option to specify a label filter. @see Filtering + * "https://docs.cloud.google.com/bigquery/docs/filtering-labels#filtering_datasets_using_labels">Filtering * using labels * * @param labelFilter In the form "labels.key:value" @@ -351,11 +354,11 @@ public static DatasetOption fields(DatasetField... fields) { * for conditional access policy binding in datasets must specify version 3. Datasets with no * conditional role bindings in access policy may specify any valid value or leave the field * unset. This field will be mapped to IAM Policy version and will be - * used to fetch the policy from IAM. If unset or if 0 or 1 the value is used for a dataset with - * conditional bindings, access entry with condition will have role string appended by - * 'withcond' string followed by a hash value. Please refer to Troubleshooting + * href="https://docs.cloud.google.com/iam/docs/allow-policies#versions">IAM Policy version + * and will be used to fetch the policy from IAM. If unset or if 0 or 1 the value is used for a + * dataset with conditional bindings, access entry with condition will have role string appended + * by 'withcond' string followed by a hash value. Please refer to Troubleshooting * withcond for more details. */ public static DatasetOption accessPolicyVersion(Integer accessPolicyVersion) { diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQueryDryRunResult.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQueryDryRunResult.java index 0494aa1a97f4..dc0cf5bab067 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQueryDryRunResult.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/BigQueryDryRunResult.java @@ -28,7 +28,7 @@ public interface BigQueryDryRunResult { /** * Returns query parameters for standard SQL queries by extracting undeclare query parameters from * the dry run job. See more information: - * https://developers.google.com/resources/api-libraries/documentation/bigquery/v2/java/latest/com/google/api/services/bigquery/model/JobStatistics2.html#getUndeclaredQueryParameters-- + * https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/Job#JobStatistics2.FIELDS.undeclared_query_parameters */ @BetaApi List getQueryParameters() throws BigQuerySQLException; diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/ConnectionSettings.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/ConnectionSettings.java index 79bc3aac9f52..617d2fa22750 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/ConnectionSettings.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/ConnectionSettings.java @@ -80,7 +80,8 @@ public abstract class ConnectionSettings { * Returns whether nested and repeated fields should be flattened. If set to {@code false} {@link * ConnectionSettings.Builder#setAllowLargeResults(Boolean)} must be {@code true}. * - * @see Flatten + * @see Flatten */ @Nullable public abstract Boolean getFlattenResults(); @@ -103,7 +104,7 @@ public abstract class ConnectionSettings { * Returns whether the job is allowed to create new tables. * * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/Job#JobConfigurationQuery.FIELDS.create_disposition"> * Create Disposition */ @Nullable @@ -137,7 +138,8 @@ public abstract class ConnectionSettings { * query is allowed to create large results at a slight cost in performance. the query is allowed * to create large results at a slight cost in performance. * - * @see Returning + * @see Returning * Large Query Results */ @Nullable @@ -146,7 +148,8 @@ public abstract class ConnectionSettings { /** * Returns whether to create a new session. * - * @see Create Sessions + * @see Create + * Sessions */ @Nullable public abstract Boolean getCreateSession(); @@ -190,7 +193,7 @@ public abstract class ConnectionSettings { * Returns the action that should occur if the destination table already exists. * * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/Job#JobConfigurationQuery.FIELDS.write_disposition"> * Write Disposition */ @Nullable @@ -303,7 +306,7 @@ Builder withDefaultValues() { * cache is only available when {@link ConnectionSettings.Builder#setDestinationTable(TableId)} * is not set. * - * @see Query Caching + * @see Query Caching */ public abstract Builder setUseQueryCache(Boolean useQueryCache); @@ -312,7 +315,8 @@ Builder withDefaultValues() { * ConnectionSettings.Builder#setAllowLargeResults(Boolean)} must be {@code true}. By default * results are flattened. * - * @see Flatten + * @see Flatten */ public abstract Builder setFlattenResults(Boolean flattenResults); @@ -341,7 +345,7 @@ public abstract Builder setReadClientConnectionConfiguration( * Sets whether the job is allowed to create tables. * * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/Job#JobConfigurationQuery.FIELDS.create_disposition"> * Create Disposition */ public abstract Builder setCreateDisposition(CreateDisposition createDisposition); @@ -389,7 +393,8 @@ public abstract Builder setDestinationEncryptionConfiguration( * query is allowed to create large results at a slight cost in performance. If {@code true} * {@link ConnectionSettings.Builder#setDestinationTable(TableId)} must be provided. * - * @see Returning + * @see Returning * Large Query Results */ public abstract Builder setAllowLargeResults(Boolean allowLargeResults); @@ -441,7 +446,7 @@ public abstract Builder setTableDefinitions( * Sets the action that should occur if the destination table already exists. * * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/Job#JobConfigurationQuery.FIELDS.write_disposition"> * Write Disposition */ public abstract Builder setWriteDisposition(WriteDisposition writeDisposition); diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/CopyJobConfiguration.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/CopyJobConfiguration.java index 54e612271f14..8077b0616d52 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/CopyJobConfiguration.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/CopyJobConfiguration.java @@ -135,7 +135,7 @@ public Builder setDestinationTable(TableId destinationTable) { /** * Sets the supported operation types (COPY, CLONE, SNAPSHOT or RESTORE) in table copy job. More - * info: https://cloud.google.com/bigquery/docs/reference/rest/v2/Job#operationtype + * info: https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/Job#operationtype */ public Builder setOperationType(String operationType) { this.operationType = operationType; @@ -145,7 +145,7 @@ public Builder setOperationType(String operationType) { /** * Sets the time when the destination table expires. Expired tables will be deleted and their * storage reclaimed. More info: - * https://cloud.google.com/bigquery/docs/reference/rest/v2/Job#jobconfigurationtablecopy + * https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/Job#JobConfigurationTableCopy.FIELDS.destination_expiration_time */ public Builder setDestinationExpirationTime(String destinationExpirationTime) { this.destinationExpirationTime = destinationExpirationTime; @@ -162,7 +162,7 @@ public Builder setDestinationEncryptionConfiguration( * Sets whether the job is allowed to create new tables. * * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/Job#JobConfigurationTableCopy.FIELDS.create_disposition"> * Create Disposition */ public Builder setCreateDisposition(JobInfo.CreateDisposition createDisposition) { @@ -174,7 +174,7 @@ public Builder setCreateDisposition(JobInfo.CreateDisposition createDisposition) * Sets the action that should occur if the destination table already exists. * * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/Job#JobConfigurationTableCopy.FIELDS.write_disposition"> * Write Disposition */ public Builder setWriteDisposition(JobInfo.WriteDisposition writeDisposition) { @@ -267,7 +267,7 @@ public EncryptionConfiguration getDestinationEncryptionConfiguration() { * Returns whether the job is allowed to create new tables. * * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/Job#JobConfigurationTableCopy.FIELDS.create_disposition"> * Create Disposition */ public JobInfo.CreateDisposition getCreateDisposition() { @@ -278,7 +278,7 @@ public JobInfo.CreateDisposition getCreateDisposition() { * Returns the action that should occur if the destination table already exists. * * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/Job#JobConfigurationTableCopy.FIELDS.write_disposition"> * Write Disposition */ public JobInfo.WriteDisposition getWriteDisposition() { 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..89b404b7de34 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 @@ -88,7 +88,7 @@ public abstract static class Builder { /** * Sets the dataset's access control configuration. * - * @see Access Control + * @see Access Control */ public abstract Builder setAcl(List acl); @@ -123,7 +123,8 @@ public abstract static class Builder { * Sets the geographic location where the dataset should reside. This property is experimental * and might be subject to change or removed. * - * @see Dataset + * @see Dataset * Location */ public abstract Builder setLocation(String location); @@ -187,13 +188,13 @@ public abstract Builder setDefaultEncryptionConfiguration( public abstract Builder setDefaultCollation(String defaultCollation); /** - * Optional. The tags attached to this - * dataset. Tag keys are globally unique. Tag key is expected to be in the namespaced format, - * for example "123456789012/environment" where 123456789012 is the ID of the parent + * Optional. The tags attached to + * this dataset. Tag keys are globally unique. Tag key is expected to be in the namespaced + * format, for example "123456789012/environment" where 123456789012 is the ID of the parent * organization or project resource for this tag key. Tag value is expected to be the short * name, for example "Production". * - * @see Tag + * @see Tag * definitions for more details. * @param resourceTags resourceTags or {@code null} for none */ @@ -471,8 +472,8 @@ public DatasetId getDatasetId() { * bigquery.update(builder.build()); // API request. * } * - * @see Access Control - * @see Control access with IAM + * @see Access Control + * @see Control access with IAM * Conditions */ public List getAcl() { @@ -540,9 +541,7 @@ public Long getLastModified() { /** * Returns the geographic location where the dataset should reside. * - * @see - * Dataset Location + * @see Dataset Location */ public String getLocation() { return location; @@ -559,7 +558,8 @@ public String getSelfLink() { /** * Return a map for labels applied to the dataset. * - * @see Labeling Datasets + * @see + * Labeling Datasets */ public Map getLabels() { return labels.userMap(); @@ -590,13 +590,13 @@ public Long getMaxTimeTravelHours() { } /** - * Optional. The tags attached to this - * dataset. Tag keys are globally unique. Tag key is expected to be in the namespaced format, for - * example "123456789012/environment" where 123456789012 is the ID of the parent organization or - * project resource for this tag key. Tag value is expected to be the short name, for example + * Optional. The tags attached to + * this dataset. Tag keys are globally unique. Tag key is expected to be in the namespaced format, + * for example "123456789012/environment" where 123456789012 is the ID of the parent organization + * or project resource for this tag key. Tag value is expected to be the short name, for example * "Production". * - * @see Tag + * @see Tag * definitions for more details. * @return value or {@code null} for none */ diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/ExternalTableDefinition.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/ExternalTableDefinition.java index 6ed45a06535f..c3fac8a2da3b 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/ExternalTableDefinition.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/ExternalTableDefinition.java @@ -35,8 +35,8 @@ * reside outside of BigQuery but can be queried as normal BigQuery tables. External tables are * experimental and might be subject to change or removed. * - * @see Federated Data Sources - * + * @see Federated Data + * Sources */ @AutoValue public abstract class ExternalTableDefinition extends TableDefinition { @@ -99,7 +99,7 @@ public abstract static class Builder *

For Google Cloud Datastore backup URIs: Exactly one URI can be specified. Also, the '*' * wildcard character is not allowed. * - * @see Quota + * @see Quota */ public Builder setSourceUris(List sourceUris) { return setSourceUrisImmut(ImmutableList.copyOf(sourceUris)); @@ -124,7 +124,7 @@ public Builder setFileSetSpecType(String fileSetSpecType) { * formats are {@code CSV} and {@code NEWLINE_DELIMITED_JSON}. * *

+ * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/tables#ExternalDataConfiguration.FIELDS.source_format"> * Source Format */ public Builder setFormatOptions(FormatOptions formatOptions) { @@ -159,7 +159,7 @@ public Builder setFormatOptions(FormatOptions formatOptions) { * #setFormatOptions(FormatOptions)} property determines what BigQuery treats as an extra value. * * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/tables#ExternalDataConfiguration.FIELDS.ignore_unknown_values"> * Ignore Unknown Values */ public abstract Builder setIgnoreUnknownValues(Boolean ignoreUnknownValues); @@ -168,7 +168,7 @@ public Builder setFormatOptions(FormatOptions formatOptions) { * Sets compression type of the data source. By default no compression is assumed. * * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/tables#ExternalDataConfiguration.FIELDS.compression"> * Compression */ public abstract Builder setCompression(String compression); @@ -218,7 +218,7 @@ public Builder setObjectMetadata(String objectMetadata) { * external data source. * * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/tables#metadatacachemode"> * MetadataCacheMode */ public Builder setMetadataCacheMode(String metadataCacheMode) { @@ -232,7 +232,7 @@ public Builder setMetadataCacheMode(String metadataCacheMode) { * external data source. * * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/tables#Table.FIELDS.max_staleness"> * MaxStaleness */ public Builder setMaxStaleness(String maxStaleness) { @@ -289,7 +289,7 @@ public Builder setMaxStaleness(String maxStaleness) { * Returns the compression type of the data source. * * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/tables#ExternalDataConfiguration.FIELDS.compression"> * Compression */ @Nullable @@ -299,7 +299,7 @@ public Builder setMaxStaleness(String maxStaleness) { * Returns the connection ID used to connect to external data source. * * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/tables#ExternalDataConfiguration.FIELDS.connection_id"> * ConnectionId */ @Nullable @@ -313,7 +313,7 @@ public Builder setMaxStaleness(String maxStaleness) { * BigQuery treats as an extra value. * * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/tables#ExternalDataConfiguration.FIELDS.ignore_unknown_values"> * Ignore Unknown Values */ @Nullable @@ -338,7 +338,7 @@ public Boolean ignoreUnknownValues() { * to load jobs apply to external data sources, plus an additional limit of 10 GB maximum size * across all URIs. * - * @see Quota + * @see Quota */ @Nullable public List getSourceUris() { @@ -360,7 +360,7 @@ public String getFileSetSpecType() { * Returns the object metadata. * * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/tables#ExternalDataConfiguration.FIELDS.object_metadata"> * ObjectMetadata */ @Nullable @@ -375,7 +375,7 @@ public String getObjectMetadata() { * Returns the metadata cache mode. * * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/tables#metadatacachemode"> * MetadataCacheMode */ @Nullable @@ -391,7 +391,7 @@ public String getMetadataCacheMode() { * Staleness encoded as a string encoding of sql IntervalValue type. * * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/tables#Table.FIELDS.max_staleness"> * MaxStaleness */ @Nullable @@ -591,9 +591,9 @@ static Builder newBuilder() { * @param schema the schema for the external data * @param format the source format of the external data * @return a builder for an ExternalTableDefinition object given source URIs, schema and format - * @see Quota + * @see Quota * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/tables#ExternalDataConfiguration.FIELDS.source_format"> * Source Format */ public static Builder newBuilder(List sourceUris, Schema schema, FormatOptions format) { @@ -609,9 +609,9 @@ public static Builder newBuilder(List sourceUris, Schema schema, FormatO * @param schema the schema for the external data * @param format the source format of the external data * @return a builder for an ExternalTableDefinition object given source URI, schema and format - * @see Quota + * @see Quota * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/tables#ExternalDataConfiguration.FIELDS.source_format"> * Source Format */ public static Builder newBuilder(String sourceUri, Schema schema, FormatOptions format) { @@ -628,9 +628,9 @@ public static Builder newBuilder(String sourceUri, Schema schema, FormatOptions * to external data sources, plus an additional limit of 10 GB maximum size across all URIs. * @param format the source format of the external data * @return a builder for an ExternalTableDefinition object given source URIs and format - * @see Quota + * @see Quota * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/tables#ExternalDataConfiguration.FIELDS.source_format"> * Source Format */ public static Builder newBuilder(String sourceUri, FormatOptions format) { @@ -646,9 +646,9 @@ public static Builder newBuilder(String sourceUri, FormatOptions format) { * valid HTTPS URL for a Google Cloud Bigtable table. Size limits related to load jobs apply * to external data sources, plus an additional limit of 10 GB maximum size across all URIs. * @return a builder for an ExternalTableDefinition object given source URIs and format - * @see Quota + * @see Quota * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/tables#ExternalDataConfiguration.FIELDS.source_format"> * Source Format */ public static Builder newBuilder(String sourceUri) { @@ -666,9 +666,9 @@ public static Builder newBuilder(String sourceUri) { * @param schema the schema for the external data * @param format the source format of the external data * @return an ExternalTableDefinition object given source URIs, schema and format - * @see Quota + * @see Quota * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/tables#ExternalDataConfiguration.FIELDS.source_format"> * Source Format */ public static ExternalTableDefinition of( @@ -685,9 +685,9 @@ public static ExternalTableDefinition of( * @param schema the schema for the external data * @param format the source format of the external data * @return an ExternalTableDefinition object given source URIs, schema and format - * @see Quota + * @see Quota * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/tables#ExternalDataConfiguration.FIELDS.source_format"> * Source Format */ public static ExternalTableDefinition of(String sourceUri, Schema schema, FormatOptions format) { @@ -703,9 +703,9 @@ public static ExternalTableDefinition of(String sourceUri, Schema schema, Format * to external data sources, plus an additional limit of 10 GB maximum size across all URIs. * @param format the source format of the external data * @return a builder for an ExternalTableDefinition object given source URIs and format - * @see Quota + * @see Quota * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/tables#ExternalDataConfiguration.FIELDS.source_format"> * Source Format */ public static ExternalTableDefinition of(String sourceUri, FormatOptions format) { diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/ExtractJobConfiguration.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/ExtractJobConfiguration.java index d79959ee04a9..ffd1e111f617 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/ExtractJobConfiguration.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/ExtractJobConfiguration.java @@ -146,7 +146,7 @@ public Builder setFieldDelimiter(String fieldDelimiter) { * Sets the exported file format. If not set table is exported in CSV format. * *

+ * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/Job#JobConfigurationExtract.FIELDS.destination_format"> * Destination Format */ public Builder setFormat(String format) { @@ -159,7 +159,7 @@ public Builder setFormat(String format) { * compressed. * *

+ * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/Job#JobConfigurationExtract.FIELDS.compression"> * Compression */ public Builder setCompression(String compression) { @@ -252,7 +252,7 @@ public ModelId getSourceModel() { * be written. * * @see + * href="https://docs.cloud.google.com/bigquery/docs/exporting-data#exporting_data_into_one_or_more_files"> * Exporting Data Into One or More Files */ public List getDestinationUris() { 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..5edff62f5473 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 @@ -132,7 +132,8 @@ public Builder setName(String name) { * @throws IllegalArgumentException if {@code type == LegacySQLTypeName.RECORD && * subFields.length == 0} or if {@code type != LegacySQLTypeName.RECORD && subFields.length * != 0} - * @see Data + * @see Data * Types */ public Builder setType(LegacySQLTypeName type, Field... subFields) { @@ -148,7 +149,8 @@ public Builder setType(LegacySQLTypeName type, Field... subFields) { * @throws IllegalArgumentException if {@code type == StandardSQLTypeName.STRUCT && * subFields.length == 0} or if {@code type != StandardSQLTypeName.STRUCT && * subFields.length != 0} - * @see Data + * @see Data * Types */ public Builder setType(StandardSQLTypeName type, Field... subFields) { @@ -166,7 +168,8 @@ public Builder setType(StandardSQLTypeName type, Field... subFields) { * @throws IllegalArgumentException if {@code type == LegacySQLTypeName.RECORD && (subFields == * null || subFields.isEmpty())} or if {@code type != LegacySQLTypeName.RECORD && subFields * != null} - * @see Data + * @see Data * Types */ public Builder setType(LegacySQLTypeName type, FieldList subFields) { @@ -196,7 +199,8 @@ public Builder setType(LegacySQLTypeName type, FieldList subFields) { * @throws IllegalArgumentException if {@code type == StandardSQLTypeName.STRUCT && * subFields.length == 0} or if {@code type != StandardSQLTypeName.STRUCT && * subFields.length != 0} - * @see Data + * @see Data * Types */ public Builder setType(StandardSQLTypeName type, FieldList subFields) { @@ -348,7 +352,8 @@ public String getName() { /** * Returns the field type. * - * @see Data + * @see Data * Types */ public LegacySQLTypeName getType() { 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..f385b3620b44 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 @@ -431,7 +431,7 @@ static FieldValue fromPb(Object cellPb, Field recordSchema, Boolean useInt64Time * *

The parameter {@code interval} should be an interval in the canonical format: "[sign]Y-M * [sign]D [sign]H:M:S[.F]". More details + * "https://docs.cloud.google.com/bigquery/docs/reference/standard-sql/data-types#canonical_format_3"> * here * * @throws IllegalArgumentException if the {@code interval} is not a valid interval 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..4ff744c69608 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 @@ -36,7 +36,7 @@ * the delay of running a load job. There are several important trade-offs to consider before * choosing an approach. * - * @see Streaming Data into + * @see Streaming Data into * BigQuery */ public final class InsertAllRequest implements Serializable { @@ -72,7 +72,7 @@ public final class InsertAllRequest implements Serializable { * RowToInsert row = new RowToInsert("rowId", rowContent); * } * - * @see + * @see * Data Consistency */ public static class RowToInsert implements Serializable { @@ -277,8 +277,7 @@ public Builder setIgnoreUnknownValues(boolean ignoreUnknownValues) { * } * } * - * @see + * @see * Template Tables */ public Builder setTemplateSuffix(String templateSuffix) { @@ -342,7 +341,7 @@ public Boolean skipInvalidRows() { * } * } * - * @see + * @see * Template Tables */ public String getTemplateSuffix() { diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/JobInfo.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/JobInfo.java index fdf1b6e6068d..5f31556e8e7a 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/JobInfo.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/JobInfo.java @@ -29,7 +29,7 @@ * Cloud Storage. Use {@link LoadJobConfiguration} for a job that loads data from Google Cloud * Storage into a table. Use {@link QueryJobConfiguration} for a job that runs a query. * - * @see Jobs + * @see Job */ public class JobInfo implements Serializable { diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/JobStatistics.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/JobStatistics.java index 47ff140faf09..fa144f7970db 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/JobStatistics.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/JobStatistics.java @@ -835,7 +835,7 @@ public Integer getBillingTier() { /** * Returns whether the query result was fetched from the query cache. * - * @see Query Caching + * @see Query Caching */ public Boolean getCacheHit() { return cacheHit; @@ -928,7 +928,8 @@ public Long getTotalPartitionsProcessed() { * transformations on the input, and emit an output to a future stage (or the final result). The * query plan is available for a completed query job and is retained for 7 days. * - * @see Query Plan + * @see Query + * Plan */ public List getQueryPlan() { return queryPlan; diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/LegacySQLTypeName.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/LegacySQLTypeName.java index 334e3290b5e1..62888afba8b7 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/LegacySQLTypeName.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/LegacySQLTypeName.java @@ -27,7 +27,7 @@ * queries that use standard SQL, the return types are the legacy SQL types. * * @see https://cloud.google.com/bigquery/data-types + * href="https://docs.cloud.google.com/bigquery/docs/data-types">https://docs.cloud.google.com/bigquery/docs/data-types */ public final class LegacySQLTypeName extends StringEnumValue { private static final long serialVersionUID = 1421040468991161123L; 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..ceafdc2a3909 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 @@ -42,7 +42,7 @@ interface Builder { * Sets whether the job is allowed to create new tables. * * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/Job#JobConfigurationLoad.FIELDS.create_disposition"> * Create Disposition */ Builder setCreateDisposition(CreateDisposition createDisposition); @@ -51,7 +51,7 @@ interface Builder { * Sets the action that should occur if the destination table already exists. * * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/Job#JobConfigurationLoad.FIELDS.write_disposition"> * Write Disposition */ Builder setWriteDisposition(WriteDisposition writeDisposition); @@ -62,7 +62,7 @@ interface Builder { * specified, {@code CSV} format is assumed. * *

+ * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/Job#JobConfigurationLoad.FIELDS.source_format"> * Source Format */ Builder setFormatOptions(FormatOptions formatOptions); @@ -149,7 +149,7 @@ interface Builder { * Returns whether the job is allowed to create new tables. * * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/Job#JobConfigurationLoad.FIELDS.create_disposition"> * Create Disposition */ CreateDisposition getCreateDisposition(); @@ -158,7 +158,7 @@ interface Builder { * Returns the action that should occur if the destination table already exists. * * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/Job#JobConfigurationLoad.FIELDS.write_disposition"> * Write Disposition */ WriteDisposition getWriteDisposition(); @@ -167,7 +167,7 @@ interface Builder { * Returns the string that represents a null value in a CSV file. * * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/Job#JobConfigurationLoad.FIELDS.null_marker"> * Null Marker */ String getNullMarker(); diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/LoadJobConfiguration.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/LoadJobConfiguration.java index 381942cd0b73..1cb1eae9b018 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/LoadJobConfiguration.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/LoadJobConfiguration.java @@ -433,7 +433,7 @@ public Builder setFileSetSpecType(String fileSetSpecType) { * formats will result in an error. * * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/Job#columnnamecharactermap"> * ColumnNameCharacterMap */ public Builder setColumnNameCharacterMap(String columnNameCharacterMap) { @@ -719,7 +719,7 @@ public String getFileSetSpecType() { * Returns the column name character map used in CSV/Parquet loads. * * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/Job#columnnamecharactermap"> * ColumnNameCharacterMap */ public String getColumnNameCharacterMap() { diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/MetadataCacheStats.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/MetadataCacheStats.java index 482571d5f04d..bf826580f065 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/MetadataCacheStats.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/MetadataCacheStats.java @@ -26,7 +26,9 @@ /** * Represents statistics for metadata caching in BigLake tables. * - * @see BigLake Tables + * @see + * BigLake Tables */ @AutoValue public abstract class MetadataCacheStats implements Serializable { diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/ModelInfo.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/ModelInfo.java index 3039483b5245..12051d9af1b3 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/ModelInfo.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/ModelInfo.java @@ -38,7 +38,7 @@ * a CREATE MODEL query. * * @see CREATE + * href="https://docs.cloud.google.com/bigquery/docs/reference/standard-sql/bigqueryml-syntax-create">CREATE * MODEL statement */ public class ModelInfo implements Serializable { diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/ModelTableDefinition.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/ModelTableDefinition.java index 23bf66ef7b16..cf4e8f820bb3 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/ModelTableDefinition.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/ModelTableDefinition.java @@ -25,9 +25,8 @@ * A Google BigQuery Model table definition. This definition is used to represent a BigQuery ML * model. * - * @see BigQuery - * ML Model + * @see BigQuery ML + * Model */ @AutoValue @BetaApi @@ -57,9 +56,7 @@ public abstract static class Builder * Returns the geographic location where the table should reside. This value is inherited from the * dataset. * - * @see - * Dataset Location + * @see Dataset Location */ @Nullable public abstract String getLocation(); diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/ParquetOptions.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/ParquetOptions.java index cc85eeda6829..90b24a29963f 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/ParquetOptions.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/ParquetOptions.java @@ -67,7 +67,8 @@ public Builder setEnumAsString(Boolean enumAsString) { /** * [Optional] Indicates how to represent a Parquet map if present. * - * @see + * @see * MapTargetType */ public Builder setMapTargetType(String mapTargetType) { diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Project.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Project.java index 6020a8d14cf1..6ce1a9f07b32 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Project.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Project.java @@ -30,7 +30,8 @@ *

Objects of this class can be obtained by listing projects accessible to the caller using * {@link BigQuery#listProjects(BigQuery.ProjectListOption...)}. * - * @see Projects: + * @see Projects: * list */ @BetaApi 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..1868291d27b3 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 @@ -86,8 +86,8 @@ public final class QueryJobConfiguration extends JobConfiguration { public enum Priority { /** * Query is executed as soon as possible and count towards the concurrent rate limit and the daily - * rate limit. + * href="https://docs.cloud.google.com/bigquery/quotas#query_jobs">concurrent rate limit and the + * daily rate limit. */ INTERACTIVE, @@ -454,7 +454,7 @@ public Builder setUserDefinedFunctions(List userDefinedFunc * Sets whether the job is allowed to create tables. * * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/Job#JobConfigurationQuery.FIELDS.create_disposition"> * Create Disposition */ public Builder setCreateDisposition(CreateDisposition createDisposition) { @@ -466,7 +466,7 @@ public Builder setCreateDisposition(CreateDisposition createDisposition) { * Sets the action that should occur if the destination table already exists. * * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/Job#JobConfigurationQuery.FIELDS.write_disposition"> * Write Disposition */ public Builder setWriteDisposition(WriteDisposition writeDisposition) { @@ -515,7 +515,8 @@ public Builder setCreateSession(Boolean createSession) { * query is allowed to create large results at a slight cost in performance. If {@code true} * {@link Builder#setDestinationTable(TableId)} must be provided. * - * @see Returning + * @see Returning * Large Query Results */ public Builder setAllowLargeResults(Boolean allowLargeResults) { @@ -528,7 +529,7 @@ public Builder setAllowLargeResults(Boolean allowLargeResults) { * cache that will be flushed whenever tables in the query are modified. Moreover, the query * cache is only available when {@link Builder#setDestinationTable(TableId)} is not set. * - * @see Query Caching + * @see Query Caching */ public Builder setUseQueryCache(Boolean useQueryCache) { this.useQueryCache = useQueryCache; @@ -540,7 +541,8 @@ public Builder setUseQueryCache(Boolean useQueryCache) { * Builder#setAllowLargeResults(Boolean)} must be {@code true}. By default results are * flattened. * - * @see Flatten + * @see Flatten */ public Builder setFlattenResults(Boolean flattenResults) { this.flattenResults = flattenResults; @@ -560,8 +562,8 @@ public Builder setDryRun(Boolean dryRun) { /** * Sets whether to use BigQuery's legacy SQL dialect for this query. By default this property is * set to {@code false}. If set to {@code false}, the query will use BigQuery's Standard SQL. When set to {@code - * false}, the values of {@link #setAllowLargeResults(Boolean)} and {@link + * href="https://docs.cloud.google.com/bigquery/docs/introduction-sql">Standard SQL. When + * set to {@code false}, the values of {@link #setAllowLargeResults(Boolean)} and {@link * #setFlattenResults(Boolean)} are ignored; query will be run as if {@link * #setAllowLargeResults(Boolean)} is {@code true} and {@link #setFlattenResults(Boolean)} is * {@code false}. @@ -802,7 +804,8 @@ private QueryJobConfiguration(Builder builder) { * query is allowed to create large results at a slight cost in performance. the query is allowed * to create large results at a slight cost in performance. * - * @see Returning + * @see Returning * Large Query Results */ public Boolean allowLargeResults() { @@ -812,7 +815,8 @@ public Boolean allowLargeResults() { /** * Returns whether to create a new session. * - * @see Create Sessions + * @see Create + * Sessions */ public Boolean createSession() { return createSession; @@ -822,7 +826,7 @@ public Boolean createSession() { * Returns whether the job is allowed to create new tables. * * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/Job#JobConfigurationQuery.FIELDS.create_disposition"> * Create Disposition */ public CreateDisposition getCreateDisposition() { @@ -853,7 +857,8 @@ public EncryptionConfiguration getDestinationEncryptionConfiguration() { * Returns whether nested and repeated fields should be flattened. If set to {@code false} {@link * Builder#setAllowLargeResults(Boolean)} must be {@code true}. * - * @see Flatten + * @see Flatten */ public Boolean flattenResults() { return flattenResults; @@ -894,7 +899,7 @@ public Map getTableDefinitions() { * cache that will be flushed whenever tables in the query are modified. Moreover, the query cache * is only available when {@link Builder#setDestinationTable(TableId)} is not set. * - * @see Query Caching + * @see Query Caching */ public Boolean useQueryCache() { return useQueryCache; @@ -913,7 +918,7 @@ public List getUserDefinedFunctions() { * Returns the action that should occur if the destination table already exists. * * @see + * href="https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/Job#JobConfigurationQuery.FIELDS.write_disposition"> * Write Disposition */ public WriteDisposition getWriteDisposition() { @@ -932,9 +937,9 @@ public Boolean dryRun() { /** * Returns whether to use BigQuery's legacy SQL dialect for this query. By default this property * is set to {@code false}. If set to {@code false}, the query will use BigQuery's Standard SQL. When set to {@code - * false}, the values of {@link #allowLargeResults()} and {@link #flattenResults()} are ignored; - * query will be run as if {@link #allowLargeResults()} is {@code true} and {@link + * href="https://docs.cloud.google.com/bigquery/docs/introduction-sql">Standard SQL. When set + * to {@code false}, the values of {@link #allowLargeResults()} and {@link #flattenResults()} are + * ignored; query will be run as if {@link #allowLargeResults()} is {@code true} and {@link * #flattenResults()} is {@code false}. If set to {@code null} or {@code true}, legacy SQL dialect * is used. This property is experimental and might be subject to change. */ diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/QueryStage.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/QueryStage.java index 5fc37b98e2b5..12e174efe129 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/QueryStage.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/QueryStage.java @@ -33,7 +33,7 @@ * and emit an output to a future stage (or the final result). This class contains information on a * query stage. * - * @see Query Plan + * @see Query Plan */ public class QueryStage implements Serializable { @@ -56,7 +56,8 @@ public ExplainQueryStage apply(QueryStage stage) { /** * Each query stage is made of a number of steps. This class contains information on a query step. * - * @see Steps + * @see Steps * Metadata */ public static class QueryStep implements Serializable { @@ -88,7 +89,8 @@ public ExplainQueryStep apply(QueryStep stage) { /** * Returns a machine-readable name for the operation. * - * @see Steps + * @see Steps * Metadata */ public String getName() { diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/RoutineInfo.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/RoutineInfo.java index c13b90b41336..14a4ab758946 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/RoutineInfo.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/RoutineInfo.java @@ -36,10 +36,10 @@ * stored procedures. * *

For more information about the REST representation of routines, see: - * https://cloud.google.com/bigquery/docs/reference/rest/v2/routines + * https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/routines * *

For more information about working with scalar functions, see: - * https://cloud.google.com/bigquery/docs/reference/standard-sql/user-defined-functions + * https://docs.cloud.google.com/bigquery/docs/user-defined-functions */ public class RoutineInfo implements Serializable { @@ -84,7 +84,7 @@ public abstract static class Builder { /** * Sets the routine type for the Builder (e.g. SCALAR_FUNCTION). * - *

See https://cloud.google.com/bigquery/docs/reference/rest/v2/routines + *

See https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/routines#routinetype */ public abstract Builder setRoutineType(String routineType); @@ -163,7 +163,8 @@ public abstract static class Builder { /** * Sets the data governance type for the Builder (e.g. DATA_MASKING). * - *

See https://cloud.google.com/bigquery/docs/reference/rest/v2/routines + *

See + * https://docs.cloud.google.com/bigquery/docs/reference/rest/v2/routines#datagovernancetype */ public abstract Builder setDataGovernanceType(String dataGovernanceType); diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/StandardSQLDataType.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/StandardSQLDataType.java index 99ed10af1461..ca80de997a52 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/StandardSQLDataType.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/StandardSQLDataType.java @@ -34,7 +34,8 @@ public abstract static class Builder { /** * Sets the top-level type of this data type. Can be any standard SQL data type. For more - * information, see https://cloud.google.com/bigquery/docs/reference/standard-sql/data-types + * information, see + * https://docs.cloud.google.com/bigquery/docs/reference/standard-sql/data-types */ public abstract Builder setTypeKind(String typeKind); @@ -46,7 +47,7 @@ public abstract static class Builder { * Returns the type kind of the data type. * *

Can be any standard SQL data type. For more information, see - * https://cloud.google.com/bigquery/docs/reference/standard-sql/data-types + * https://docs.cloud.google.com/bigquery/docs/reference/standard-sql/data-types */ public abstract String getTypeKind(); diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/StandardSQLTypeName.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/StandardSQLTypeName.java index 1f70183cdc55..18c5deb1f4f4 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/StandardSQLTypeName.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/StandardSQLTypeName.java @@ -21,7 +21,7 @@ * parameters, which requires usage of standard SQL. * * @see https://cloud.google.com/bigquery/docs/reference/standard-sql/data-types + * href="https://docs.cloud.google.com/bigquery/docs/reference/standard-sql/data-types">https://docs.cloud.google.com/bigquery/docs/reference/standard-sql/data-types */ public enum StandardSQLTypeName { /** A Boolean value (true or false). */ diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/StandardTableDefinition.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/StandardTableDefinition.java index 0319a6a4dd9d..27e24c002116 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/StandardTableDefinition.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/StandardTableDefinition.java @@ -32,7 +32,7 @@ * fields. Every table is described by a schema that describes field names, types, and other * information. * - * @see Managing Tables + * @see Managing Tables */ @AutoValue public abstract class StandardTableDefinition extends TableDefinition { @@ -194,7 +194,7 @@ public abstract static class Builder /** * Returns the number of bytes considered "long-term storage" for reduced billing purposes. * - * @see Long Term Storage + * @see Long Term Storage * Pricing */ @Nullable @@ -203,7 +203,7 @@ public abstract static class Builder /** * Returns the number of time travel physical bytes. * - * @see Storage Pricing + * @see Storage Pricing */ @Nullable public abstract Long getNumTimeTravelPhysicalBytes(); @@ -211,7 +211,7 @@ public abstract static class Builder /** * Returns the number of total logical bytes. * - * @see Storage Pricing + * @see Storage Pricing */ @Nullable public abstract Long getNumTotalLogicalBytes(); @@ -219,7 +219,7 @@ public abstract static class Builder /** * Returns the number of active logical bytes. * - * @see Storage Pricing + * @see Storage Pricing */ @Nullable public abstract Long getNumActiveLogicalBytes(); @@ -227,7 +227,7 @@ public abstract static class Builder /** * Returns the number of long term logical bytes. * - * @see Storage Pricing + * @see Storage Pricing */ @Nullable public abstract Long getNumLongTermLogicalBytes(); @@ -235,7 +235,7 @@ public abstract static class Builder /** * Returns the number of total physical bytes. * - * @see Storage Pricing + * @see Storage Pricing */ @Nullable public abstract Long getNumTotalPhysicalBytes(); @@ -243,7 +243,7 @@ public abstract static class Builder /** * Returns the number of active physical bytes. * - * @see Storage Pricing + * @see Storage Pricing */ @Nullable public abstract Long getNumActivePhysicalBytes(); @@ -251,7 +251,7 @@ public abstract static class Builder /** * Returns the number of long term physical bytes. * - * @see Storage Pricing + * @see Storage Pricing */ @Nullable public abstract Long getNumLongTermPhysicalBytes(); @@ -264,9 +264,7 @@ public abstract static class Builder * Returns the geographic location where the table should reside. This value is inherited from the * dataset. * - * @see - * Dataset Location + * @see Dataset Location */ @Nullable public abstract String getLocation(); diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/TableDefinition.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/TableDefinition.java index 1fa902498795..a0e9f2f43d68 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/TableDefinition.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/TableDefinition.java @@ -53,7 +53,7 @@ public Type apply(String constant) { * A virtual table defined by a SQL query. Instances of {@code TableDefinition} for this type * are implemented by {@link ViewDefinition}. * - * @see Views + * @see Views */ public static final Type VIEW = type.createAndRegister("VIEW"); @@ -61,7 +61,8 @@ public Type apply(String constant) { * SQL query whose result is persisted. Instances of {@code MaterializedViewDefinition} for this * type are implemented by {@link MaterializedViewDefinition}. * - * @see Views + * @see + * Materialized Views */ public static final Type MATERIALIZED_VIEW = type.createAndRegister("MATERIALIZED_VIEW"); @@ -69,17 +70,16 @@ public Type apply(String constant) { * A BigQuery table backed by external data. Instances of {@code TableDefinition} for this type * are implemented by {@link ExternalTableDefinition}. * - * @see Federated Data - * Sources + * @see Federated + * Data Sources */ public static final Type EXTERNAL = type.createAndRegister("EXTERNAL"); /** * A BigQuery table representing BigQuery ML Model. * - * @see - * BigQuery ML Model + * @see BigQuery ML + * Model */ public static final Type MODEL = type.createAndRegister("MODEL"); 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..5de42eb95791 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 @@ -36,7 +36,7 @@ * table. Use {@link ViewDefinition} to create a BigQuery view. Use {@link ExternalTableDefinition} * to create a BigQuery a table backed by external data. * - * @see Managing Tables + * @see Managing Tables */ public class TableInfo implements Serializable { @@ -541,7 +541,7 @@ public Long getNumBytes() { /** * Returns the number of bytes considered "long-term storage" for reduced billing purposes. * - * @see Long Term Storage + * @see Long Term Storage * Pricing */ public Long getNumLongTermBytes() { @@ -551,7 +551,7 @@ public Long getNumLongTermBytes() { /** * Returns the number of time travel physical bytes. * - * @see Storage Pricing + * @see Storage Pricing */ public Long getNumTimeTravelPhysicalBytes() { return this.numTimeTravelPhysicalBytes; @@ -560,7 +560,7 @@ public Long getNumTimeTravelPhysicalBytes() { /** * Returns the number of total logical bytes. * - * @see Storage Pricing + * @see Storage Pricing */ public Long getNumTotalLogicalBytes() { return this.numTotalLogicalBytes; @@ -569,7 +569,7 @@ public Long getNumTotalLogicalBytes() { /** * Returns the number of active logical bytes. * - * @see Storage Pricing + * @see Storage Pricing */ public Long getNumActiveLogicalBytes() { return this.numActiveLogicalBytes; @@ -578,7 +578,7 @@ public Long getNumActiveLogicalBytes() { /** * Returns the number of long term logical bytes. * - * @see Storage Pricing + * @see Storage Pricing */ public Long getNumLongTermLogicalBytes() { return this.numLongTermLogicalBytes; @@ -587,7 +587,7 @@ public Long getNumLongTermLogicalBytes() { /** * Returns the number of total physical bytes. * - * @see Storage Pricing + * @see Storage Pricing */ public Long getNumTotalPhysicalBytes() { return this.numTotalPhysicalBytes; @@ -596,7 +596,7 @@ public Long getNumTotalPhysicalBytes() { /** * Returns the number of active physical bytes. * - * @see Storage Pricing + * @see Storage Pricing */ public Long getNumActivePhysicalBytes() { return this.numActivePhysicalBytes; @@ -605,7 +605,7 @@ public Long getNumActivePhysicalBytes() { /** * Returns the number of long term physical bytes. * - * @see Storage Pricing + * @see Storage Pricing */ public Long getNumLongTermPhysicalBytes() { return this.numLongTermPhysicalBytes; diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/TimePartitioning.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/TimePartitioning.java index e874bc30be62..d600849ab853 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/TimePartitioning.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/TimePartitioning.java @@ -29,7 +29,8 @@ * table into smaller partitions, you can improve query performance and reduce the number of bytes * billed by restricting the amount of data scanned. * - * @see Partitioned Tables + * @see Partitioned + * Tables */ @AutoValue public abstract class TimePartitioning implements Serializable { diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/UserDefinedFunction.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/UserDefinedFunction.java index fb633d3bfb75..8081f08833d6 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/UserDefinedFunction.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/UserDefinedFunction.java @@ -28,8 +28,8 @@ * and produces zero or more rows as output. The output can potentially have a different schema than * the input. * - * @see User-Defined Functions - * + * @see User-Defined + * Functions */ public abstract class UserDefinedFunction implements Serializable { diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/ViewDefinition.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/ViewDefinition.java index eee06fdaff4e..41285e8a2233 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/ViewDefinition.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/ViewDefinition.java @@ -28,7 +28,7 @@ * views, which means that the query that defines the view is re-executed every time the view is * queried. * - * @see Views + * @see Views */ @AutoValue public abstract class ViewDefinition extends TableDefinition { @@ -43,7 +43,8 @@ public abstract static class Builder extends TableDefinition.BuilderUser-Defined + * @see User-Defined * Functions */ public Builder setUserDefinedFunctions(List userDefinedFunctions) { @@ -53,7 +54,8 @@ public Builder setUserDefinedFunctions(List userDefinedFunc /** * Sets user defined functions that can be used by {@link #getQuery()}. * - * @see User-Defined + * @see User-Defined * Functions */ public Builder setUserDefinedFunctions(UserDefinedFunction... userDefinedFunctions) { @@ -66,7 +68,7 @@ abstract Builder setUserDefinedFunctionsImmut( /** * Sets whether to use BigQuery's legacy SQL dialect for this query. By default this property is * set to {@code false}. If set to {@code false}, the query will use BigQuery's Standard SQL. + * href="https://docs.cloud.google.com/bigquery/docs/introduction-sql">Standard SQL. * *

If set to {@code null} or {@code true}, legacy SQL dialect is used. This property is * experimental and might be subject to change. @@ -91,8 +93,8 @@ abstract Builder setUserDefinedFunctionsImmut( * Returns user defined functions that can be used by {@link #getQuery()}. Returns {@code null} if * not set. * - * @see User-Defined Functions - * + * @see User-Defined + * Functions */ public List getUserDefinedFunctions() { return getUserDefinedFunctionsImmut(); @@ -104,9 +106,9 @@ public List getUserDefinedFunctions() { /** * Returns whether to use BigQuery's legacy SQL dialect for this query. By default this property * is set to {@code false}. If set to {@code false}, the query will use BigQuery's Standard SQL. If set to {@code - * null} or {@code true}, legacy SQL dialect is used. This property is experimental and might be - * subject to change. + * href="https://docs.cloud.google.com/bigquery/docs/introduction-sql">Standard SQL. If set to + * {@code null} or {@code true}, legacy SQL dialect is used. This property is experimental and + * might be subject to change. */ @Nullable public Boolean useLegacySql() { diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/spi/v2/HttpBigQueryRpc.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/spi/v2/HttpBigQueryRpc.java index 526e24140408..79fb3f655a30 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/spi/v2/HttpBigQueryRpc.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/spi/v2/HttpBigQueryRpc.java @@ -93,7 +93,7 @@ public class HttpBigQueryRpc implements BigQueryRpc { private static final String BASE_RESUMABLE_URI = "upload/bigquery/v2/projects/"; static final String RESOURCE_PROJECT_PREFIX = "//bigquery.googleapis.com/projects/"; // see: - // https://cloud.google.com/bigquery/loading-data-post-request#resume-upload + // https://docs.cloud.google.com/bigquery/docs/reference/api-uploads#resume-upload private static final int HTTP_RESUME_INCOMPLETE = 308; private final BigQueryOptions options; private final Bigquery bigquery;