Skip to content

Commit 46a121f

Browse files
authored
docs: Update Bigquery clustering docstrings (#11232)
1 parent 49c5814 commit 46a121f

File tree

3 files changed

+12
-12
lines changed

3 files changed

+12
-12
lines changed

airflow/providers/google/cloud/hooks/bigquery.py

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -317,8 +317,8 @@ def create_empty_table( # pylint: disable=too-many-arguments
317317
https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#timePartitioning
318318
:type time_partitioning: dict
319319
:param cluster_fields: [Optional] The fields used for clustering.
320-
Must be specified with time_partitioning, data in the table will be first
321-
partitioned and subsequently clustered.
320+
BigQuery supports clustering for both partitioned and
321+
non-partitioned tables.
322322
https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#clustering.fields
323323
:type cluster_fields: list
324324
:param view: [Optional] A dictionary containing definition for the view.
@@ -1624,8 +1624,8 @@ def run_load( # pylint: disable=too-many-locals,too-many-arguments,invalid-name
16241624
partition by field, type and expiration as per API specifications.
16251625
:type time_partitioning: dict
16261626
:param cluster_fields: Request that the result of this load be stored sorted
1627-
by one or more columns. This is only available in combination with
1628-
time_partitioning. The order of columns given determines the sort order.
1627+
by one or more columns. BigQuery supports clustering for both partitioned and
1628+
non-partitioned tables. The order of columns given determines the sort order.
16291629
:type cluster_fields: list[str]
16301630
:param encryption_configuration: [Optional] Custom encryption configuration (e.g., Cloud KMS keys).
16311631
**Example**: ::
@@ -2033,8 +2033,8 @@ def run_query(
20332033
partition by field, type and expiration as per API specifications.
20342034
:type time_partitioning: dict
20352035
:param cluster_fields: Request that the result of this query be stored sorted
2036-
by one or more columns. This is only available in combination with
2037-
time_partitioning. The order of columns given determines the sort order.
2036+
by one or more columns. BigQuery supports clustering for both partitioned and
2037+
non-partitioned tables. The order of columns given determines the sort order.
20382038
:type cluster_fields: list[str]
20392039
:param location: The geographic location of the job. Required except for
20402040
US and EU. See details at

airflow/providers/google/cloud/operators/bigquery.py

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -570,8 +570,8 @@ class BigQueryExecuteQueryOperator(BaseOperator):
570570
partition by field, type and expiration as per API specifications.
571571
:type time_partitioning: dict
572572
:param cluster_fields: Request that the result of this query be stored sorted
573-
by one or more columns. This is only available in conjunction with
574-
time_partitioning. The order of columns given determines the sort order.
573+
by one or more columns. BigQuery supports clustering for both partitioned and
574+
non-partitioned tables. The order of columns given determines the sort order.
575575
:type cluster_fields: list[str]
576576
:param location: The geographic location of the job. Required except for
577577
US and EU. See details at
@@ -861,8 +861,8 @@ class BigQueryCreateEmptyTableOperator(BaseOperator):
861861
:param location: The location used for the operation.
862862
:type location: str
863863
:param cluster_fields: [Optional] The fields used for clustering.
864-
Must be specified with time_partitioning, data in the table will be first
865-
partitioned and subsequently clustered.
864+
BigQuery supports clustering for both partitioned and
865+
non-partitioned tables.
866866
867867
.. seealso::
868868
https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#clustering.fields

airflow/providers/google/cloud/transfers/gcs_to_bigquery.py

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -131,8 +131,8 @@ class GCSToBigQueryOperator(BaseOperator):
131131
dataset.table$partition.
132132
:type time_partitioning: dict
133133
:param cluster_fields: Request that the result of this load be stored sorted
134-
by one or more columns. This is only available in conjunction with
135-
time_partitioning. The order of columns given determines the sort order.
134+
by one or more columns. BigQuery supports clustering for both partitioned and
135+
non-partitioned tables. The order of columns given determines the sort order.
136136
Not applicable for external tables.
137137
:type cluster_fields: list[str]
138138
:param autodetect: [Optional] Indicates if we should automatically infer the

0 commit comments

Comments
 (0)