Class TableReference (3.0.1) 

TableReference(dataset_ref: DatasetReference, table_id: str)

Inheritance

builtins.object > google.cloud.bigquery.table._TableBase > TableReference

Properties

dataset_id

ID of dataset containing the table.

path

URL path for the table's APIs.

project

Project bound to the table.

table_id

The table ID.

Methods

from_api_repr

from_api_repr(resource: dict)

Factory: construct a table reference given its API representation

Parameter
Name Description
resource Dict[str, object]

Table reference representation returned from the API

Returns
Type Description
google.cloud.bigquery.table.TableReference Table 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
Name Description
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
Type Description
ValueError If ``table_id`` is not a fully-qualified table ID in standard SQL format.
Returns
Type Description
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
Type Description
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_table201812ドル) 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
Type Description
str A reference to this table in the BigQuery Storage API.

__init__

__init__(dataset_ref: DatasetReference, table_id: str)

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

TableReference

TableReference(dataset_ref: DatasetReference, table_id: str)

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025年10月30日 UTC.