Class DatasetReference (3.38.0)

DatasetReference(project: str, dataset_id: str)

Parameters

Name Description
project str

The ID of the project

dataset_id str

The ID of the dataset

Properties

dataset_id

str: Dataset ID.

path

str: URL path for the dataset based on project and dataset ID.

project

str: Project ID of the dataset.

Methods

from_api_repr

from_api_repr(resource: dict) -> google.cloud.bigquery.dataset.DatasetReference

Factory: construct a dataset reference given its API representation

Parameter
Name Description
resource Dict[str, str]

Dataset reference resource representation returned from the API

Returns
Type Description
google.cloud.bigquery.dataset.DatasetReference Dataset reference parsed from resource.

from_string

from_string(
 dataset_id: str, default_project: typing.Optional[str] = None
) -> google.cloud.bigquery.dataset.DatasetReference

Construct a dataset reference from dataset ID string.

Parameters
Name Description
dataset_id str

A dataset ID in standard SQL format. If default_project is not specified, this must include both the project ID and the dataset ID, separated by ..

default_project Optional[str]

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

Exceptions
Type Description
ValueError If dataset_id is not a fully-qualified dataset ID in standard SQL format.
Returns
Type Description
DatasetReference .. rubric:: Examples >>> DatasetReference.from_string('my-project-id.some_dataset') DatasetReference('my-project-id', 'some_dataset') Dataset reference parsed from dataset_id.

model

model(model_id)

Constructs a ModelReference.

Parameter
Name Description
model_id str

the ID of the model.

Returns
Type Description
google.cloud.bigquery.model.ModelReference A ModelReference for a model in this dataset.

routine

routine(routine_id)

Constructs a RoutineReference.

Parameter
Name Description
routine_id str

the ID of the routine.

Returns
Type Description
google.cloud.bigquery.routine.RoutineReference A RoutineReference for a routine in this dataset.

table

table(table_id: str) -> google.cloud.bigquery.table.TableReference

Constructs a TableReference.

Parameter
Name Description
table_id str

The ID of the table.

Returns
Type Description
google.cloud.bigquery.table.TableReference A table reference for a table in this dataset.

to_api_repr

to_api_repr() -> dict

Construct the API resource representation of this dataset reference

Returns
Type Description
Dict[str, str] dataset reference represented as an API resource

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.