Es posible que parte de la información de esta página (o toda) no se aplique a Cloud de Confiance de S3NS. Consulta Diferencias con Google Cloud para obtener más información.

Vista TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER

La vista INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER proporciona los totales de uso de almacenamiento diarios 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 de almacenamiento en MiB segundos. Por ejemplo, si un proyecto usa 1,000,000 bytes físicos durante 86,400 segundos (24 horas), el uso físico total 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 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:

Nombre de la columna	Tipo de datos	Valor
`usage_date`	`DATE`	La fecha de facturación de los bytes que se muestran, con la `America/Los_Angeles` zona horaria
`folder_numbers`	`REPEATED INTEGER`	El número de IDs de las carpetas que contienen el proyecto, el cual comienza con la carpeta que contiene el proyecto de inmediato seguido de la carpeta que contiene la carpeta secundaria, y así sucesivamente. Por ejemplo, si `FOLDER_NUMBERS` es `[1, 2, 3]`, la carpeta `1` contiene el proyecto de inmediato, 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 billing model.
`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 billing model.
`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 billing model.
`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 billing model.
`billable_active_physical_usage`	`INT64`	El uso físico que tiene menos de 90 días, 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 billing model.
`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 billing model.

Para lograr estabilidad, te recomendamos que enumeres las columnas de forma explícita en tus consultas de esquema de información en lugar de usar un comodín (SELECT *). Si enumeras las columnas de forma explícita, se evita que las consultas se interrumpan si cambia el esquema subyacente.

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 Cloud de Confiance proyecto. 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 de 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                |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+