BigQuery: table clustering/partitioning support.

products/bigquery/api.yaml

@@ -170,6 +170,15 @@ objects:
           - !ruby/object:Api::Type::String
             name: 'tableId'
             description: The ID of the the table
+      - !ruby/object:Api::Type::Array
+            name: 'clustering'
+            description: |
+              One or more fields on which data should be clustered. Only
+              top-level, non-repeated, simple-type fields are supported. When
+              you cluster a table using multiple columns, the order of columns
+              you specify is important. The order of the specified columns
+              determines the sort order of the data.
+            item_type: Api::Type::String
       - !ruby/object:Api::Type::Integer
         name: 'creationTime'
         output: true
@@ -223,6 +232,11 @@ objects:
         description: |
           The number of rows of data in this table, excluding any data in the
           streaming buffer.
+      - !ruby/object:Api::Type::Boolean
+        name: 'requirePartitionFilter'
+        description: |
+          If set to true, queries over this table require a partition filter
+          that can be used for partition elimination to be specified.
         output: true
       - !ruby/object:Api::Type::Enum
         name: 'type'
@@ -269,6 +283,15 @@ objects:
             description: |
               Number of milliseconds for which to keep the storage for a
               partition.
+          - !ruby/object:Api::Type::String
+            name: 'field'
+            description: |
+              If not set, the table is partitioned by pseudo column,
+              referenced via either '_PARTITIONTIME' as TIMESTAMP type, or
+              '_PARTITIONDATE' as DATE type. If field is specified, the table
+              is instead partitioned by this field. The field must be a
+              top-level TIMESTAMP or DATE field. Its mode must be NULLABLE or
+              REQUIRED.
           - !ruby/object:Api::Type::Enum
             name: 'type'
             description: |

third_party/terraform/resources/resource_bigquery_table.go.erb

@@ -303,6 +303,16 @@ func resourceBigQueryTable() *schema.Resource {
 				},
 			},
 
+			// Clustering: [Optional] Specifies column names to use for data clustering.  Up to four
+			// top-level columns are allowed, and should be specified in descending priority order.
+			"clustering": &schema.Schema{
+				Type:     schema.TypeList,
+				Optional: true,
+                                ForceNew: true,
+                                MaxItems: 4,
+				Elem:     &schema.Schema{Type: schema.TypeString},
+			},
+
 			// CreationTime: [Output-only] The time when this table was created, in
 			// milliseconds since the epoch.
 			"creation_time": {
@@ -435,6 +445,13 @@ func resourceTable(d *schema.ResourceData, meta interface{}) (*bigquery.Table, e
 		table.TimePartitioning = expandTimePartitioning(v)
 	}
 
+	if v, ok := d.GetOk("clustering"); ok {
+		table.Clustering = &bigquery.Clustering{
+			Fields: convertStringArr(v.([]interface{})),
+			ForceSendFields: []string{"Fields"},
+		}
+	}
+
 	return table, nil
 }
 
@@ -514,6 +531,10 @@ func resourceBigQueryTableRead(d *schema.ResourceData, meta interface{}) error {
 		}
 	}
 
+	if res.Clustering != nil {
+		d.Set("clustering", res.Clustering.Fields)
+	}
+
 	if res.Schema != nil {
 		schema, err := flattenSchema(res.Schema)
 		if err != nil {

third_party/terraform/tests/resource_bigquery_table_test.go

@@ -179,13 +179,21 @@ resource "google_bigquery_table" "test" {
     field = "ts"
     require_partition_filter = true
   }
-
+	clustering = ["some_int", "some_string"]
   schema = <<EOH
 [
   {
     "name": "ts",
     "type": "TIMESTAMP"
   },
+  {
+    "name": "some_string",
+    "type": "STRING"
+  },
+  {
+    "name": "some_int",
+    "type": "INTEGER"
+  },
   {
     "name": "city",
     "type": "RECORD",