Class TableReference (2.25.2)

TableReference(dataset_ref, table_id)

Parameters

NameDescription
dataset_ref google.cloud.bigquery.dataset.DatasetReference

A pointer to the dataset

table_id str

The ID of the table

Inheritance

builtins.object > TableReference

Properties

dataset_id

str: ID of dataset containing the table.

path

str: URL path for the table's APIs.

project

str: Project bound to the table

table_id

str: The table ID.

Methods

from_api_repr

from_api_repr(resource: dict)

Factory: construct a table reference given its API representation

Parameter
NameDescription
resource Dict[str, object]

Table reference representation returned from the API

Returns
TypeDescription
google.cloud.bigquery.table.TableReferenceTable reference parsed from ``resource``.

from_string

from_string(table_id: str, default_project: Optional[str] = None)

Construct a table reference from table ID string.

Parameters
NameDescription
table_id str

A table ID in standard SQL format. If default_project is not specified, this must included a project ID, dataset ID, and table ID, each separated by ..

default_project Optional[str]

The project ID to use when table_id does not include a project ID.

Exceptions
TypeDescription
ValueErrorIf ``table_id`` is not a fully-qualified table ID in standard SQL format.
Returns
TypeDescription
TableReference .. rubric:: Examples >>> TableReference.from_string('my-project.mydataset.mytable') TableRef...(DatasetRef...('my-project', 'mydataset'), 'mytable')Table reference parsed from ``table_id``.

to_api_repr

to_api_repr()

Construct the API resource representation of this table reference.

Returns
TypeDescription
Dict[str, object]Table reference represented as an API resource

to_bqstorage

to_bqstorage()

Construct a BigQuery Storage API representation of this table.

Install the google-cloud-bigquery-storage package to use this feature.

If the table_id contains a partition identifier (e.g. my_table$201812) or a snapshot identifier (e.g. mytable@1234567890), it is ignored. Use xref_TableReadOptions to filter rows by partition. Use xref_TableModifiers to select a specific snapshot to read from.

Returns
TypeDescription
strA reference to this table in the BigQuery Storage API.

__init__

__init__(dataset_ref, table_id)

Initialize self. See help(type(self)) for accurate signature.

TableReference

TableReference(dataset_ref, table_id)
Parameters
NameDescription
dataset_ref google.cloud.bigquery.dataset.DatasetReference

A pointer to the dataset

table_id str

The ID of the table