Defining Google BigQuery Tables
The following properties are applicable to a Google BigQuery Table object.
Tab |
Property |
Description |
Additional Information |
---|---|---|---|
Physical Name | Specifies the physical name of the table |
|
|
Dataset | Specifies the dataset to which the table belongs | ||
Project | Specifies the project to which the dataset belongs | ||
Use Replace Syntax | Specifies whether the REPLACE syntax is used | Selecting this option replaces the syntax with the new DDL that is generated during Forward Engineering. | |
If Not Exists | Specifies that if the table already exists, no exception is thrown, and no action happens | ||
Table Type | Specifies the table type |
Base: Indicates a standard table Clone: Indicates that a standard table is restored from the table snapshot Copy: Indicates that a table is created with the same metadata and data from another table External: Indicates that the table's data is stored in an external data source Like: Indicates that the table is created based on another table and has the same metadata of the specified table Snapshot: Indicates that the table is snapshot of a base table at a given timestamp Temp: Indicates that the table is temporary |
|
|
Physical Only |
Specifies whether the table appears in a physical model only |
|
Generate | Specifies whether a DDL statement is generated for the table during forward engineering | ||
General | Label List | Specifies an array of labels for the dataset, expressed as key-value pairs |
|
Name |
Specifies the name of the table |
|
|
Physical Name | Specifies the physical name of the table |
|
|
Harden Strategy |
Specifies the name of the hardening strategy for a table |
Inherit: Indicates to adopt the existing naming conventions established by your organization Override: Indicates that the existing naming conventions are overwritten with the new one Harden: Indicates that the naming conventions are hardened across the organization |
|
Default Collation |
Specifies the default collation specification for the object |
|
|
Default Rounding Mode |
Specifies the rounding mode for the tables |
|
|
Expiration Timestamp | Specifies the exact time when this table expires, in milliseconds, enclosed in quotation marks |
|
|
Friendly Name | Specifies the user-friendly name for the table, enclosed in quotation marks |
|
|
KMS Key Name | Specifies the Cloud KMS key for encrypting table data in the dataset, enclosed in quotation marks |
|
|
Allow Jagged Rows | Specifies whether the table accepts rows in CSV files that are missing trailing optional columns | Available when Table Type is set to External | |
Allow Quoted Newlines | Specifies whether the table allows quoted data sections that contain newline characters in a CSV file | Available when Table Type is set to External | |
Bigtable Options |
Specifies the schema of the external Bigtable in JSON format |
Available when Table Type is set to External | |
Compression | Specifies the compressed CSV or JSON data, enclosed in quotation marks | Available when Table Type is set to External | |
Connection Name |
Specifies connection resources for accessing the remote endpoint |
Available when Table Type is set to External | |
Decimal Target Types | Specifies how to convert a Decimal type |
For example, ["NUMERIC", "BIGNUMERIC"]. Available when Table Type is set to External |
|
Enable List Inference |
Specifies whether to use schema inference for Parquet LIST logical type |
Available when Table Type is set to External. Applicable to Parquet data. |
|
Enable Logical Types | Specifies the converted Avro logical types into their corresponding SQL types |
Applies only to Avro data. Available when Table Type is set to External |
|
Encoding | Specifies CSV files with data encoded in ISO-8859-1 (also known as Latin-1) format, enclosed in quotation marks |
Supported values are UTF8 (or UTF-8) and ISO_8859_1 (or ISO-8859-1) Available when Table Type is set to External |
|
Enum As Strings |
Specifies whether to infer the Parquet ENUM logical type as STRING instead of BYTES |
Available when Table Type is set to External. Applicable to Parquet data. |
|
Expiration Timestamp |
Specifies the table expiry time. |
The table will only expire if specified. Available when Table Type is set to External |
|
Field Delimiter | Specifies the separator for fields in a CSV file, enclosed in quotation marks |
For example, any single-byte character Available when Table Type is set to External |
|
File Set Spec Type | Specifies how to interpret the source URIs for load jobs and external tables |
Valid Values: FILE_SYSTEM_MATCH: Indicates to expand the source URIs by listing files from the object store. This is the default behavior if FileSetSpecType is not set. NEW_LINE_DELIMITED_MANIFEST: Indicates that the given URIs are manifest files separated by newlines, with one URI per line. |
|
Format | Specifies the format of the external data, enclosed in quotation marks |
Supported values are AVRO, CSV, DATASTORE_BACKUP, GOOGLE_SHEETS, NEWLINE_DELIMITED_JSON (or JSON), ORC, and PARQUET Available when Table Type is set to External |
|
Hive Partition URI Prefix | Specifies a common prefix for all source URIs before the partition key encoding begins |
Applies to Avro, CSV, JSON, Parquet, and ORC data Available when Table Type is set to External |
|
Ignore Unknown Values | Specifies whether to allow and ignore extra, unrecognized values in CSV or JSON data | Available when Table Type is set to External
|
|
JSON Extension | Specifies the JSON extension, enclosed in quotation marks | ||
Max Bad Records | Specifies the maximum number of bad records to ignore when reading the data in CSV, JSON, and Sheets data | ||
Max Staleness |
Specifies the maximum time interval to read the stale data in the table. The table copy operation is not allowed if the data is more staler than the specified time. To disable data caching, specify the value 0. |
This option is not available when the Table Type is set to Snapshot. | |
Metadata Cache Mode |
Specifies how the metadata cache mode is refreshed at a defined interval |
Available when Table Type is set to External | |
Null Marker | Specifies the string that represents NULL values in a CSV file, enclosed in quotation marks | ||
Object Metadata |
Specifies the object metadata of the object table |
||
Preserve Ascii Control Characters |
Specifies whether the embedded ASCII control characters in the ASCII tables are preserved |
||
Projection Fields | Specifies list of entity properties to load in Datastore data, enclosed in quotation marks | ||
Quote | Specifies the string used to quote data sections in a CSV file, enclosed in quotation marks | ||
Reference File Schema URI |
Specifies the reference file with the table schema |
Applies to Avro, CSV, JSON, Parquet, and ORC data. Available when Table Type is set to External |
|
Require Hive Partition Filter | Specifies whether all queries of table require a partition filter that can be used to eliminate partitions when reading data in Avro, CSV, JSON, Parquet, and ORC data, enclosed in quotation marks |
Applies only to hive-partitioned external tables Available when Table Type is set to External |
|
Sheet Range | Specifies the range of a Sheets spreadsheet to query from, enclosed in quotation marks |
For example, “sheet1!A1:B20” Available when Table Type is set to External |
|
Skip Leading Rows | Specifies the number of rows at the top of a file to skip when reading the data in CSV and Sheets data | Available when Table Type is set to External | |
URIs | Specifies an array of fully qualified URIs for the external data locations | Available when Table Type is set to External | |
Source Table | Specifies a standard table | Available when Table Type is set to Clone, Copy, Like, or Snapshot | |
Clustering |
Clustering Column List | Specifies the list of columns based on which the table’s data is organized for a clustered table |
|
Physical Data Type | Specifies the data type of the selected column |
|
|
Query Statement | Specifies a valid standalone SQL statement to execute | ||
Partitions | Column | Specifies the list of available columns for partition |
|
Physical Data Type | Specifies the physical data type for the selected column | ||
Ingestion Options | Specifies the type of pre-defined partition |
Available when Table Type is set to Base, Like, or Temp. PATITIONDATE: Indicates the date of the pre-defiened partition. PARTITIONTIME: Indicates the time of the pre-defiened partition. |
|
Partition Expiration in Days | Specifies the number of days after which a table partition is deleted |
This option is not available when the Table Type is set to External, or Snapshot. |
|
Require Partition Filter | Specifies whether the table requires a partition filter that can be used for partition elimination to be specified |
|
|
Scheme | Specifies how the table is partitioned |
Available when Table Type is set to Base, Like, or Temp. DATE: Indicates partition by ingestion time with daily partition DATE_TRUNC: Indicates partition by a DATE column with the specified partitioning type TIMESTAMP_TRUNC: Indicates partition by ingestion time with the specified partitioning type DATETIME_TRUNC: Indicates partition by a DATETIME column with the specified partitioning type RANGE_BUCKET: Indicates partition by an integer column with the specified range |
|
Schema Options | Specifies the option to partition table via schema | Available when Schema is set to Date_Trunc, Timestamp_Trunc, or Datetime_Trunc. | |
Start | Specifies the start of range partitioning | Available when Scheme is set to Range Bucket | |
End | Specifies the end of range partitioning | Available when Scheme is set to Range Bucket | |
Interval | Specifies the width of each range within the partition | Available when Scheme is set to Range Bucket |
Copyright © 2024 Quest Software, Inc. |