View table snapshot metadata
This document describes how to view the metadata for a BigQuery tablesnapshot in the Google Cloud console, by querying theTABLE_SNAPSHOTSview of theINFORMATION_SCHEMA table, by using thebq showcommand, or by calling thetables.get API.It is intended for users who are familiar withBigQuerytables andtable snapshots.
Permissions and roles
This section describes theIdentity and Access Management (IAM) permissionthat you need to view the metadata for a table snapshot, and thepredefined IAM rolesthat grant those permissions.
Permissions
To view a table snapshot's metadata, you need the following permission:
| Permission | Resource |
|---|---|
bigquery.tables.get | The table snapshot |
Roles
The predefined BigQuery roles that provide the requiredpermission are as follows:
| Role | Resource |
|---|---|
Any of the following:bigquery.metadataViewerbigquery.dataViewerbigquery.dataEditorbigquery.dataOwnerbigquery.admin | The table snapshot |
Get a table snapshot's metadata
The metadata for a table snapshot is similar to the metadata for a standardtable, with the following differences:
- An additional
baseTableReferencefield identifies the base table thatthe snapshot was taken from. - The
typefield has the valueSNAPSHOT.
You can view the metadata for a table snapshot by using one of thefollowing options:
Console
In the Google Cloud console, go to theBigQuery page.
In the left pane, clickExplorer:

If you don't see the left pane, clickExpand left pane to open the pane.
In theExplorer pane, expand your project, clickDatasets, andthen click the dataset that has the table snapshot.
ClickOverview> Tables, and then click the name of thetable snapshot.
In the snapshot pane that appears, you can do the following:
Click theSchema tab to view the table snapshot's schema andpolicy tags.
Click theDetails table to view the table snapshot's size,expiration, base table, snapshot time, and other information.
SQL
To see metadata for a table snapshot, query theINFORMATION_SCHEMA.TABLE_SNAPSHOTS view:
In the Google Cloud console, go to theBigQuery page.
In the query editor, enter the following statement:
SELECT*FROMPROJECT_ID.DATASET_NAME.INFORMATION_SCHEMA.TABLE_SNAPSHOTSWHEREtable_name='SNAPSHOT_NAME';
Replace the following:
PROJECT_ID: the project ID of the project that contains the snapshot.DATASET_NAME: the name of the dataset that contains the snapshot.SNAPSHOT_NAME: the name of the snapshot.
ClickRun.
For more information about how to run queries, seeRun an interactive query.
bq
Enter the following command in the Cloud Shell:
bqshow\--format=prettyjson\PROJECT_ID:DATASET_NAME.SNAPSHOT_NAME
Replace the following:
PROJECT_ID: the project ID of the project that contains the snapshot.DATASET_NAME: the name of the dataset that contains the snapshot.SNAPSHOT_NAME: the name of the snapshot.
The output is similar to the following:
{"creationTime":"1593194331936",..."snapshotDefinition":{"baseTableReference":{"datasetId":"myDataset","projectId":"myProject","tableId":"mytable"},"snapshotTime":"2020-06-26T17:58:50.815Z"},"tableReference":{"datasetId":"otherDataset","projectId":"myProject","tableId":"mySnapshot"},"type":"SNAPSHOT"}
API
Call thetables.getmethod with the following parameters:
| Parameter | Value |
|---|---|
projectId | The project ID of the project that contains the snapshot. |
datasetId | The name of the dataset that contains the snapshot. |
tableId | The name of the snapshot. |
The response body is similar to the following:
{ "kind": "bigquery#table", "etag": "...", "id": "myProject:myDataset.mySnapshot", "selfLink": "https://content-bigquery.googleapis.com/bigquery/v2/projects/myProject/datasets/myDataset/tables/mySnapshot", "tableReference": { "projectId": "myProject", "datasetId": "myDataset", "tableId": "mySnapshot" }, "description": "...", "schema": { "fields": [ ... ] }, "numBytes": "637931", "numLongTermBytes": "0", "numRows": "33266", "creationTime": "1593194331936", "lastModifiedTime": "1593194331936", "type": "SNAPSHOT", "location": "US", "snapshotDefinition": { "baseTableReference": { "projectId": "myProject", "datasetId": "otherDataset", "tableId": "myTable" }, "snapshotTime": "2020-06-26T17:58:50.815Z" }}What's next
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-02-19 UTC.