github.com/danp/terraform@v0.9.5-0.20170426144147-39d740081351/website/source/docs/providers/google/r/bigquery_dataset.html.markdown (about)

     1  ---
     2  layout: "google"
     3  page_title: "Google: google_bigquery_dataset"
     4  sidebar_current: "docs-google-bigquery-dataset"
     5  description: |-
     6    Creates a dataset resource for Google BigQuery.
     7  ---
     8  
     9  # google_bigquery_dataset
    10  
    11  Creates a dataset resource for Google BigQuery. For more information see
    12  [the official documentation](https://cloud.google.com/bigquery/docs/) and
    13  [API](https://cloud.google.com/bigquery/docs/reference/rest/v2/datasets).
    14  
    15  
    16  ## Example Usage
    17  
    18  ```hcl
    19  resource "google_bigquery_dataset" "default" {
    20    dataset_id                  = "test"
    21    friendly_name               = "test"
    22    description                 = "This is a test description"
    23    location                    = "EU"
    24    default_table_expiration_ms = 3600000
    25  
    26    labels {
    27      env = "default"
    28    }
    29  }
    30  ```
    31  
    32  ## Argument Reference
    33  
    34  The following arguments are supported:
    35  
    36  * `dataset_id` - (Required) A unique ID for the resource.
    37      Changing this forces a new resource to be created.
    38  
    39  * `project` - (Optional) The project in which the resource belongs. If it
    40      is not provided, the provider project is used.
    41  
    42  * `friendly_name` - (Optional) A descriptive name for the dataset.
    43  
    44  * `description` - (Optional) A user-friendly description of the dataset.
    45  
    46  * `location` - (Optional) The geographic location where the dataset should reside.
    47  
    48      Possible values include `EU` and `US`. The default value is `US`.
    49  
    50      Changing this forces a new resource to be created.
    51  
    52  * `default_table_expiration_ms` - (Optional) The default lifetime of all
    53      tables in the dataset, in milliseconds. The minimum value is 3600000
    54      milliseconds (one hour).
    55  
    56      Once this property is set, all newly-created
    57      tables in the dataset will have an expirationTime property set to the
    58      creation time plus the value in this property, and changing the value
    59      will only affect new tables, not existing ones. When the
    60      expirationTime for a given table is reached, that table will be
    61      deleted automatically. If a table's expirationTime is modified or
    62      removed before the table expires, or if you provide an explicit
    63      expirationTime when creating a table, that value takes precedence
    64      over the default expiration time indicated by this property.
    65  
    66    * `labels` - (Optional) A mapping of labels to assign to the resource.
    67  
    68  ## Attributes Reference
    69  
    70  In addition to the arguments listed above, the following computed attributes are
    71  exported:
    72  
    73  * `self_link` - The URI of the created resource.
    74  
    75  * `etag` - A hash of the resource.
    76  
    77  * `creation_time` - The time when this dataset was created, in milliseconds since the epoch.
    78  
    79  * `last_modified_time` -  The date when this dataset or any of its tables was last modified,
    80    in milliseconds since the epoch.