| <html><body> |
| <style> |
| |
| body, h1, h2, h3, div, span, p, pre, a { |
| margin: 0; |
| padding: 0; |
| border: 0; |
| font-weight: inherit; |
| font-style: inherit; |
| font-size: 100%; |
| font-family: inherit; |
| vertical-align: baseline; |
| } |
| |
| body { |
| font-size: 13px; |
| padding: 1em; |
| } |
| |
| h1 { |
| font-size: 26px; |
| margin-bottom: 1em; |
| } |
| |
| h2 { |
| font-size: 24px; |
| margin-bottom: 1em; |
| } |
| |
| h3 { |
| font-size: 20px; |
| margin-bottom: 1em; |
| margin-top: 1em; |
| } |
| |
| pre, code { |
| line-height: 1.5; |
| font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace; |
| } |
| |
| pre { |
| margin-top: 0.5em; |
| } |
| |
| h1, h2, h3, p { |
| font-family: Arial, sans serif; |
| } |
| |
| h1, h2, h3 { |
| border-bottom: solid #CCC 1px; |
| } |
| |
| .toc_element { |
| margin-top: 0.5em; |
| } |
| |
| .firstline { |
| margin-left: 2 em; |
| } |
| |
| .method { |
| margin-top: 1em; |
| border: solid 1px #CCC; |
| padding: 1em; |
| background: #EEE; |
| } |
| |
| .details { |
| font-weight: bold; |
| font-size: 14px; |
| } |
| |
| </style> |
| |
| <h1><a href="bigquery_v2.html">BigQuery API</a> . <a href="bigquery_v2.tables.html">tables</a></h1> |
| <h2>Instance Methods</h2> |
| <p class="toc_element"> |
| <code><a href="#delete">delete(projectId, datasetId, tableId)</a></code></p> |
| <p class="firstline">Deletes the table specified by tableId from the dataset. If the table contains data, all the data will be deleted.</p> |
| <p class="toc_element"> |
| <code><a href="#get">get(projectId, datasetId, tableId)</a></code></p> |
| <p class="firstline">Gets the specified table resource by table ID. This method does not return the data in the table, it only returns the table resource, which describes the structure of this table.</p> |
| <p class="toc_element"> |
| <code><a href="#insert">insert(projectId, datasetId, body)</a></code></p> |
| <p class="firstline">Creates a new, empty table in the dataset.</p> |
| <p class="toc_element"> |
| <code><a href="#list">list(projectId, datasetId, pageToken=None, maxResults=None)</a></code></p> |
| <p class="firstline">Lists all tables in the specified dataset. Requires the READER dataset role.</p> |
| <p class="toc_element"> |
| <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p> |
| <p class="firstline">Retrieves the next page of results.</p> |
| <p class="toc_element"> |
| <code><a href="#patch">patch(projectId, datasetId, tableId, body)</a></code></p> |
| <p class="firstline">Updates information in an existing table. The update method replaces the entire table resource, whereas the patch method only replaces fields that are provided in the submitted table resource. This method supports patch semantics.</p> |
| <p class="toc_element"> |
| <code><a href="#update">update(projectId, datasetId, tableId, body)</a></code></p> |
| <p class="firstline">Updates information in an existing table. The update method replaces the entire table resource, whereas the patch method only replaces fields that are provided in the submitted table resource.</p> |
| <h3>Method Details</h3> |
| <div class="method"> |
| <code class="details" id="delete">delete(projectId, datasetId, tableId)</code> |
| <pre>Deletes the table specified by tableId from the dataset. If the table contains data, all the data will be deleted. |
| |
| Args: |
| projectId: string, Project ID of the table to delete (required) |
| datasetId: string, Dataset ID of the table to delete (required) |
| tableId: string, Table ID of the table to delete (required) |
| </pre> |
| </div> |
| |
| <div class="method"> |
| <code class="details" id="get">get(projectId, datasetId, tableId)</code> |
| <pre>Gets the specified table resource by table ID. This method does not return the data in the table, it only returns the table resource, which describes the structure of this table. |
| |
| Args: |
| projectId: string, Project ID of the requested table (required) |
| datasetId: string, Dataset ID of the requested table (required) |
| tableId: string, Table ID of the requested table (required) |
| |
| Returns: |
| An object of the form: |
| |
| { |
| "kind": "bigquery#table", # [Output-only] The type of the resource. |
| "lastModifiedTime": "A String", # [Output-only] The time when this table was last modified, in milliseconds since the epoch. |
| "description": "A String", # [Optional] A user-friendly description of this table. |
| "creationTime": "A String", # [Output-only] The time when this table was created, in milliseconds since the epoch. |
| "externalDataConfiguration": { # [Experimental] Describes the data format, location, and other properties of a table stored outside of BigQuery. By defining these properties, the data source can then be queried as if it were a standard BigQuery table. |
| "compression": "A String", # [Optional] The compression type of the data source. Possible values include GZIP and NONE. The default value is NONE. |
| "csvOptions": { # Additional properties to set if sourceFormat is set to CSV. |
| "fieldDelimiter": "A String", # [Optional] The separator for fields in a CSV file. BigQuery converts the string to ISO-8859-1 encoding, and then uses the first byte of the encoded string to split the data in its raw, binary state. BigQuery also supports the escape sequence "\t" to specify a tab separator. The default value is a comma (','). |
| "encoding": "A String", # [Optional] The character encoding of the data. The supported values are UTF-8 or ISO-8859-1. The default value is UTF-8. BigQuery decodes the data after the raw, binary data has been split using the values of the quote and fieldDelimiter properties. |
| "skipLeadingRows": 42, # [Optional] The number of rows at the top of a CSV file that BigQuery will skip when reading the data. The default value is 0. This property is useful if you have header rows in the file that should be skipped. |
| "allowJaggedRows": True or False, # [Optional] Indicates if BigQuery should accept rows that are missing trailing optional columns. If true, BigQuery treats missing trailing columns as null values. If false, records with missing trailing columns are treated as bad records, and if there are too many bad records, an invalid error is returned in the job result. The default value is false. |
| "quote": """, # [Optional] The value that is used to quote data sections in a CSV file. BigQuery converts the string to ISO-8859-1 encoding, and then uses the first byte of the encoded string to split the data in its raw, binary state. The default value is a double-quote ('"'). If your data does not contain quoted sections, set the property value to an empty string. If your data contains quoted newline characters, you must also set the allowQuotedNewlines property to true. |
| "allowQuotedNewlines": True or False, # [Optional] Indicates if BigQuery should allow quoted data sections that contain newline characters in a CSV file. The default value is false. |
| }, |
| "sourceFormat": "A String", # [Required] The data format. For CSV files, specify "CSV". For newline-delimited JSON, specify "NEWLINE_DELIMITED_JSON". |
| "maxBadRecords": 42, # [Optional] The maximum number of bad records that BigQuery can ignore when reading data. If the number of bad records exceeds this value, an invalid error is returned in the job result. The default value is 0, which requires that all records are valid. |
| "ignoreUnknownValues": True or False, # [Optional] Indicates if BigQuery should allow extra values that are not represented in the table schema. If true, the extra values are ignored. If false, records with extra columns are treated as bad records, and if there are too many bad records, an invalid error is returned in the job result. The default value is false. The sourceFormat property determines what BigQuery treats as an extra value: CSV: Trailing columns JSON: Named values that don't match any column names |
| "sourceUris": [ # [Required] The fully-qualified URIs that point to your data in Google Cloud Storage. 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, plus an additional limit of 10 GB maximum size across all URIs. |
| "A String", |
| ], |
| "schema": { # [Required] The schema for the data. |
| "fields": [ # Describes the fields in a table. |
| { |
| "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD. |
| # Object with schema name: TableFieldSchema |
| ], |
| "type": "A String", # [Required] The field data type. Possible values include STRING, INTEGER, FLOAT, BOOLEAN, TIMESTAMP or RECORD (where RECORD indicates that the field contains a nested schema). |
| "description": "A String", # [Optional] The field description. The maximum length is 16K characters. |
| "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters. |
| "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE. |
| }, |
| ], |
| }, |
| }, |
| "tableReference": { # [Required] Reference describing the ID of this table. |
| "projectId": "A String", # [Required] The ID of the project containing this table. |
| "tableId": "A String", # [Required] The ID of the table. The ID must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_). The maximum length is 1,024 characters. |
| "datasetId": "A String", # [Required] The ID of the dataset containing this table. |
| }, |
| "numRows": "A String", # [Output-only] The number of rows of data in this table, excluding any data in the streaming buffer. |
| "numBytes": "A String", # [Output-only] The size of this table in bytes, excluding any data in the streaming buffer. |
| "etag": "A String", # [Output-only] A hash of this resource. |
| "location": "A String", # [Output-only] The geographic location where the table resides. This value is inherited from the dataset. |
| "streamingBuffer": { # [Output-only] Contains information regarding this table's streaming buffer, if one is present. This field will be absent if the table is not being streamed to or if there is no data in the streaming buffer. |
| "estimatedBytes": "A String", # [Output-only] A lower-bound estimate of the number of bytes currently in the streaming buffer. |
| "estimatedRows": "A String", # [Output-only] A lower-bound estimate of the number of rows currently in the streaming buffer. |
| "oldestEntryTime": "A String", # [Output-only] Contains the timestamp of the oldest entry in the streaming buffer, in milliseconds since the epoch, if the streaming buffer is available. |
| }, |
| "friendlyName": "A String", # [Optional] A descriptive name for this table. |
| "expirationTime": "A String", # [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. |
| "view": { # [Optional] The view definition. |
| "query": "A String", # [Required] A query that BigQuery executes when the view is referenced. |
| }, |
| "type": "A String", # [Output-only] Describes the table type. The following values are supported: TABLE: A normal BigQuery table. VIEW: A virtual table defined by a SQL query. The default value is TABLE. |
| "id": "A String", # [Output-only] An opaque ID uniquely identifying the table. |
| "selfLink": "A String", # [Output-only] A URL that can be used to access this resource again. |
| "schema": { # [Optional] Describes the schema of this table. |
| "fields": [ # Describes the fields in a table. |
| { |
| "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD. |
| # Object with schema name: TableFieldSchema |
| ], |
| "type": "A String", # [Required] The field data type. Possible values include STRING, INTEGER, FLOAT, BOOLEAN, TIMESTAMP or RECORD (where RECORD indicates that the field contains a nested schema). |
| "description": "A String", # [Optional] The field description. The maximum length is 16K characters. |
| "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters. |
| "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE. |
| }, |
| ], |
| }, |
| }</pre> |
| </div> |
| |
| <div class="method"> |
| <code class="details" id="insert">insert(projectId, datasetId, body)</code> |
| <pre>Creates a new, empty table in the dataset. |
| |
| Args: |
| projectId: string, Project ID of the new table (required) |
| datasetId: string, Dataset ID of the new table (required) |
| body: object, The request body. (required) |
| The object takes the form of: |
| |
| { |
| "kind": "bigquery#table", # [Output-only] The type of the resource. |
| "lastModifiedTime": "A String", # [Output-only] The time when this table was last modified, in milliseconds since the epoch. |
| "description": "A String", # [Optional] A user-friendly description of this table. |
| "creationTime": "A String", # [Output-only] The time when this table was created, in milliseconds since the epoch. |
| "externalDataConfiguration": { # [Experimental] Describes the data format, location, and other properties of a table stored outside of BigQuery. By defining these properties, the data source can then be queried as if it were a standard BigQuery table. |
| "compression": "A String", # [Optional] The compression type of the data source. Possible values include GZIP and NONE. The default value is NONE. |
| "csvOptions": { # Additional properties to set if sourceFormat is set to CSV. |
| "fieldDelimiter": "A String", # [Optional] The separator for fields in a CSV file. BigQuery converts the string to ISO-8859-1 encoding, and then uses the first byte of the encoded string to split the data in its raw, binary state. BigQuery also supports the escape sequence "\t" to specify a tab separator. The default value is a comma (','). |
| "encoding": "A String", # [Optional] The character encoding of the data. The supported values are UTF-8 or ISO-8859-1. The default value is UTF-8. BigQuery decodes the data after the raw, binary data has been split using the values of the quote and fieldDelimiter properties. |
| "skipLeadingRows": 42, # [Optional] The number of rows at the top of a CSV file that BigQuery will skip when reading the data. The default value is 0. This property is useful if you have header rows in the file that should be skipped. |
| "allowJaggedRows": True or False, # [Optional] Indicates if BigQuery should accept rows that are missing trailing optional columns. If true, BigQuery treats missing trailing columns as null values. If false, records with missing trailing columns are treated as bad records, and if there are too many bad records, an invalid error is returned in the job result. The default value is false. |
| "quote": """, # [Optional] The value that is used to quote data sections in a CSV file. BigQuery converts the string to ISO-8859-1 encoding, and then uses the first byte of the encoded string to split the data in its raw, binary state. The default value is a double-quote ('"'). If your data does not contain quoted sections, set the property value to an empty string. If your data contains quoted newline characters, you must also set the allowQuotedNewlines property to true. |
| "allowQuotedNewlines": True or False, # [Optional] Indicates if BigQuery should allow quoted data sections that contain newline characters in a CSV file. The default value is false. |
| }, |
| "sourceFormat": "A String", # [Required] The data format. For CSV files, specify "CSV". For newline-delimited JSON, specify "NEWLINE_DELIMITED_JSON". |
| "maxBadRecords": 42, # [Optional] The maximum number of bad records that BigQuery can ignore when reading data. If the number of bad records exceeds this value, an invalid error is returned in the job result. The default value is 0, which requires that all records are valid. |
| "ignoreUnknownValues": True or False, # [Optional] Indicates if BigQuery should allow extra values that are not represented in the table schema. If true, the extra values are ignored. If false, records with extra columns are treated as bad records, and if there are too many bad records, an invalid error is returned in the job result. The default value is false. The sourceFormat property determines what BigQuery treats as an extra value: CSV: Trailing columns JSON: Named values that don't match any column names |
| "sourceUris": [ # [Required] The fully-qualified URIs that point to your data in Google Cloud Storage. 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, plus an additional limit of 10 GB maximum size across all URIs. |
| "A String", |
| ], |
| "schema": { # [Required] The schema for the data. |
| "fields": [ # Describes the fields in a table. |
| { |
| "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD. |
| # Object with schema name: TableFieldSchema |
| ], |
| "type": "A String", # [Required] The field data type. Possible values include STRING, INTEGER, FLOAT, BOOLEAN, TIMESTAMP or RECORD (where RECORD indicates that the field contains a nested schema). |
| "description": "A String", # [Optional] The field description. The maximum length is 16K characters. |
| "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters. |
| "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE. |
| }, |
| ], |
| }, |
| }, |
| "tableReference": { # [Required] Reference describing the ID of this table. |
| "projectId": "A String", # [Required] The ID of the project containing this table. |
| "tableId": "A String", # [Required] The ID of the table. The ID must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_). The maximum length is 1,024 characters. |
| "datasetId": "A String", # [Required] The ID of the dataset containing this table. |
| }, |
| "numRows": "A String", # [Output-only] The number of rows of data in this table, excluding any data in the streaming buffer. |
| "numBytes": "A String", # [Output-only] The size of this table in bytes, excluding any data in the streaming buffer. |
| "etag": "A String", # [Output-only] A hash of this resource. |
| "location": "A String", # [Output-only] The geographic location where the table resides. This value is inherited from the dataset. |
| "streamingBuffer": { # [Output-only] Contains information regarding this table's streaming buffer, if one is present. This field will be absent if the table is not being streamed to or if there is no data in the streaming buffer. |
| "estimatedBytes": "A String", # [Output-only] A lower-bound estimate of the number of bytes currently in the streaming buffer. |
| "estimatedRows": "A String", # [Output-only] A lower-bound estimate of the number of rows currently in the streaming buffer. |
| "oldestEntryTime": "A String", # [Output-only] Contains the timestamp of the oldest entry in the streaming buffer, in milliseconds since the epoch, if the streaming buffer is available. |
| }, |
| "friendlyName": "A String", # [Optional] A descriptive name for this table. |
| "expirationTime": "A String", # [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. |
| "view": { # [Optional] The view definition. |
| "query": "A String", # [Required] A query that BigQuery executes when the view is referenced. |
| }, |
| "type": "A String", # [Output-only] Describes the table type. The following values are supported: TABLE: A normal BigQuery table. VIEW: A virtual table defined by a SQL query. The default value is TABLE. |
| "id": "A String", # [Output-only] An opaque ID uniquely identifying the table. |
| "selfLink": "A String", # [Output-only] A URL that can be used to access this resource again. |
| "schema": { # [Optional] Describes the schema of this table. |
| "fields": [ # Describes the fields in a table. |
| { |
| "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD. |
| # Object with schema name: TableFieldSchema |
| ], |
| "type": "A String", # [Required] The field data type. Possible values include STRING, INTEGER, FLOAT, BOOLEAN, TIMESTAMP or RECORD (where RECORD indicates that the field contains a nested schema). |
| "description": "A String", # [Optional] The field description. The maximum length is 16K characters. |
| "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters. |
| "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE. |
| }, |
| ], |
| }, |
| } |
| |
| |
| Returns: |
| An object of the form: |
| |
| { |
| "kind": "bigquery#table", # [Output-only] The type of the resource. |
| "lastModifiedTime": "A String", # [Output-only] The time when this table was last modified, in milliseconds since the epoch. |
| "description": "A String", # [Optional] A user-friendly description of this table. |
| "creationTime": "A String", # [Output-only] The time when this table was created, in milliseconds since the epoch. |
| "externalDataConfiguration": { # [Experimental] Describes the data format, location, and other properties of a table stored outside of BigQuery. By defining these properties, the data source can then be queried as if it were a standard BigQuery table. |
| "compression": "A String", # [Optional] The compression type of the data source. Possible values include GZIP and NONE. The default value is NONE. |
| "csvOptions": { # Additional properties to set if sourceFormat is set to CSV. |
| "fieldDelimiter": "A String", # [Optional] The separator for fields in a CSV file. BigQuery converts the string to ISO-8859-1 encoding, and then uses the first byte of the encoded string to split the data in its raw, binary state. BigQuery also supports the escape sequence "\t" to specify a tab separator. The default value is a comma (','). |
| "encoding": "A String", # [Optional] The character encoding of the data. The supported values are UTF-8 or ISO-8859-1. The default value is UTF-8. BigQuery decodes the data after the raw, binary data has been split using the values of the quote and fieldDelimiter properties. |
| "skipLeadingRows": 42, # [Optional] The number of rows at the top of a CSV file that BigQuery will skip when reading the data. The default value is 0. This property is useful if you have header rows in the file that should be skipped. |
| "allowJaggedRows": True or False, # [Optional] Indicates if BigQuery should accept rows that are missing trailing optional columns. If true, BigQuery treats missing trailing columns as null values. If false, records with missing trailing columns are treated as bad records, and if there are too many bad records, an invalid error is returned in the job result. The default value is false. |
| "quote": """, # [Optional] The value that is used to quote data sections in a CSV file. BigQuery converts the string to ISO-8859-1 encoding, and then uses the first byte of the encoded string to split the data in its raw, binary state. The default value is a double-quote ('"'). If your data does not contain quoted sections, set the property value to an empty string. If your data contains quoted newline characters, you must also set the allowQuotedNewlines property to true. |
| "allowQuotedNewlines": True or False, # [Optional] Indicates if BigQuery should allow quoted data sections that contain newline characters in a CSV file. The default value is false. |
| }, |
| "sourceFormat": "A String", # [Required] The data format. For CSV files, specify "CSV". For newline-delimited JSON, specify "NEWLINE_DELIMITED_JSON". |
| "maxBadRecords": 42, # [Optional] The maximum number of bad records that BigQuery can ignore when reading data. If the number of bad records exceeds this value, an invalid error is returned in the job result. The default value is 0, which requires that all records are valid. |
| "ignoreUnknownValues": True or False, # [Optional] Indicates if BigQuery should allow extra values that are not represented in the table schema. If true, the extra values are ignored. If false, records with extra columns are treated as bad records, and if there are too many bad records, an invalid error is returned in the job result. The default value is false. The sourceFormat property determines what BigQuery treats as an extra value: CSV: Trailing columns JSON: Named values that don't match any column names |
| "sourceUris": [ # [Required] The fully-qualified URIs that point to your data in Google Cloud Storage. 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, plus an additional limit of 10 GB maximum size across all URIs. |
| "A String", |
| ], |
| "schema": { # [Required] The schema for the data. |
| "fields": [ # Describes the fields in a table. |
| { |
| "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD. |
| # Object with schema name: TableFieldSchema |
| ], |
| "type": "A String", # [Required] The field data type. Possible values include STRING, INTEGER, FLOAT, BOOLEAN, TIMESTAMP or RECORD (where RECORD indicates that the field contains a nested schema). |
| "description": "A String", # [Optional] The field description. The maximum length is 16K characters. |
| "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters. |
| "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE. |
| }, |
| ], |
| }, |
| }, |
| "tableReference": { # [Required] Reference describing the ID of this table. |
| "projectId": "A String", # [Required] The ID of the project containing this table. |
| "tableId": "A String", # [Required] The ID of the table. The ID must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_). The maximum length is 1,024 characters. |
| "datasetId": "A String", # [Required] The ID of the dataset containing this table. |
| }, |
| "numRows": "A String", # [Output-only] The number of rows of data in this table, excluding any data in the streaming buffer. |
| "numBytes": "A String", # [Output-only] The size of this table in bytes, excluding any data in the streaming buffer. |
| "etag": "A String", # [Output-only] A hash of this resource. |
| "location": "A String", # [Output-only] The geographic location where the table resides. This value is inherited from the dataset. |
| "streamingBuffer": { # [Output-only] Contains information regarding this table's streaming buffer, if one is present. This field will be absent if the table is not being streamed to or if there is no data in the streaming buffer. |
| "estimatedBytes": "A String", # [Output-only] A lower-bound estimate of the number of bytes currently in the streaming buffer. |
| "estimatedRows": "A String", # [Output-only] A lower-bound estimate of the number of rows currently in the streaming buffer. |
| "oldestEntryTime": "A String", # [Output-only] Contains the timestamp of the oldest entry in the streaming buffer, in milliseconds since the epoch, if the streaming buffer is available. |
| }, |
| "friendlyName": "A String", # [Optional] A descriptive name for this table. |
| "expirationTime": "A String", # [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. |
| "view": { # [Optional] The view definition. |
| "query": "A String", # [Required] A query that BigQuery executes when the view is referenced. |
| }, |
| "type": "A String", # [Output-only] Describes the table type. The following values are supported: TABLE: A normal BigQuery table. VIEW: A virtual table defined by a SQL query. The default value is TABLE. |
| "id": "A String", # [Output-only] An opaque ID uniquely identifying the table. |
| "selfLink": "A String", # [Output-only] A URL that can be used to access this resource again. |
| "schema": { # [Optional] Describes the schema of this table. |
| "fields": [ # Describes the fields in a table. |
| { |
| "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD. |
| # Object with schema name: TableFieldSchema |
| ], |
| "type": "A String", # [Required] The field data type. Possible values include STRING, INTEGER, FLOAT, BOOLEAN, TIMESTAMP or RECORD (where RECORD indicates that the field contains a nested schema). |
| "description": "A String", # [Optional] The field description. The maximum length is 16K characters. |
| "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters. |
| "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE. |
| }, |
| ], |
| }, |
| }</pre> |
| </div> |
| |
| <div class="method"> |
| <code class="details" id="list">list(projectId, datasetId, pageToken=None, maxResults=None)</code> |
| <pre>Lists all tables in the specified dataset. Requires the READER dataset role. |
| |
| Args: |
| projectId: string, Project ID of the tables to list (required) |
| datasetId: string, Dataset ID of the tables to list (required) |
| pageToken: string, Page token, returned by a previous call, to request the next page of results |
| maxResults: integer, Maximum number of results to return |
| |
| Returns: |
| An object of the form: |
| |
| { |
| "nextPageToken": "A String", # A token to request the next page of results. |
| "tables": [ # Tables in the requested dataset. |
| { |
| "friendlyName": "A String", # The user-friendly name for this table. |
| "kind": "bigquery#table", # The resource type. |
| "type": "A String", # The type of table. Possible values are: TABLE, VIEW. |
| "id": "A String", # An opaque ID of the table |
| "tableReference": { # A reference uniquely identifying the table. |
| "projectId": "A String", # [Required] The ID of the project containing this table. |
| "tableId": "A String", # [Required] The ID of the table. The ID must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_). The maximum length is 1,024 characters. |
| "datasetId": "A String", # [Required] The ID of the dataset containing this table. |
| }, |
| }, |
| ], |
| "kind": "bigquery#tableList", # The type of list. |
| "etag": "A String", # A hash of this page of results. |
| "totalItems": 42, # The total number of tables in the dataset. |
| }</pre> |
| </div> |
| |
| <div class="method"> |
| <code class="details" id="list_next">list_next(previous_request, previous_response)</code> |
| <pre>Retrieves the next page of results. |
| |
| Args: |
| previous_request: The request for the previous page. (required) |
| previous_response: The response from the request for the previous page. (required) |
| |
| Returns: |
| A request object that you can call 'execute()' on to request the next |
| page. Returns None if there are no more items in the collection. |
| </pre> |
| </div> |
| |
| <div class="method"> |
| <code class="details" id="patch">patch(projectId, datasetId, tableId, body)</code> |
| <pre>Updates information in an existing table. The update method replaces the entire table resource, whereas the patch method only replaces fields that are provided in the submitted table resource. This method supports patch semantics. |
| |
| Args: |
| projectId: string, Project ID of the table to update (required) |
| datasetId: string, Dataset ID of the table to update (required) |
| tableId: string, Table ID of the table to update (required) |
| body: object, The request body. (required) |
| The object takes the form of: |
| |
| { |
| "kind": "bigquery#table", # [Output-only] The type of the resource. |
| "lastModifiedTime": "A String", # [Output-only] The time when this table was last modified, in milliseconds since the epoch. |
| "description": "A String", # [Optional] A user-friendly description of this table. |
| "creationTime": "A String", # [Output-only] The time when this table was created, in milliseconds since the epoch. |
| "externalDataConfiguration": { # [Experimental] Describes the data format, location, and other properties of a table stored outside of BigQuery. By defining these properties, the data source can then be queried as if it were a standard BigQuery table. |
| "compression": "A String", # [Optional] The compression type of the data source. Possible values include GZIP and NONE. The default value is NONE. |
| "csvOptions": { # Additional properties to set if sourceFormat is set to CSV. |
| "fieldDelimiter": "A String", # [Optional] The separator for fields in a CSV file. BigQuery converts the string to ISO-8859-1 encoding, and then uses the first byte of the encoded string to split the data in its raw, binary state. BigQuery also supports the escape sequence "\t" to specify a tab separator. The default value is a comma (','). |
| "encoding": "A String", # [Optional] The character encoding of the data. The supported values are UTF-8 or ISO-8859-1. The default value is UTF-8. BigQuery decodes the data after the raw, binary data has been split using the values of the quote and fieldDelimiter properties. |
| "skipLeadingRows": 42, # [Optional] The number of rows at the top of a CSV file that BigQuery will skip when reading the data. The default value is 0. This property is useful if you have header rows in the file that should be skipped. |
| "allowJaggedRows": True or False, # [Optional] Indicates if BigQuery should accept rows that are missing trailing optional columns. If true, BigQuery treats missing trailing columns as null values. If false, records with missing trailing columns are treated as bad records, and if there are too many bad records, an invalid error is returned in the job result. The default value is false. |
| "quote": """, # [Optional] The value that is used to quote data sections in a CSV file. BigQuery converts the string to ISO-8859-1 encoding, and then uses the first byte of the encoded string to split the data in its raw, binary state. The default value is a double-quote ('"'). If your data does not contain quoted sections, set the property value to an empty string. If your data contains quoted newline characters, you must also set the allowQuotedNewlines property to true. |
| "allowQuotedNewlines": True or False, # [Optional] Indicates if BigQuery should allow quoted data sections that contain newline characters in a CSV file. The default value is false. |
| }, |
| "sourceFormat": "A String", # [Required] The data format. For CSV files, specify "CSV". For newline-delimited JSON, specify "NEWLINE_DELIMITED_JSON". |
| "maxBadRecords": 42, # [Optional] The maximum number of bad records that BigQuery can ignore when reading data. If the number of bad records exceeds this value, an invalid error is returned in the job result. The default value is 0, which requires that all records are valid. |
| "ignoreUnknownValues": True or False, # [Optional] Indicates if BigQuery should allow extra values that are not represented in the table schema. If true, the extra values are ignored. If false, records with extra columns are treated as bad records, and if there are too many bad records, an invalid error is returned in the job result. The default value is false. The sourceFormat property determines what BigQuery treats as an extra value: CSV: Trailing columns JSON: Named values that don't match any column names |
| "sourceUris": [ # [Required] The fully-qualified URIs that point to your data in Google Cloud Storage. 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, plus an additional limit of 10 GB maximum size across all URIs. |
| "A String", |
| ], |
| "schema": { # [Required] The schema for the data. |
| "fields": [ # Describes the fields in a table. |
| { |
| "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD. |
| # Object with schema name: TableFieldSchema |
| ], |
| "type": "A String", # [Required] The field data type. Possible values include STRING, INTEGER, FLOAT, BOOLEAN, TIMESTAMP or RECORD (where RECORD indicates that the field contains a nested schema). |
| "description": "A String", # [Optional] The field description. The maximum length is 16K characters. |
| "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters. |
| "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE. |
| }, |
| ], |
| }, |
| }, |
| "tableReference": { # [Required] Reference describing the ID of this table. |
| "projectId": "A String", # [Required] The ID of the project containing this table. |
| "tableId": "A String", # [Required] The ID of the table. The ID must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_). The maximum length is 1,024 characters. |
| "datasetId": "A String", # [Required] The ID of the dataset containing this table. |
| }, |
| "numRows": "A String", # [Output-only] The number of rows of data in this table, excluding any data in the streaming buffer. |
| "numBytes": "A String", # [Output-only] The size of this table in bytes, excluding any data in the streaming buffer. |
| "etag": "A String", # [Output-only] A hash of this resource. |
| "location": "A String", # [Output-only] The geographic location where the table resides. This value is inherited from the dataset. |
| "streamingBuffer": { # [Output-only] Contains information regarding this table's streaming buffer, if one is present. This field will be absent if the table is not being streamed to or if there is no data in the streaming buffer. |
| "estimatedBytes": "A String", # [Output-only] A lower-bound estimate of the number of bytes currently in the streaming buffer. |
| "estimatedRows": "A String", # [Output-only] A lower-bound estimate of the number of rows currently in the streaming buffer. |
| "oldestEntryTime": "A String", # [Output-only] Contains the timestamp of the oldest entry in the streaming buffer, in milliseconds since the epoch, if the streaming buffer is available. |
| }, |
| "friendlyName": "A String", # [Optional] A descriptive name for this table. |
| "expirationTime": "A String", # [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. |
| "view": { # [Optional] The view definition. |
| "query": "A String", # [Required] A query that BigQuery executes when the view is referenced. |
| }, |
| "type": "A String", # [Output-only] Describes the table type. The following values are supported: TABLE: A normal BigQuery table. VIEW: A virtual table defined by a SQL query. The default value is TABLE. |
| "id": "A String", # [Output-only] An opaque ID uniquely identifying the table. |
| "selfLink": "A String", # [Output-only] A URL that can be used to access this resource again. |
| "schema": { # [Optional] Describes the schema of this table. |
| "fields": [ # Describes the fields in a table. |
| { |
| "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD. |
| # Object with schema name: TableFieldSchema |
| ], |
| "type": "A String", # [Required] The field data type. Possible values include STRING, INTEGER, FLOAT, BOOLEAN, TIMESTAMP or RECORD (where RECORD indicates that the field contains a nested schema). |
| "description": "A String", # [Optional] The field description. The maximum length is 16K characters. |
| "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters. |
| "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE. |
| }, |
| ], |
| }, |
| } |
| |
| |
| Returns: |
| An object of the form: |
| |
| { |
| "kind": "bigquery#table", # [Output-only] The type of the resource. |
| "lastModifiedTime": "A String", # [Output-only] The time when this table was last modified, in milliseconds since the epoch. |
| "description": "A String", # [Optional] A user-friendly description of this table. |
| "creationTime": "A String", # [Output-only] The time when this table was created, in milliseconds since the epoch. |
| "externalDataConfiguration": { # [Experimental] Describes the data format, location, and other properties of a table stored outside of BigQuery. By defining these properties, the data source can then be queried as if it were a standard BigQuery table. |
| "compression": "A String", # [Optional] The compression type of the data source. Possible values include GZIP and NONE. The default value is NONE. |
| "csvOptions": { # Additional properties to set if sourceFormat is set to CSV. |
| "fieldDelimiter": "A String", # [Optional] The separator for fields in a CSV file. BigQuery converts the string to ISO-8859-1 encoding, and then uses the first byte of the encoded string to split the data in its raw, binary state. BigQuery also supports the escape sequence "\t" to specify a tab separator. The default value is a comma (','). |
| "encoding": "A String", # [Optional] The character encoding of the data. The supported values are UTF-8 or ISO-8859-1. The default value is UTF-8. BigQuery decodes the data after the raw, binary data has been split using the values of the quote and fieldDelimiter properties. |
| "skipLeadingRows": 42, # [Optional] The number of rows at the top of a CSV file that BigQuery will skip when reading the data. The default value is 0. This property is useful if you have header rows in the file that should be skipped. |
| "allowJaggedRows": True or False, # [Optional] Indicates if BigQuery should accept rows that are missing trailing optional columns. If true, BigQuery treats missing trailing columns as null values. If false, records with missing trailing columns are treated as bad records, and if there are too many bad records, an invalid error is returned in the job result. The default value is false. |
| "quote": """, # [Optional] The value that is used to quote data sections in a CSV file. BigQuery converts the string to ISO-8859-1 encoding, and then uses the first byte of the encoded string to split the data in its raw, binary state. The default value is a double-quote ('"'). If your data does not contain quoted sections, set the property value to an empty string. If your data contains quoted newline characters, you must also set the allowQuotedNewlines property to true. |
| "allowQuotedNewlines": True or False, # [Optional] Indicates if BigQuery should allow quoted data sections that contain newline characters in a CSV file. The default value is false. |
| }, |
| "sourceFormat": "A String", # [Required] The data format. For CSV files, specify "CSV". For newline-delimited JSON, specify "NEWLINE_DELIMITED_JSON". |
| "maxBadRecords": 42, # [Optional] The maximum number of bad records that BigQuery can ignore when reading data. If the number of bad records exceeds this value, an invalid error is returned in the job result. The default value is 0, which requires that all records are valid. |
| "ignoreUnknownValues": True or False, # [Optional] Indicates if BigQuery should allow extra values that are not represented in the table schema. If true, the extra values are ignored. If false, records with extra columns are treated as bad records, and if there are too many bad records, an invalid error is returned in the job result. The default value is false. The sourceFormat property determines what BigQuery treats as an extra value: CSV: Trailing columns JSON: Named values that don't match any column names |
| "sourceUris": [ # [Required] The fully-qualified URIs that point to your data in Google Cloud Storage. 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, plus an additional limit of 10 GB maximum size across all URIs. |
| "A String", |
| ], |
| "schema": { # [Required] The schema for the data. |
| "fields": [ # Describes the fields in a table. |
| { |
| "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD. |
| # Object with schema name: TableFieldSchema |
| ], |
| "type": "A String", # [Required] The field data type. Possible values include STRING, INTEGER, FLOAT, BOOLEAN, TIMESTAMP or RECORD (where RECORD indicates that the field contains a nested schema). |
| "description": "A String", # [Optional] The field description. The maximum length is 16K characters. |
| "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters. |
| "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE. |
| }, |
| ], |
| }, |
| }, |
| "tableReference": { # [Required] Reference describing the ID of this table. |
| "projectId": "A String", # [Required] The ID of the project containing this table. |
| "tableId": "A String", # [Required] The ID of the table. The ID must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_). The maximum length is 1,024 characters. |
| "datasetId": "A String", # [Required] The ID of the dataset containing this table. |
| }, |
| "numRows": "A String", # [Output-only] The number of rows of data in this table, excluding any data in the streaming buffer. |
| "numBytes": "A String", # [Output-only] The size of this table in bytes, excluding any data in the streaming buffer. |
| "etag": "A String", # [Output-only] A hash of this resource. |
| "location": "A String", # [Output-only] The geographic location where the table resides. This value is inherited from the dataset. |
| "streamingBuffer": { # [Output-only] Contains information regarding this table's streaming buffer, if one is present. This field will be absent if the table is not being streamed to or if there is no data in the streaming buffer. |
| "estimatedBytes": "A String", # [Output-only] A lower-bound estimate of the number of bytes currently in the streaming buffer. |
| "estimatedRows": "A String", # [Output-only] A lower-bound estimate of the number of rows currently in the streaming buffer. |
| "oldestEntryTime": "A String", # [Output-only] Contains the timestamp of the oldest entry in the streaming buffer, in milliseconds since the epoch, if the streaming buffer is available. |
| }, |
| "friendlyName": "A String", # [Optional] A descriptive name for this table. |
| "expirationTime": "A String", # [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. |
| "view": { # [Optional] The view definition. |
| "query": "A String", # [Required] A query that BigQuery executes when the view is referenced. |
| }, |
| "type": "A String", # [Output-only] Describes the table type. The following values are supported: TABLE: A normal BigQuery table. VIEW: A virtual table defined by a SQL query. The default value is TABLE. |
| "id": "A String", # [Output-only] An opaque ID uniquely identifying the table. |
| "selfLink": "A String", # [Output-only] A URL that can be used to access this resource again. |
| "schema": { # [Optional] Describes the schema of this table. |
| "fields": [ # Describes the fields in a table. |
| { |
| "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD. |
| # Object with schema name: TableFieldSchema |
| ], |
| "type": "A String", # [Required] The field data type. Possible values include STRING, INTEGER, FLOAT, BOOLEAN, TIMESTAMP or RECORD (where RECORD indicates that the field contains a nested schema). |
| "description": "A String", # [Optional] The field description. The maximum length is 16K characters. |
| "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters. |
| "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE. |
| }, |
| ], |
| }, |
| }</pre> |
| </div> |
| |
| <div class="method"> |
| <code class="details" id="update">update(projectId, datasetId, tableId, body)</code> |
| <pre>Updates information in an existing table. The update method replaces the entire table resource, whereas the patch method only replaces fields that are provided in the submitted table resource. |
| |
| Args: |
| projectId: string, Project ID of the table to update (required) |
| datasetId: string, Dataset ID of the table to update (required) |
| tableId: string, Table ID of the table to update (required) |
| body: object, The request body. (required) |
| The object takes the form of: |
| |
| { |
| "kind": "bigquery#table", # [Output-only] The type of the resource. |
| "lastModifiedTime": "A String", # [Output-only] The time when this table was last modified, in milliseconds since the epoch. |
| "description": "A String", # [Optional] A user-friendly description of this table. |
| "creationTime": "A String", # [Output-only] The time when this table was created, in milliseconds since the epoch. |
| "externalDataConfiguration": { # [Experimental] Describes the data format, location, and other properties of a table stored outside of BigQuery. By defining these properties, the data source can then be queried as if it were a standard BigQuery table. |
| "compression": "A String", # [Optional] The compression type of the data source. Possible values include GZIP and NONE. The default value is NONE. |
| "csvOptions": { # Additional properties to set if sourceFormat is set to CSV. |
| "fieldDelimiter": "A String", # [Optional] The separator for fields in a CSV file. BigQuery converts the string to ISO-8859-1 encoding, and then uses the first byte of the encoded string to split the data in its raw, binary state. BigQuery also supports the escape sequence "\t" to specify a tab separator. The default value is a comma (','). |
| "encoding": "A String", # [Optional] The character encoding of the data. The supported values are UTF-8 or ISO-8859-1. The default value is UTF-8. BigQuery decodes the data after the raw, binary data has been split using the values of the quote and fieldDelimiter properties. |
| "skipLeadingRows": 42, # [Optional] The number of rows at the top of a CSV file that BigQuery will skip when reading the data. The default value is 0. This property is useful if you have header rows in the file that should be skipped. |
| "allowJaggedRows": True or False, # [Optional] Indicates if BigQuery should accept rows that are missing trailing optional columns. If true, BigQuery treats missing trailing columns as null values. If false, records with missing trailing columns are treated as bad records, and if there are too many bad records, an invalid error is returned in the job result. The default value is false. |
| "quote": """, # [Optional] The value that is used to quote data sections in a CSV file. BigQuery converts the string to ISO-8859-1 encoding, and then uses the first byte of the encoded string to split the data in its raw, binary state. The default value is a double-quote ('"'). If your data does not contain quoted sections, set the property value to an empty string. If your data contains quoted newline characters, you must also set the allowQuotedNewlines property to true. |
| "allowQuotedNewlines": True or False, # [Optional] Indicates if BigQuery should allow quoted data sections that contain newline characters in a CSV file. The default value is false. |
| }, |
| "sourceFormat": "A String", # [Required] The data format. For CSV files, specify "CSV". For newline-delimited JSON, specify "NEWLINE_DELIMITED_JSON". |
| "maxBadRecords": 42, # [Optional] The maximum number of bad records that BigQuery can ignore when reading data. If the number of bad records exceeds this value, an invalid error is returned in the job result. The default value is 0, which requires that all records are valid. |
| "ignoreUnknownValues": True or False, # [Optional] Indicates if BigQuery should allow extra values that are not represented in the table schema. If true, the extra values are ignored. If false, records with extra columns are treated as bad records, and if there are too many bad records, an invalid error is returned in the job result. The default value is false. The sourceFormat property determines what BigQuery treats as an extra value: CSV: Trailing columns JSON: Named values that don't match any column names |
| "sourceUris": [ # [Required] The fully-qualified URIs that point to your data in Google Cloud Storage. 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, plus an additional limit of 10 GB maximum size across all URIs. |
| "A String", |
| ], |
| "schema": { # [Required] The schema for the data. |
| "fields": [ # Describes the fields in a table. |
| { |
| "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD. |
| # Object with schema name: TableFieldSchema |
| ], |
| "type": "A String", # [Required] The field data type. Possible values include STRING, INTEGER, FLOAT, BOOLEAN, TIMESTAMP or RECORD (where RECORD indicates that the field contains a nested schema). |
| "description": "A String", # [Optional] The field description. The maximum length is 16K characters. |
| "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters. |
| "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE. |
| }, |
| ], |
| }, |
| }, |
| "tableReference": { # [Required] Reference describing the ID of this table. |
| "projectId": "A String", # [Required] The ID of the project containing this table. |
| "tableId": "A String", # [Required] The ID of the table. The ID must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_). The maximum length is 1,024 characters. |
| "datasetId": "A String", # [Required] The ID of the dataset containing this table. |
| }, |
| "numRows": "A String", # [Output-only] The number of rows of data in this table, excluding any data in the streaming buffer. |
| "numBytes": "A String", # [Output-only] The size of this table in bytes, excluding any data in the streaming buffer. |
| "etag": "A String", # [Output-only] A hash of this resource. |
| "location": "A String", # [Output-only] The geographic location where the table resides. This value is inherited from the dataset. |
| "streamingBuffer": { # [Output-only] Contains information regarding this table's streaming buffer, if one is present. This field will be absent if the table is not being streamed to or if there is no data in the streaming buffer. |
| "estimatedBytes": "A String", # [Output-only] A lower-bound estimate of the number of bytes currently in the streaming buffer. |
| "estimatedRows": "A String", # [Output-only] A lower-bound estimate of the number of rows currently in the streaming buffer. |
| "oldestEntryTime": "A String", # [Output-only] Contains the timestamp of the oldest entry in the streaming buffer, in milliseconds since the epoch, if the streaming buffer is available. |
| }, |
| "friendlyName": "A String", # [Optional] A descriptive name for this table. |
| "expirationTime": "A String", # [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. |
| "view": { # [Optional] The view definition. |
| "query": "A String", # [Required] A query that BigQuery executes when the view is referenced. |
| }, |
| "type": "A String", # [Output-only] Describes the table type. The following values are supported: TABLE: A normal BigQuery table. VIEW: A virtual table defined by a SQL query. The default value is TABLE. |
| "id": "A String", # [Output-only] An opaque ID uniquely identifying the table. |
| "selfLink": "A String", # [Output-only] A URL that can be used to access this resource again. |
| "schema": { # [Optional] Describes the schema of this table. |
| "fields": [ # Describes the fields in a table. |
| { |
| "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD. |
| # Object with schema name: TableFieldSchema |
| ], |
| "type": "A String", # [Required] The field data type. Possible values include STRING, INTEGER, FLOAT, BOOLEAN, TIMESTAMP or RECORD (where RECORD indicates that the field contains a nested schema). |
| "description": "A String", # [Optional] The field description. The maximum length is 16K characters. |
| "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters. |
| "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE. |
| }, |
| ], |
| }, |
| } |
| |
| |
| Returns: |
| An object of the form: |
| |
| { |
| "kind": "bigquery#table", # [Output-only] The type of the resource. |
| "lastModifiedTime": "A String", # [Output-only] The time when this table was last modified, in milliseconds since the epoch. |
| "description": "A String", # [Optional] A user-friendly description of this table. |
| "creationTime": "A String", # [Output-only] The time when this table was created, in milliseconds since the epoch. |
| "externalDataConfiguration": { # [Experimental] Describes the data format, location, and other properties of a table stored outside of BigQuery. By defining these properties, the data source can then be queried as if it were a standard BigQuery table. |
| "compression": "A String", # [Optional] The compression type of the data source. Possible values include GZIP and NONE. The default value is NONE. |
| "csvOptions": { # Additional properties to set if sourceFormat is set to CSV. |
| "fieldDelimiter": "A String", # [Optional] The separator for fields in a CSV file. BigQuery converts the string to ISO-8859-1 encoding, and then uses the first byte of the encoded string to split the data in its raw, binary state. BigQuery also supports the escape sequence "\t" to specify a tab separator. The default value is a comma (','). |
| "encoding": "A String", # [Optional] The character encoding of the data. The supported values are UTF-8 or ISO-8859-1. The default value is UTF-8. BigQuery decodes the data after the raw, binary data has been split using the values of the quote and fieldDelimiter properties. |
| "skipLeadingRows": 42, # [Optional] The number of rows at the top of a CSV file that BigQuery will skip when reading the data. The default value is 0. This property is useful if you have header rows in the file that should be skipped. |
| "allowJaggedRows": True or False, # [Optional] Indicates if BigQuery should accept rows that are missing trailing optional columns. If true, BigQuery treats missing trailing columns as null values. If false, records with missing trailing columns are treated as bad records, and if there are too many bad records, an invalid error is returned in the job result. The default value is false. |
| "quote": """, # [Optional] The value that is used to quote data sections in a CSV file. BigQuery converts the string to ISO-8859-1 encoding, and then uses the first byte of the encoded string to split the data in its raw, binary state. The default value is a double-quote ('"'). If your data does not contain quoted sections, set the property value to an empty string. If your data contains quoted newline characters, you must also set the allowQuotedNewlines property to true. |
| "allowQuotedNewlines": True or False, # [Optional] Indicates if BigQuery should allow quoted data sections that contain newline characters in a CSV file. The default value is false. |
| }, |
| "sourceFormat": "A String", # [Required] The data format. For CSV files, specify "CSV". For newline-delimited JSON, specify "NEWLINE_DELIMITED_JSON". |
| "maxBadRecords": 42, # [Optional] The maximum number of bad records that BigQuery can ignore when reading data. If the number of bad records exceeds this value, an invalid error is returned in the job result. The default value is 0, which requires that all records are valid. |
| "ignoreUnknownValues": True or False, # [Optional] Indicates if BigQuery should allow extra values that are not represented in the table schema. If true, the extra values are ignored. If false, records with extra columns are treated as bad records, and if there are too many bad records, an invalid error is returned in the job result. The default value is false. The sourceFormat property determines what BigQuery treats as an extra value: CSV: Trailing columns JSON: Named values that don't match any column names |
| "sourceUris": [ # [Required] The fully-qualified URIs that point to your data in Google Cloud Storage. 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, plus an additional limit of 10 GB maximum size across all URIs. |
| "A String", |
| ], |
| "schema": { # [Required] The schema for the data. |
| "fields": [ # Describes the fields in a table. |
| { |
| "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD. |
| # Object with schema name: TableFieldSchema |
| ], |
| "type": "A String", # [Required] The field data type. Possible values include STRING, INTEGER, FLOAT, BOOLEAN, TIMESTAMP or RECORD (where RECORD indicates that the field contains a nested schema). |
| "description": "A String", # [Optional] The field description. The maximum length is 16K characters. |
| "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters. |
| "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE. |
| }, |
| ], |
| }, |
| }, |
| "tableReference": { # [Required] Reference describing the ID of this table. |
| "projectId": "A String", # [Required] The ID of the project containing this table. |
| "tableId": "A String", # [Required] The ID of the table. The ID must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_). The maximum length is 1,024 characters. |
| "datasetId": "A String", # [Required] The ID of the dataset containing this table. |
| }, |
| "numRows": "A String", # [Output-only] The number of rows of data in this table, excluding any data in the streaming buffer. |
| "numBytes": "A String", # [Output-only] The size of this table in bytes, excluding any data in the streaming buffer. |
| "etag": "A String", # [Output-only] A hash of this resource. |
| "location": "A String", # [Output-only] The geographic location where the table resides. This value is inherited from the dataset. |
| "streamingBuffer": { # [Output-only] Contains information regarding this table's streaming buffer, if one is present. This field will be absent if the table is not being streamed to or if there is no data in the streaming buffer. |
| "estimatedBytes": "A String", # [Output-only] A lower-bound estimate of the number of bytes currently in the streaming buffer. |
| "estimatedRows": "A String", # [Output-only] A lower-bound estimate of the number of rows currently in the streaming buffer. |
| "oldestEntryTime": "A String", # [Output-only] Contains the timestamp of the oldest entry in the streaming buffer, in milliseconds since the epoch, if the streaming buffer is available. |
| }, |
| "friendlyName": "A String", # [Optional] A descriptive name for this table. |
| "expirationTime": "A String", # [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. |
| "view": { # [Optional] The view definition. |
| "query": "A String", # [Required] A query that BigQuery executes when the view is referenced. |
| }, |
| "type": "A String", # [Output-only] Describes the table type. The following values are supported: TABLE: A normal BigQuery table. VIEW: A virtual table defined by a SQL query. The default value is TABLE. |
| "id": "A String", # [Output-only] An opaque ID uniquely identifying the table. |
| "selfLink": "A String", # [Output-only] A URL that can be used to access this resource again. |
| "schema": { # [Optional] Describes the schema of this table. |
| "fields": [ # Describes the fields in a table. |
| { |
| "fields": [ # [Optional] Describes the nested schema fields if the type property is set to RECORD. |
| # Object with schema name: TableFieldSchema |
| ], |
| "type": "A String", # [Required] The field data type. Possible values include STRING, INTEGER, FLOAT, BOOLEAN, TIMESTAMP or RECORD (where RECORD indicates that the field contains a nested schema). |
| "description": "A String", # [Optional] The field description. The maximum length is 16K characters. |
| "name": "A String", # [Required] The field name. The name must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_), and must start with a letter or underscore. The maximum length is 128 characters. |
| "mode": "A String", # [Optional] The field mode. Possible values include NULLABLE, REQUIRED and REPEATED. The default value is NULLABLE. |
| }, |
| ], |
| }, |
| }</pre> |
| </div> |
| |
| </body></html> |