Class DatasetReference (3.36.0)
Stay organized with collections
Save and categorize content based on your preferences.
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
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
Constructs a ModelReference.
Parameter |
Name |
Description |
model_id |
str
the ID of the model.
|
routine
Constructs a RoutineReference.
Parameter |
Name |
Description |
routine_id |
str
the ID of the routine.
|
table
table(table_id: str) -> google.cloud.bigquery.table.TableReference
Constructs a TableReference.
Parameter |
Name |
Description |
table_id |
str
The ID of the table.
|
to_api_repr
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-08-20 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-20 UTC."],[],[],null,["# Class DatasetReference (3.36.0)\n\nVersion latestkeyboard_arrow_down\n\n- [3.36.0 (latest)](/python/docs/reference/bigquery/latest/google.cloud.bigquery.dataset.DatasetReference)\n- [3.35.1](/python/docs/reference/bigquery/3.35.1/google.cloud.bigquery.dataset.DatasetReference)\n- [3.34.0](/python/docs/reference/bigquery/3.34.0/google.cloud.bigquery.dataset.DatasetReference)\n- [3.33.0](/python/docs/reference/bigquery/3.33.0/google.cloud.bigquery.dataset.DatasetReference)\n- [3.31.0](/python/docs/reference/bigquery/3.31.0/google.cloud.bigquery.dataset.DatasetReference)\n- [3.30.0](/python/docs/reference/bigquery/3.30.0/google.cloud.bigquery.dataset.DatasetReference)\n- [3.29.0](/python/docs/reference/bigquery/3.29.0/google.cloud.bigquery.dataset.DatasetReference)\n- [3.27.0](/python/docs/reference/bigquery/3.27.0/google.cloud.bigquery.dataset.DatasetReference)\n- [3.26.0](/python/docs/reference/bigquery/3.26.0/google.cloud.bigquery.dataset.DatasetReference)\n- [3.25.0](/python/docs/reference/bigquery/3.25.0/google.cloud.bigquery.dataset.DatasetReference)\n- [3.24.0](/python/docs/reference/bigquery/3.24.0/google.cloud.bigquery.dataset.DatasetReference)\n- [3.23.1](/python/docs/reference/bigquery/3.23.1/google.cloud.bigquery.dataset.DatasetReference)\n- [3.22.0](/python/docs/reference/bigquery/3.22.0/google.cloud.bigquery.dataset.DatasetReference)\n- [3.21.0](/python/docs/reference/bigquery/3.21.0/google.cloud.bigquery.dataset.DatasetReference)\n- [3.20.1](/python/docs/reference/bigquery/3.20.1/google.cloud.bigquery.dataset.DatasetReference)\n- [3.19.0](/python/docs/reference/bigquery/3.19.0/google.cloud.bigquery.dataset.DatasetReference)\n- [3.18.0](/python/docs/reference/bigquery/3.18.0/google.cloud.bigquery.dataset.DatasetReference)\n- [3.17.2](/python/docs/reference/bigquery/3.17.2/google.cloud.bigquery.dataset.DatasetReference)\n- [3.16.0](/python/docs/reference/bigquery/3.16.0/google.cloud.bigquery.dataset.DatasetReference)\n- [3.15.0](/python/docs/reference/bigquery/3.15.0/google.cloud.bigquery.dataset.DatasetReference)\n- [3.14.1](/python/docs/reference/bigquery/3.14.1/google.cloud.bigquery.dataset.DatasetReference)\n- [3.13.0](/python/docs/reference/bigquery/3.13.0/google.cloud.bigquery.dataset.DatasetReference)\n- [3.12.0](/python/docs/reference/bigquery/3.12.0/google.cloud.bigquery.dataset.DatasetReference)\n- [3.11.4](/python/docs/reference/bigquery/3.11.4/google.cloud.bigquery.dataset.DatasetReference)\n- [3.4.0](/python/docs/reference/bigquery/3.4.0/google.cloud.bigquery.dataset.DatasetReference)\n- [3.3.6](/python/docs/reference/bigquery/3.3.6/google.cloud.bigquery.dataset.DatasetReference)\n- [3.2.0](/python/docs/reference/bigquery/3.2.0/google.cloud.bigquery.dataset.DatasetReference)\n- [3.1.0](/python/docs/reference/bigquery/3.1.0/google.cloud.bigquery.dataset.DatasetReference)\n- [3.0.1](/python/docs/reference/bigquery/3.0.1/google.cloud.bigquery.dataset.DatasetReference)\n- [2.34.4](/python/docs/reference/bigquery/2.34.4/google.cloud.bigquery.dataset.DatasetReference)\n- [2.33.0](/python/docs/reference/bigquery/2.33.0/google.cloud.bigquery.dataset.DatasetReference)\n- [2.32.0](/python/docs/reference/bigquery/2.32.0/google.cloud.bigquery.dataset.DatasetReference)\n- [2.31.0](/python/docs/reference/bigquery/2.31.0/google.cloud.bigquery.dataset.DatasetReference)\n- [2.30.1](/python/docs/reference/bigquery/2.30.1/google.cloud.bigquery.dataset.DatasetReference)\n- [2.29.0](/python/docs/reference/bigquery/2.29.0/google.cloud.bigquery.dataset.DatasetReference)\n- [2.28.1](/python/docs/reference/bigquery/2.28.1/google.cloud.bigquery.dataset.DatasetReference)\n- [2.27.1](/python/docs/reference/bigquery/2.27.1/google.cloud.bigquery.dataset.DatasetReference)\n- [2.26.0](/python/docs/reference/bigquery/2.26.0/google.cloud.bigquery.dataset.DatasetReference)\n- [2.25.2](/python/docs/reference/bigquery/2.25.2/google.cloud.bigquery.dataset.DatasetReference)\n- [2.24.1](/python/docs/reference/bigquery/2.24.1/google.cloud.bigquery.dataset.DatasetReference)\n- [2.23.3](/python/docs/reference/bigquery/2.23.3/google.cloud.bigquery.dataset.DatasetReference)\n- [2.22.1](/python/docs/reference/bigquery/2.22.1/google.cloud.bigquery.dataset.DatasetReference)\n- [2.21.0](/python/docs/reference/bigquery/2.21.0/google.cloud.bigquery.dataset.DatasetReference)\n- [2.20.0](/python/docs/reference/bigquery/2.20.0/google.cloud.bigquery.dataset.DatasetReference)\n- [2.19.0](/python/docs/reference/bigquery/2.19.0/google.cloud.bigquery.dataset.DatasetReference)\n- [2.18.0](/python/docs/reference/bigquery/2.18.0/google.cloud.bigquery.dataset.DatasetReference)\n- [2.17.0](/python/docs/reference/bigquery/2.17.0/google.cloud.bigquery.dataset.DatasetReference)\n- [2.16.1](/python/docs/reference/bigquery/2.16.1/google.cloud.bigquery.dataset.DatasetReference)\n- [2.15.0](/python/docs/reference/bigquery/2.15.0/google.cloud.bigquery.dataset.DatasetReference)\n- [2.14.0](/python/docs/reference/bigquery/2.14.0/google.cloud.bigquery.dataset.DatasetReference)\n- [2.13.1](/python/docs/reference/bigquery/2.13.1/google.cloud.bigquery.dataset.DatasetReference)\n- [2.12.0](/python/docs/reference/bigquery/2.12.0/google.cloud.bigquery.dataset.DatasetReference)\n- [2.11.0](/python/docs/reference/bigquery/2.11.0/google.cloud.bigquery.dataset.DatasetReference)\n- [2.10.0](/python/docs/reference/bigquery/2.10.0/google.cloud.bigquery.dataset.DatasetReference)\n- [2.9.0](/python/docs/reference/bigquery/2.9.0/google.cloud.bigquery.dataset.DatasetReference)\n- [2.8.0](/python/docs/reference/bigquery/2.8.0/google.cloud.bigquery.dataset.DatasetReference)\n- [2.7.0](/python/docs/reference/bigquery/2.7.0/google.cloud.bigquery.dataset.DatasetReference)\n- [2.6.2](/python/docs/reference/bigquery/2.6.2/google.cloud.bigquery.dataset.DatasetReference)\n- [2.5.0](/python/docs/reference/bigquery/2.5.0/google.cloud.bigquery.dataset.DatasetReference)\n- [2.4.0](/python/docs/reference/bigquery/2.4.0/google.cloud.bigquery.dataset.DatasetReference)\n- [2.3.1](/python/docs/reference/bigquery/2.3.1/google.cloud.bigquery.dataset.DatasetReference)\n- [2.2.0](/python/docs/reference/bigquery/2.2.0/google.cloud.bigquery.dataset.DatasetReference)\n- [2.1.0](/python/docs/reference/bigquery/2.1.0/google.cloud.bigquery.dataset.DatasetReference)\n- [2.0.0](/python/docs/reference/bigquery/2.0.0/google.cloud.bigquery.dataset.DatasetReference)\n- [1.28.2](/python/docs/reference/bigquery/1.28.2/google.cloud.bigquery.dataset.DatasetReference)\n- [1.27.2](/python/docs/reference/bigquery/1.27.2/google.cloud.bigquery.dataset.DatasetReference)\n- [1.26.1](/python/docs/reference/bigquery/1.26.1/google.cloud.bigquery.dataset.DatasetReference)\n- [1.25.0](/python/docs/reference/bigquery/1.25.0/google.cloud.bigquery.dataset.DatasetReference)\n- [1.24.0](/python/docs/reference/bigquery/1.24.0/google.cloud.bigquery.dataset.DatasetReference)\n- [1.23.1](/python/docs/reference/bigquery/1.23.1/google.cloud.bigquery.dataset.DatasetReference)\n- [1.22.0](/python/docs/reference/bigquery/1.22.0/google.cloud.bigquery.dataset.DatasetReference)\n- [1.21.0](/python/docs/reference/bigquery/1.21.0/google.cloud.bigquery.dataset.DatasetReference)\n- [1.20.0](/python/docs/reference/bigquery/1.20.0/google.cloud.bigquery.dataset.DatasetReference)\n- [1.19.0](/python/docs/reference/bigquery/1.19.0/google.cloud.bigquery.dataset.DatasetReference)\n- [1.18.0](/python/docs/reference/bigquery/1.18.0/google.cloud.bigquery.dataset.DatasetReference)\n- [1.17.0](/python/docs/reference/bigquery/1.17.0/google.cloud.bigquery.dataset.DatasetReference)\n- [1.16.0](/python/docs/reference/bigquery/1.16.0/google.cloud.bigquery.dataset.DatasetReference) \n\n DatasetReference(project: str, dataset_id: str)\n\nDatasetReferences are pointers to datasets.\n\nSee\n\u003chttps://cloud.google.com/bigquery/docs/reference/rest/v2/datasets#datasetreference\u003e\n\nProperties\n----------\n\n### dataset_id\n\nstr: Dataset ID.\n\n### path\n\nstr: URL path for the dataset based on project and dataset ID.\n\n### project\n\nstr: Project ID of the dataset.\n\nMethods\n-------\n\n### from_api_repr\n\n from_api_repr(resource: dict) -\u003e google.cloud.bigquery.dataset.DatasetReference\n\nFactory: construct a dataset reference given its API representation\n\n### from_string\n\n from_string(\n dataset_id: str, default_project: typing.Optional[str] = None\n ) -\u003e google.cloud.bigquery.dataset.DatasetReference\n\nConstruct a dataset reference from dataset ID string.\n\n### model\n\n model(model_id)\n\nConstructs a ModelReference.\n\n### routine\n\n routine(routine_id)\n\nConstructs a RoutineReference.\n\n### table\n\n table(table_id: str) -\u003e google.cloud.bigquery.table.TableReference\n\nConstructs a TableReference.\n\n### to_api_repr\n\n to_api_repr() -\u003e dict\n\nConstruct the API resource representation of this dataset reference"]]