terraform-provider-google/r/bigquery_table.html.markdown

layout	page_title	sidebar_current	description
google	Google: google_bigquery_table	docs-google-bigquery-table	Creates a table resource in a dataset for Google BigQuery.

google_bigquery_table

Creates a table resource in a dataset for Google BigQuery. For more information see the official documentation and API.

Example Usage

resource "google_bigquery_dataset" "default" {
  dataset_id                  = "test"
  friendly_name               = "test"
  description                 = "This is a test description"
  location                    = "EU"
  default_table_expiration_ms = 3600000

  labels {
    env = "default"
  }
}

resource "google_bigquery_table" "default" {
  dataset_id = "${google_bigquery_dataset.default.id}"
  table_id   = "test"

  time_partitioning {
    type = "DAY"
  }

  labels {
    env = "default"
  }

  schema = "${file("schema.json")}"
}

Argument Reference

The following arguments are supported:

• dataset_id - (Required) The dataset ID to create the table in. Changing this forces a new resource to be created.

• table_id - (Required) A unique ID for the resource. Changing this forces a new resource to be created.

• project - (Optional) The project in which the resource belongs. If it is not provided, the provider project is used.

• description - (Optional) The field description.

• expiration_time - (Optional) The time when this table expires, in milliseconds since the epoch. If not present, the table will persist indefinitely. Expired tables will be deleted and their storage reclaimed.

• friendly_name - (Optional) A descriptive name for the table.

• labels - (Optional) A mapping of labels to assign to the resource.

• schema - (Optional) A JSON schema for the table.

• time_partitioning - (Optional) If specified, configures time-based partitioning for this table. Structure is documented below.

The time_partitioning block supports:

• expiration_ms - (Optional) Number of milliseconds for which to keep the storage for a partition.

• type - (Required) The only type supported is DAY, which will generate one partition per day based on data loading time.

Attributes Reference

In addition to the arguments listed above, the following computed attributes are exported:

• creation_time - The time when this table was created, in milliseconds since the epoch.

• etag - A hash of the resource.

• last_modified_time - The time when this table was last modified, in milliseconds since the epoch.

• location - The geographic location where the table resides. This value is inherited from the dataset.

• num_bytes - The size of this table in bytes, excluding any data in the streaming buffer.

• num_long_term_bytes - The number of bytes in the table that are considered "long-term storage".

• num_rows - The number of rows of data in this table, excluding any data in the streaming buffer.

• self_link - The URI of the created resource.

• type - Describes the table type.

Import

Tables can be imported using ID of the table (projectID:datasetID.tableID), e.g.

$ terraform import bigquery_table.default testproject:testdataset.testtable