Get a BigQuery table’s metadata.
type: "io.kestra.plugin.gcp.bigquery.tablemetadata"Examples
id: gcp_bq_table_metadata
namespace: company.team
tasks:
- id: table_metadata
type: io.kestra.plugin.gcp.bigquery.TableMetadata
projectId: my-project
dataset: my-dataset
table: my-table
Properties
dataset*Requiredstring
The dataset's user-defined ID.
table*Requiredstring
The table's user-defined ID.
ifNotExistsstring
ERRORERRORSKIPPolicy to apply if a table don't exists.
If the policy is SKIP, the output will contain only null value, otherwise an error is raised.
impersonatedServiceAccountstring
The GCP service account to impersonate.
locationstring
The geographic location where the dataset should reside.
This property is experimental and might be subject to change or removed.
See Dataset Location
projectIdstring
The GCP project ID.
retryAutoNon-dynamic
Automatic retry for retryable BigQuery exceptions.
Some exceptions (especially rate limit) are not retried by default by BigQuery client, we use by default a transparent retry (not the kestra one) to handle this case. The default values are exponential of 5 seconds for a maximum of 15 minutes and ten attempts
io.kestra.core.models.tasks.retrys.Constant
durationRETRY_FAILED_TASKRETRY_FAILED_TASKCREATE_NEW_EXECUTION>= 1durationfalseio.kestra.core.models.tasks.retrys.Exponential
durationdurationRETRY_FAILED_TASKRETRY_FAILED_TASKCREATE_NEW_EXECUTION>= 1durationfalseio.kestra.core.models.tasks.retrys.Random
durationdurationRETRY_FAILED_TASKRETRY_FAILED_TASKCREATE_NEW_EXECUTION>= 1durationfalseretryMessagesarray
["due to concurrent update","Retrying the job may solve the problem","Retrying may solve the problem"]The messages which would trigger an automatic retry.
Message is tested as a substring of the full message, and is case insensitive.
retryReasonsarray
["rateLimitExceeded","jobBackendError","backendError","internalError","jobInternalError"]The reasons which would trigger an automatic retry.
scopesarray
["https://www.googleapis.com/auth/cloud-platform"]The GCP scopes to be used.
serviceAccountstring
The GCP service account.
Outputs
creationTimestring
date-timeThe time when this table was created.
datasetIdstring
The dataset's ID.
definition
The table definition.
io.kestra.plugin.gcp.bigquery.models.TableDefinition-Output
io.kestra.plugin.gcp.bigquery.models.ExternalTableDefinition-Output
CSVJSONBIGTABLEDATASTORE_BACKUPAVROGOOGLE_SHEETSPARQUETORCio.kestra.plugin.gcp.bigquery.models.MaterializedViewDefinition-Output
date-timedurationio.kestra.plugin.gcp.bigquery.models.Schema-Output
io.kestra.plugin.gcp.bigquery.models.Field-Output
NULLABLEREQUIREDREPEATEDBOOLINT64FLOAT64NUMERICBIGNUMERICSTRINGBYTESSTRUCTARRAYTIMESTAMPDATETIMEDATETIMEGEOGRAPHYJSONINTERVALRANGEio.kestra.plugin.gcp.bigquery.models.StandardTableDefinition-Output
io.kestra.plugin.gcp.bigquery.models.RangePartitioning-Output
com.google.cloud.bigquery.StandardTableDefinition-StreamingBuffer
io.kestra.plugin.gcp.bigquery.models.TimePartitioning-Output
durationDAYHOURMONTHYEARTABLEVIEWMATERIALIZED_VIEWEXTERNALMODELio.kestra.plugin.gcp.bigquery.models.ViewDefinition-Output
io.kestra.plugin.gcp.bigquery.models.UserDefinedFunction-Output
INLINEFROM_URIdescriptionstring
The user-friendly description for the table.
encryptionConfiguration
The encryption configuration.
io.kestra.plugin.gcp.bigquery.models.EncryptionConfiguration-Output
etagstring
The hash of the table resource.
expirationTimestring
date-timeReturns the time when this table expires.
If not present, the table will persist indefinitely. Expired tables will be deleted and their storage reclaimed.
friendlyNamestring
The user-friendly name for the table.
generatedIdstring
The service-generated id for the table.
labelsobject
Return a map for labels applied to the table.
lastModifiedTimestring
date-timeThe time when this table was last modified.
numBytesinteger
The size of this table in bytes.
numLongTermBytesinteger
The number of bytes considered "long-term storage" for reduced billing purposes.
numRowsinteger
The number of rows of data in this table.
projectIdstring
The project's ID.
requirePartitionFilterboolean
Return true if a partition filter (that can be used for partition elimination) is required for queries over this table.
selfLinkstring
The URL that can be used to access the resource again. The returned URL can be used for get or update requests.
tablestring
The table name.