Se usó la API de Cloud Translation para traducir esta página.

Vista de TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER

En la vista INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER, se proporcionan los totales diarios de uso de almacenamiento de los últimos 90 días para los siguientes tipos de tablas.

Tablas estándar
Vistas materializadas
Clonaciones de tablas que tienen un delta en bytes de la tabla base
Instantáneas de tablas que tienen un delta en bytes de la tabla base

La vista INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER excluye las tablas sin bytes facturables. Se excluyen los siguientes tipos de tablas:

Tablas externas
Tablas anónimas
Tablas vacías
Clonaciones de tablas que no tienen delta en bytes de la tabla base
Instantáneas de tablas que no tienen delta en bytes de la tabla base

Cuando consultas la vista INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER, los resultados contienen una fila por día por cada tabla o vista materializada en la carpeta superior del proyecto actual, incluidas sus subcarpetas.

Los datos de esta tabla no están disponibles en tiempo real. Los datos de la tabla tardan aproximadamente 72 horas en aparecer en esta vista.

La vista muestra el uso del almacenamiento en MiB de segundo. Por ejemplo, si un proyecto usa 1,000,000 bytes físicos durante 86,400 segundos (24 horas), el uso físico es de 86,400,000,000 bytes segundos, que se convierten en 82,397 MiB segundos, como se muestra en el siguiente ejemplo:

86,400,000,000 / 1,024 / 1,024 = 82,397

El valor de uso de almacenamiento se puede encontrar en la columna BILLABLE_TOTAL_PHYSICAL_USAGE. Para obtener más información, consulta los detalles de los precios de almacenamiento.

Permisos necesarios

Para consultar la vista INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER, necesitas los siguientes permisos de Identity and Access Management (IAM) para la carpeta superior del proyecto:

bigquery.tables.get
bigquery.tables.list

Cada uno de los siguientes roles predefinidos de IAM incluye los permisos anteriores:

roles/bigquery.dataViewer
roles/bigquery.dataEditor
roles/bigquery.metadataViewer
roles/bigquery.admin

Para obtener más información sobre los permisos de BigQuery, consulta Roles y permisos de IAM de BigQuery.

Esquema

La vista INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER tiene el siguiente esquema:

`USAGE_DATE`	`DATE`	La fecha de facturación de los bytes que se muestran, con la zona horaria de `America/Los_Angeles`
`FOLDER_NUMBERS`	`REPEATED INTEGER`	El número de IDs de las carpetas que contienen el proyecto, comenzando con la carpeta que contiene el proyecto de inmediato, seguida de la carpeta que contiene la carpeta secundaria, y así sucesivamente. Por ejemplo, si `FOLDER_NUMBERS` es `[1, 2, 3]`, la carpeta `1` contiene inmediatamente el proyecto, la carpeta `2` contiene `1` y la carpeta `3` contiene `2`. Esta columna solo se propaga en `TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER`.
`PROJECT_ID`	`STRING`	El ID del proyecto que contiene el conjunto de datos
`TABLE_CATALOG`	`STRING`	El ID del proyecto que contiene el conjunto de datos
`PROJECT_NUMBER`	`INT64`	El número del proyecto que contiene el conjunto de datos
`TABLE_SCHEMA`	`STRING`	El nombre del conjunto de datos que contiene la tabla o la vista materializada (también denominado `datasetId`)
`TABLE_NAME`	`STRING`	El nombre de la tabla o la vista materializada (también denominado `tableId`)
`BILLABLE_TOTAL_LOGICAL_USAGE`	`INT64`	El uso lógico total, en MiB segundos. Muestra 0 si el conjunto de datos usa el modelo de facturación de almacenamiento físico.
`BILLABLE_ACTIVE_LOGICAL_USAGE`	`INT64`	El uso lógico que tiene menos de 90 días, en MiB segundos. Muestra 0 si el conjunto de datos usa el modelo de facturación de almacenamiento físico.
`BILLABLE_LONG_TERM_LOGICAL_USAGE`	`INT64`	El uso lógico que tiene más de 90 días, en MiB segundos. Muestra 0 si el conjunto de datos usa el modelo de facturación de almacenamiento físico.
`BILLABLE_TOTAL_PHYSICAL_USAGE`	`INT64`	El uso total en MiB segundos. Esto incluye bytes físicos que se usan para el almacenamiento a prueba de fallas y viajes en el tiempo. Muestra 0 si el conjunto de datos usa el modelo de facturación de almacenamiento lógico.
`BILLABLE_ACTIVE_PHYSICAL_USAGE`	`INT64`	El uso físico que tiene menos de 90 días, en MiB segundos. Esto incluye los bytes físicos que se usan para el almacenamiento a prueba de fallas y viajes en el tiempo. Muestra 0 si el conjunto de datos usa el modelo de facturación de almacenamiento lógico.
`BILLABLE_LONG_TERM_PHYSICAL_USAGE`	`INT64`	El uso físico que tiene más de 90 días, en MiB segundos. Muestra 0 si el conjunto de datos usa el modelo de facturación de almacenamiento lógico.

Permiso y sintaxis

Las consultas realizadas a esta vista deben incluir un calificador de región. Si no especificas un calificador regional, los metadatos se recuperan de todas las regiones. En la siguiente tabla, se explica el permiso de la región para esta vista:

Nombre de la vista	Permiso del recurso	Permiso de la región
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER	Carpeta que contiene el proyecto especificado	`REGION`

Reemplaza lo siguiente:

Opcional: PROJECT_ID es el ID de tu proyecto de Google Cloud . Si no se especifica, se usa el proyecto predeterminado.
REGION: Cualquier nombre de región del conjunto de datos. Por ejemplo, `region-us`.

Nota: Debes usar un calificador de región para consultar las vistas INFORMATION_SCHEMA. La ubicación de la ejecución de la consulta debe coincidir con la región de la vista INFORMATION_SCHEMA.

Para recuperar la información de almacenamiento de las tablas en la carpeta superior del proyecto especificado, ejecuta la siguiente consulta:

SELECT * FROM `myProject`.`region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER;

Ejemplo

En la siguiente consulta, se muestra el uso de todas las tablas de la carpeta en la fecha más reciente:

SELECT
  usage_date,
  project_id,
  table_schema,
  table_name,
  billable_total_logical_usage,
  billable_total_physical_usage
FROM
  (
    SELECT
      *,
      ROW_NUMBER()
        OVER (PARTITION BY project_id, table_schema, table_name ORDER BY usage_date DESC) AS rank
    FROM
      `region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER
  )
WHERE rank = 1;

El resultado es similar al siguiente:

+--------------+------------+--------------+------------+------------------------------+-------------------------------+
| usage_date   | project_id | table_schema | table_name | billable_total_logical_usage | billable_total_physical_usage |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project1   | dataset_A    | table_x    |     734893409201             |              0                |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project1   | dataset_A    | table_z    |     110070445455             |              0                |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project1   | dataset_B    | table_y    |            0                 |         52500873256           |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project1   | dataset_B    | table_t    |            0                 |         32513713981           |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project2   | dataset_C    | table_m    |      8894535352              |              0                |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project2   | dataset_C    | table_n    |      4183337201              |              0                |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+