Api-Roll 53: 2017-08-21

discovery/googleapis/bigquery__v2.json

 {
     "auth": {
         "oauth2": {
             "scopes": {
                 "https://www.googleapis.com/auth/bigquery": {
                     "description": "View and manage your data in Google BigQuery"
                 },
                 "https://www.googleapis.com/auth/bigquery.insertdata": {
                     "description": "Insert data into Google BigQuery"
                 },
@@ skipping 14 matching lines @@
                 }
             }
         }
     },
     "basePath": "/bigquery/v2/",
     "baseUrl": "https://www.googleapis.com/bigquery/v2/",
     "batchPath": "batch",
     "description": "A data platform for customers to create, manage, share and query data.",
     "discoveryVersion": "v1",
     "documentationLink": "https://cloud.google.com/bigquery/",
-    "etag": "\"YWOzh2SDasdU84ArJnpYek-OMdg/wbl_PWLcOQ9nI3adoCABAX0E-tY\"",
+    "etag": "\"YWOzh2SDasdU84ArJnpYek-OMdg/VAUadisxTuoVlTKS7RQzsJKN_oI\"",
     "icons": {
         "x16": "https://www.google.com/images/icons/product/search-16.gif",
         "x32": "https://www.google.com/images/icons/product/search-32.gif"
     },
     "id": "bigquery:v2",
     "kind": "discovery#restDescription",
     "name": "bigquery",
     "ownerDomain": "google.com",
     "ownerName": "Google",
     "parameters": {
@@ skipping 893 matching lines @@
                         "$ref": "Table"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/bigquery",
                         "https://www.googleapis.com/auth/cloud-platform"
                     ]
                 }
             }
         }
     },
-    "revision": "20170721",
+    "revision": "20170812",
     "rootUrl": "https://www.googleapis.com/",
     "schemas": {
         "BigtableColumn": {
             "id": "BigtableColumn",
             "properties": {
                 "encoding": {
                     "description": "[Optional] The encoding of the values when the type is not STRING. Acceptable encoding values are: TEXT - indicates values are alphanumeric text strings. BINARY - indicates values are encoded using HBase Bytes.toBytes family of functions. 'encoding' can also be set at the column family level. However, the setting at this level takes precedence if 'encoding' is set at both levels.",
                     "type": "string"
                 },
                 "fieldName": {
@@ skipping 290 matching lines @@
                 "reason": {
                     "description": "A short error code that summarizes the error.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "ExplainQueryStage": {
             "id": "ExplainQueryStage",
             "properties": {
+                "computeMsAvg": {
+                    "description": "Milliseconds the average shard spent on CPU-bound tasks.",
+                    "format": "int64",
+                    "type": "string"
+                },
+                "computeMsMax": {
+                    "description": "Milliseconds the slowest shard spent on CPU-bound tasks.",
+                    "format": "int64",
+                    "type": "string"
+                },
                 "computeRatioAvg": {
                     "description": "Relative amount of time the average shard spent on CPU-bound tasks.",
                     "format": "double",
                     "type": "number"
                 },
                 "computeRatioMax": {
                     "description": "Relative amount of time the slowest shard spent on CPU-bound tasks.",
                     "format": "double",
                     "type": "number"
                 },
                 "id": {
                     "description": "Unique ID for stage within plan.",
                     "format": "int64",
                     "type": "string"
                 },
                 "name": {
                     "description": "Human-readable name for stage.",
                     "type": "string"
                 },
+                "readMsAvg": {
+                    "description": "Milliseconds the average shard spent reading input.",
+                    "format": "int64",
+                    "type": "string"
+                },
+                "readMsMax": {
+                    "description": "Milliseconds the slowest shard spent reading input.",
+                    "format": "int64",
+                    "type": "string"
+                },
                 "readRatioAvg": {
                     "description": "Relative amount of time the average shard spent reading input.",
                     "format": "double",
                     "type": "number"
                 },
                 "readRatioMax": {
                     "description": "Relative amount of time the slowest shard spent reading input.",
                     "format": "double",
                     "type": "number"
                 },
                 "recordsRead": {
                     "description": "Number of records read into the stage.",
                     "format": "int64",
                     "type": "string"
                 },
                 "recordsWritten": {
                     "description": "Number of records written by the stage.",
                     "format": "int64",
                     "type": "string"
                 },
+                "shuffleOutputBytes": {
+                    "description": "Total number of bytes written to shuffle.",
+                    "format": "int64",
+                    "type": "string"
+                },
+                "shuffleOutputBytesSpilled": {
+                    "description": "Total number of bytes written to shuffle and spilled to disk.",
+                    "format": "int64",
+                    "type": "string"
+                },
                 "status": {
                     "description": "Current status for the stage.",
                     "type": "string"
                 },
                 "steps": {
                     "description": "List of operations within the stage in dependency order (approximately chronological).",
                     "items": {
                         "$ref": "ExplainQueryStep"
                     },
                     "type": "array"
                 },
+                "waitMsAvg": {
+                    "description": "Milliseconds the average shard spent waiting to be scheduled.",
+                    "format": "int64",
+                    "type": "string"
+                },
+                "waitMsMax": {
+                    "description": "Milliseconds the slowest shard spent waiting to be scheduled.",
+                    "format": "int64",
+                    "type": "string"
+                },
                 "waitRatioAvg": {
                     "description": "Relative amount of time the average shard spent waiting to be scheduled.",
                     "format": "double",
                     "type": "number"
                 },
                 "waitRatioMax": {
                     "description": "Relative amount of time the slowest shard spent waiting to be scheduled.",
                     "format": "double",
                     "type": "number"
                 },
+                "writeMsAvg": {
+                    "description": "Milliseconds the average shard spent on writing output.",
+                    "format": "int64",
+                    "type": "string"
+                },
+                "writeMsMax": {
+                    "description": "Milliseconds the slowest shard spent on writing output.",
+                    "format": "int64",
+                    "type": "string"
+                },
                 "writeRatioAvg": {
                     "description": "Relative amount of time the average shard spent on writing output.",
                     "format": "double",
                     "type": "number"
                 },
                 "writeRatioMax": {
                     "description": "Relative amount of time the slowest shard spent on writing output.",
                     "format": "double",
                     "type": "number"
                 }
@@ skipping 51 matching lines @@
                 },
                 "schema": {
                     "$ref": "TableSchema",
                     "description": "[Optional] The schema for the data. Schema is required for CSV and JSON formats. Schema is disallowed for Google Cloud Bigtable, Cloud Datastore backups, and Avro formats."
                 },
                 "sourceFormat": {
                     "description": "[Required] The data format. For CSV files, specify \"CSV\". For Google sheets, specify \"GOOGLE_SHEETS\". For newline-delimited JSON, specify \"NEWLINE_DELIMITED_JSON\". For Avro files, specify \"AVRO\". For Google Cloud Datastore backups, specify \"DATASTORE_BACKUP\". [Beta] For Google Cloud Bigtable, specify \"BIGTABLE\".",
                     "type": "string"
                 },
                 "sourceUris": {
-                    "description": "[Required] The fully-qualified URIs that point to your data in Google Cloud. For Google Cloud Storage URIs: Each URI can contain one '*' wildcard character and it must come after the 'bucket' name. Size limits related to load jobs apply to external data sources. For Google Cloud Bigtable URIs: Exactly one URI can be specified and it has be a fully specified and valid HTTPS URL for a Google Cloud Bigtable table. For Google Cloud Datastore backups, exactly one URI can be specified, and it must end with '.backup_info'. Also, the '*' wildcard character is not allowed.",
+                    "description": "[Required] The fully-qualified URIs that point to your data in Google Cloud. For Google Cloud Storage URIs: Each URI can contain one '*' wildcard character and it must come after the 'bucket' name. Size limits related to load jobs apply to external data sources. For Google Cloud Bigtable URIs: Exactly one URI can be specified and it has be a fully specified and valid HTTPS URL for a Google Cloud Bigtable table. For Google Cloud Datastore backups, exactly one URI can be specified. Also, the '*' wildcard character is not allowed.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
         "GetQueryResultsResponse": {
             "id": "GetQueryResultsResponse",
@@ skipping 262 matching lines @@
                 },
                 "schemaInline": {
                     "description": "[Deprecated] The inline schema. For CSV schemas, specify as \"Field1:Type1[,Field2:Type2]*\". For example, \"foo:STRING, bar:INTEGER, baz:FLOAT\".",
                     "type": "string"
                 },
                 "schemaInlineFormat": {
                     "description": "[Deprecated] The format of the schemaInline property.",
                     "type": "string"
                 },
                 "schemaUpdateOptions": {
-                    "description": "[Experimental] Allows the schema of the desitination table to be updated as a side effect of the load job. Schema update options are supported in two cases: when writeDisposition is WRITE_APPEND; when writeDisposition is WRITE_TRUNCATE and the destination table is a partition of a table, specified by partition decorators. For normal tables, WRITE_TRUNCATE will always overwrite the schema. One or more of the following values are specified: ALLOW_FIELD_ADDITION: allow adding a nullable field to the schema. ALLOW_FIELD_RELAXATION: allow relaxing a required field in the original schema to nullable.",
+                    "description": "[Experimental] Allows the schema of the desitination table to be updated as a side effect of the load job if a schema is autodetected or supplied in the job configuration. Schema update options are supported in two cases: when writeDisposition is WRITE_APPEND; when writeDisposition is WRITE_TRUNCATE and the destination table is a partition of a table, specified by partition decorators. For normal tables, WRITE_TRUNCATE will always overwrite the schema. One or more of the following values are specified: ALLOW_FIELD_ADDITION: allow adding a nullable field to the schema. ALLOW_FIELD_RELAXATION: allow relaxing a required field in the original schema to nullable.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "skipLeadingRows": {
                     "description": "[Optional] The number of rows at the top of a CSV file that BigQuery will skip when loading the data. The default value is 0. This property is useful if you have header rows in the file that should be skipped.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "sourceFormat": {
                     "description": "[Optional] The format of the data files. For CSV files, specify \"CSV\". For datastore backups, specify \"DATASTORE_BACKUP\". For newline-delimited JSON, specify \"NEWLINE_DELIMITED_JSON\". For Avro, specify \"AVRO\". The default value is CSV.",
                     "type": "string"
                 },
                 "sourceUris": {
-                    "description": "[Required] The fully-qualified URIs that point to your data in Google Cloud. For Google Cloud Storage URIs: Each URI can contain one '*' wildcard character and it must come after the 'bucket' name. Size limits related to load jobs apply to external data sources. For Google Cloud Bigtable URIs: Exactly one URI can be specified and it has be a fully specified and valid HTTPS URL for a Google Cloud Bigtable table. For Google Cloud Datastore backups: Exactly one URI can be specified, and it must end with '.backup_info'. Also, the '*' wildcard character is not allowed.",
+                    "description": "[Required] The fully-qualified URIs that point to your data in Google Cloud. For Google Cloud Storage URIs: Each URI can contain one '*' wildcard character and it must come after the 'bucket' name. Size limits related to load jobs apply to external data sources. For Google Cloud Bigtable URIs: Exactly one URI can be specified and it has be a fully specified and valid HTTPS URL for a Google Cloud Bigtable table. For Google Cloud Datastore backups: Exactly one URI can be specified. Also, the '*' wildcard character is not allowed.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 },
+                "timePartitioning": {
+                    "$ref": "TimePartitioning",
+                    "description": "[Experimental] If specified, configures time-based partitioning for the destination table."
+                },
                 "writeDisposition": {
                     "description": "[Optional] Specifies the action that occurs if the destination table already exists. The following values are supported: WRITE_TRUNCATE: If the table already exists, BigQuery overwrites the table data. WRITE_APPEND: If the table already exists, BigQuery appends the data to the table. WRITE_EMPTY: If the table already exists and contains data, a 'duplicate' error is returned in the job result. The default value is WRITE_APPEND. Each action is atomic and only occurs if BigQuery is able to complete the job successfully. Creation, truncation and append actions occur as one atomic update upon job completion.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "JobConfigurationQuery": {
             "id": "JobConfigurationQuery",
             "properties": {
@@ skipping 60 matching lines @@
                     },
                     "type": "array"
                 },
                 "tableDefinitions": {
                     "additionalProperties": {
                         "$ref": "ExternalDataConfiguration"
                     },
                     "description": "[Optional] If querying an external data source outside of BigQuery, describes the data format, location and other properties of the data source. By defining these properties, the data source can then be queried as if it were a standard BigQuery table.",
                     "type": "object"
                 },
+                "timePartitioning": {
+                    "$ref": "TimePartitioning",
+                    "description": "[Experimental] If specified, configures time-based partitioning for the destination table."
+                },
                 "useLegacySql": {
                     "description": "Specifies whether to use BigQuery's legacy SQL dialect for this query. The default value is true. If set to false, the query will use BigQuery's standard SQL: https://cloud.google.com/bigquery/sql-reference/ When useLegacySql is set to false, the value of flattenResults is ignored; query will be run as if flattenResults is false.",
                     "type": "boolean"
                 },
                 "useQueryCache": {
                     "default": "true",
                     "description": "[Optional] Whether to look for the result in the query cache. The query cache is a best-effort cache that will be flushed whenever tables in the query are modified. Moreover, the query cache is only available when a query does not have a destination table specified. The default value is true.",
                     "type": "boolean"
                 },
                 "userDefinedFunctionResources": {
@@ skipping 1012 matching lines @@
                     "type": "array"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "bigquery/v2/",
     "title": "BigQuery API",
     "version": "v2"
 }