Class DatasetReference (3.16.0)

DatasetReference(project, dataset_id)

Parameters

NameDescription
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
NameDescription
resource Dict[str, str]

Dataset reference resource representation returned from the API

Returns
TypeDescription
google.cloud.bigquery.dataset.DatasetReferenceDataset 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
NameDescription
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
TypeDescription
ValueErrorIf dataset_id is not a fully-qualified dataset ID in standard SQL format.
Returns
TypeDescription
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
NameDescription
model_id str

the ID of the model.

Returns
TypeDescription
google.cloud.bigquery.model.ModelReferenceA ModelReference for a model in this dataset.

routine

routine(routine_id)

Constructs a RoutineReference.

Parameter
NameDescription
routine_id str

the ID of the routine.

Returns
TypeDescription
google.cloud.bigquery.routine.RoutineReferenceA RoutineReference for a routine in this dataset.

table

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

Constructs a TableReference.

Parameter
NameDescription
table_id str

The ID of the table.

Returns
TypeDescription
google.cloud.bigquery.table.TableReferenceA 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
TypeDescription
Dict[str, str]dataset reference represented as an API resource

__init__

__init__(project, dataset_id)

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

DatasetReference

DatasetReference(project, dataset_id)
Parameters
NameDescription
project str

The ID of the project

dataset_id str

The ID of the dataset

Exceptions
TypeDescription
ValueErrorIf either argument is not of type str.