BigQuery Table

A BigQuery Table in Google Cloud is a structured dataset container that stores rows and columns of data within a BigQuery dataset. It supports both structured and semi-structured data, enabling fast SQL-based queries at scale. Tables can be partitioned and clustered for performance optimization and cost efficiency.

gcp.bigquery_table

Fields

TitleIDTypeData TypeDescription
_keycorestring
ancestorscorearray<string>
clone_definitioncorejsonOutput only. Contains information about the clone. This value is set via the clone operation.
clusteringcorejsonClustering specification for the table. Must be specified with time-based partitioning, data in the table will be first partitioned and subsequently clustered.
creation_timecoreint64Output only. The time when this table was created, in milliseconds since the epoch.
datadog_display_namecorestring
default_collationcorestringOptional. Defines the default collation specification of new STRING fields in the table. During table creation or update, if a STRING field is added to this table without explicit collation specified, then the table inherits the table default collation. A change to this field affects only fields added afterwards, and does not alter the existing fields. The following values are supported: * 'und:ci': undetermined locale, case insensitive. * '': empty string. Default to case-sensitive behavior.
default_rounding_modecorestringOptional. Defines the default rounding mode specification of new decimal fields (NUMERIC OR BIGNUMERIC) in the table. During table creation or update, if a decimal field is added to this table without an explicit rounding mode specified, then the field inherits the table default rounding mode. Changing this field doesn't affect existing fields.
descriptioncorestringOptional. A user-friendly description of this table.
encryption_configurationcorejsonCustom encryption configuration (e.g., Cloud KMS keys).
etagcorestringOutput only. A hash of this resource.
expiration_timecoreint64Optional. 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. The defaultTableExpirationMs property of the encapsulating dataset can be used to set a default expirationTime on newly created tables.
external_data_configurationcorejsonOptional. 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.
friendly_namecorestringOptional. A descriptive name for this table.
idcorestringOutput only. An opaque ID uniquely identifying the table.
kindcorestringThe type of resource ID.
labelscorearray<string>The labels associated with this table. You can use these to organize and group your tables. Label keys and values can be no longer than 63 characters, can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter and each label in the list must have a different key.
last_modified_timecoreint64Output only. The time when this table was last modified, in milliseconds since the epoch.
locationcorestringOutput only. The geographic location where the table resides. This value is inherited from the dataset.
materialized_viewcorejsonOptional. The materialized view definition.
modelcorejsonDeprecated.
num_active_logical_bytescoreint64Output only. Number of logical bytes that are less than 90 days old.
num_active_physical_bytescoreint64Output only. Number of physical bytes less than 90 days old. This data is not kept in real time, and might be delayed by a few seconds to a few minutes.
num_bytescoreint64Output only. The size of this table in logical bytes, excluding any data in the streaming buffer.
num_long_term_bytescoreint64Output only. The number of logical bytes in the table that are considered "long-term storage".
num_long_term_logical_bytescoreint64Output only. Number of logical bytes that are more than 90 days old.
num_long_term_physical_bytescoreint64Output only. Number of physical bytes more than 90 days old. This data is not kept in real time, and might be delayed by a few seconds to a few minutes.
num_partitionscoreint64Output only. The number of partitions present in the table or materialized view. This data is not kept in real time, and might be delayed by a few seconds to a few minutes.
num_physical_bytescoreint64Output only. The physical size of this table in bytes. This includes storage used for time travel.
num_rowscoreint64Output only. The number of rows of data in this table, excluding any data in the streaming buffer.
num_time_travel_physical_bytescoreint64Output only. Number of physical bytes used by time travel storage (deleted or changed data). This data is not kept in real time, and might be delayed by a few seconds to a few minutes.
num_total_logical_bytescoreint64Output only. Total number of logical bytes in the table or materialized view.
num_total_physical_bytescoreint64Output only. The physical size of this table in bytes. This also includes storage used for time travel. This data is not kept in real time, and might be delayed by a few seconds to a few minutes.
organization_idcorestring
parentcorestring
project_idcorestring
project_numbercorestring
range_partitioningcorejsonIf specified, configures range partitioning for this table.
require_partition_filtercoreboolOptional. If set to true, queries over this table require a partition filter that can be used for partition elimination to be specified.
resource_namecorestring
schemacorejsonOptional. Describes the schema of this table.
self_linkcorestringOutput only. A URL that can be used to access this resource again.
snapshot_definitioncorejsonOutput only. Contains information about the snapshot. This value is set via snapshot creation.
streaming_buffercorejsonOutput 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.
table_constraintscorejsonOptional. Tables Primary Key and Foreign Key information
table_referencecorejsonRequired. Reference describing the ID of this table.
tagscorehstore
time_partitioningcorejsonIf specified, configures time-based partitioning for this table.
typecorestringOutput only. Describes the table type. The following values are supported: * `TABLE`: A normal BigQuery table. * `VIEW`: A virtual table defined by a SQL query. * `EXTERNAL`: A table that references data stored in an external storage system, such as Google Cloud Storage. * `MATERIALIZED_VIEW`: A precomputed view defined by a SQL query. * `SNAPSHOT`: An immutable BigQuery table that preserves the contents of a base table at a particular time. See additional information on [table snapshots](https://cloud.google.com/bigquery/docs/table-snapshots-intro). The default value is `TABLE`.
viewcorejsonOptional. The view definition.