You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@beam.apache.org by da...@apache.org on 2025/09/23 15:33:33 UTC
(beam) branch users/damccorm/bq-docs created (now 908dd9e4714)
This is an automated email from the ASF dual-hosted git repository.
damccorm pushed a change to branch users/damccorm/bq-docs
in repository https://gitbox.apache.org/repos/asf/beam.git
at 908dd9e4714 Make BQ docs consistent
This branch includes the following new commits:
new 908dd9e4714 Make BQ docs consistent
The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
(beam) 01/01: Make BQ docs consistent
Posted by da...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
damccorm pushed a commit to branch users/damccorm/bq-docs
in repository https://gitbox.apache.org/repos/asf/beam.git
commit 908dd9e4714a266f727bc52ccdc8e2b70f516bce
Author: Danny Mccormick <da...@google.com>
AuthorDate: Tue Sep 23 11:33:15 2025 -0400
Make BQ docs consistent
---
.../extensions/sql/meta/provider/bigquery/BigQueryTableProvider.java | 2 +-
.../java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryHelpers.java | 4 ++--
.../src/main/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryIO.java | 4 ++--
.../java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryHelpersTest.java | 2 +-
.../en/documentation/dsls/sql/extensions/create-external-table.md | 2 +-
.../www/site/content/en/documentation/io/built-in/google-bigquery.md | 2 +-
6 files changed, 8 insertions(+), 8 deletions(-)
diff --git a/sdks/java/extensions/sql/src/main/java/org/apache/beam/sdk/extensions/sql/meta/provider/bigquery/BigQueryTableProvider.java b/sdks/java/extensions/sql/src/main/java/org/apache/beam/sdk/extensions/sql/meta/provider/bigquery/BigQueryTableProvider.java
index 2f6e6d1d886..0bf51f70d19 100644
--- a/sdks/java/extensions/sql/src/main/java/org/apache/beam/sdk/extensions/sql/meta/provider/bigquery/BigQueryTableProvider.java
+++ b/sdks/java/extensions/sql/src/main/java/org/apache/beam/sdk/extensions/sql/meta/provider/bigquery/BigQueryTableProvider.java
@@ -38,7 +38,7 @@ import org.apache.beam.sdk.io.gcp.bigquery.BigQueryUtils.ConversionOptions.Trunc
* )
* TYPE 'bigquery'
* COMMENT 'this is the table orders'
- * LOCATION '[PROJECT_ID]:[DATASET].[TABLE]'
+ * LOCATION '[project_id].[DATASET].[TABLE]'
* }</pre>
*/
@AutoService(TableProvider.class)
diff --git a/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryHelpers.java b/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryHelpers.java
index d468ffbea43..284deffe349 100644
--- a/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryHelpers.java
+++ b/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryHelpers.java
@@ -455,7 +455,7 @@ public class BigQueryHelpers {
}
/**
- * Parse a table specification in the form {@code "[project_id]:[dataset_id].[table_id]"} or
+ * Parse a table specification in the form {@code "[project_id].[dataset_id].[table_id]"} or
* {@code "[project_id].[dataset_id].[table_id]"} or {@code "[dataset_id].[table_id]"}.
*
* <p>If the project id is omitted, the default project id is used.
@@ -469,7 +469,7 @@ public class BigQueryHelpers {
throw new IllegalArgumentException(
String.format(
"Table specification [%s] is not in one of the expected formats ("
- + " [project_id]:[dataset_id].[table_id],"
+ + " [project_id].[dataset_id].[table_id],"
+ " [project_id].[dataset_id].[table_id],"
+ " [dataset_id].[table_id])",
tableSpec));
diff --git a/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryIO.java b/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryIO.java
index e8bf4ebc4f7..84b33ec8eeb 100644
--- a/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryIO.java
+++ b/sdks/java/io/google-cloud-platform/src/main/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryIO.java
@@ -597,7 +597,7 @@ public class BigQueryIO {
private static final String TABLE_REGEXP = "[-_\\p{L}\\p{N}\\p{M}$@ ]{1,1024}";
/**
- * Matches table specifications in the form {@code "[project_id]:[dataset_id].[table_id]"} or
+ * Matches table specifications in the form {@code "[project_id].[dataset_id].[table_id]"} or
* {@code "[dataset_id].[table_id]"}.
*/
private static final String DATASET_TABLE_REGEXP =
@@ -853,7 +853,7 @@ public class BigQueryIO {
}
/**
- * Reads a BigQuery table specified as {@code "[project_id]:[dataset_id].[table_id]"} or {@code
+ * Reads a BigQuery table specified as {@code "[project_id].[dataset_id].[table_id]"} or {@code
* "[dataset_id].[table_id]"} for tables within the current project.
*/
public Read from(String tableSpec) {
diff --git a/sdks/java/io/google-cloud-platform/src/test/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryHelpersTest.java b/sdks/java/io/google-cloud-platform/src/test/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryHelpersTest.java
index 0d36d7bb46d..c5e9672dc5b 100644
--- a/sdks/java/io/google-cloud-platform/src/test/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryHelpersTest.java
+++ b/sdks/java/io/google-cloud-platform/src/test/java/org/apache/beam/sdk/io/gcp/bigquery/BigQueryHelpersTest.java
@@ -105,7 +105,7 @@ public class BigQueryHelpersTest {
public void testTableParsingError0() {
String expectedMessage =
"Table specification [foo_bar_baz] is not in one of the expected formats ("
- + " [project_id]:[dataset_id].[table_id],"
+ + " [project_id].[dataset_id].[table_id],"
+ " [project_id].[dataset_id].[table_id],"
+ " [dataset_id].[table_id])";
diff --git a/website/www/site/content/en/documentation/dsls/sql/extensions/create-external-table.md b/website/www/site/content/en/documentation/dsls/sql/extensions/create-external-table.md
index ad6ba66beb2..accee8bd6b0 100644
--- a/website/www/site/content/en/documentation/dsls/sql/extensions/create-external-table.md
+++ b/website/www/site/content/en/documentation/dsls/sql/extensions/create-external-table.md
@@ -88,7 +88,7 @@ tableElement: columnName fieldType [ NOT NULL ]
```
CREATE EXTERNAL TABLE [ IF NOT EXISTS ] tableName (tableElement [, tableElement ]*)
TYPE bigquery
-LOCATION '[PROJECT_ID]:[DATASET].[TABLE]'
+LOCATION '[project_id].[DATASET].[TABLE]'
TBLPROPERTIES '{"method": "DIRECT_READ"}'
```
diff --git a/website/www/site/content/en/documentation/io/built-in/google-bigquery.md b/website/www/site/content/en/documentation/io/built-in/google-bigquery.md
index f53fc5eb72f..3b5ba144695 100644
--- a/website/www/site/content/en/documentation/io/built-in/google-bigquery.md
+++ b/website/www/site/content/en/documentation/io/built-in/google-bigquery.md
@@ -98,7 +98,7 @@ object.
#### Using a string
To specify a table with a string, use the format
-`[project_id]:[dataset_id].[table_id]` to specify the fully-qualified BigQuery
+`[project_id].[dataset_id].[table_id]` to specify the fully-qualified BigQuery
table name.
{{< highlight java >}}