Vista de TABLE_SNAPSHOTS

La vista INFORMATION_SCHEMA.TABLE_SNAPSHOTS contiene metadatos sobre las instantáneas de la tabla. Para obtener más información, consulta Introducción a las instantáneas de tablas.

Permisos necesarios

Para consultar la vista INFORMATION_SCHEMA.TABLE_SNAPSHOTS, necesitas el permiso bigquery.tables.list de administración de identidades y accesos (IAM) para el conjunto de datos. La función predefinida roles/bigquery.metadataViewer incluye el permiso requerido.

Para obtener más información sobre IAM de BigQuery, consulta Control de acceso con IAM.

Esquema

Cuando consultas la tabla INFORMATION_SCHEMA.TABLE_SNAPSHOTS, los resultados contienen una fila por cada instantánea de la tabla en la región o el conjunto de datos especificados.

La tabla INFORMATION_SCHEMA.TABLE_SNAPSHOTS tiene el siguiente esquema: La tabla estándar de la que se tomó la instantánea de tabla se denomina tabla base.

Nombre de la columna Tipo de datos Valor
table_catalog STRING El nombre del proyecto que contiene la instantánea de la tabla
table_schema STRING El nombre del conjunto de datos que contiene la instantánea de la tabla
table_name STRING El nombre de la instantánea de la tabla
base_table_catalog STRING El nombre del proyecto que contiene la tabla base
base_table_schema STRING El nombre del conjunto de datos que contiene la tabla base
base_table_name STRING El nombre de la tabla base
snapshot_time TIMESTAMP La hora en la que se creó la instantánea de la tabla

Permiso y sintaxis

Las consultas realizadas a esta vista deben incluir un conjunto de datos o un calificador de región. Para consultas con un calificador de conjunto de datos, debes tener permisos para el conjunto de datos. Para consultas con un calificador de región, debes tener permisos para el proyecto. Para obtener más información, consulta Sintaxis. En la siguiente tabla, se explican los permisos de la región y los recursos para esta vista:

Nombre de la vista Permiso del recurso Permiso de la región
[`PROJECT_ID`.]`region-REGION`.INFORMATION_SCHEMA.TABLE_SNAPSHOTS Nivel de proyecto REGION
[`PROJECT_ID`.]DATASET_ID.INFORMATION_SCHEMA.TABLE_SNAPSHOTS Nivel de conjunto de datos Ubicación del conjunto de datos
Reemplaza lo siguiente:

  • Opcional: PROJECT_ID: el ID del proyecto de Google Cloud. Si no se especifica, se usa el proyecto predeterminado.
+ REGION: Cualquier nombre de región del conjunto de datos. Un ejemplo es region-us. DATASET_ID: El ID del conjunto de datos. Para obtener más información, consulta Calificador de conjunto de datos.

Ejemplo

-- Returns metadata for the table snapshots in the specified dataset.
SELECT * FROM myDataset.INFORMATION_SCHEMA.TABLE_SNAPSHOTS;

-- Returns metadata for the table snapshots in the specified region.
SELECT * FROM `region-us`.INFORMATION_SCHEMA.TABLE_SNAPSHOTS;

Ejemplo

La siguiente consulta recupera metadatos para las instantáneas de la tabla en el conjunto de datos mydataset. En este ejemplo, se muestra la instantánea myproject.mydataset.mytablesnapshot, que se tomó de la tabla base myproject.mydataset.mytable el 14 de mayo de 2021, a las 12 p.m. UTC.

SELECT *
FROM
  `myproject`.mydataset.INFORMATION_SCHEMA.TABLE_SNAPSHOTS;

El resultado es similar al siguiente:

+----------------+---------------+-----------------+--------------------+-------------------+-----------------+-----------------------------+
| table_catalog  | table_schema  | table_name      | base_table_catalog | base_table_schema | base_table_name | snapshot_time               |
+----------------+---------------+-----------------+----------------------------------------------------------------------------------------+
| myproject      | mydataset     | mytablesnapshot | myProject          | mydataset         | mytable         | 2021-05-14 12:00:00.000 UTC |
+----------------+---------------+-----------------+--------------------+-------------------+-----------------+-----------------------------+