Vista TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION

A vista INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION fornece totais diários da utilização do armazenamento nos últimos 90 dias para os seguintes tipos de tabelas:

• Tabelas padrão
• Vistas materializadas
• Clones de tabelas que têm uma diferença em bytes da tabela de base
• Instantâneos de tabelas que têm uma diferença em bytes da tabela de base

As tabelas que não têm bytes faturáveis não são incluídas na vista INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION. Isto inclui os seguintes tipos de tabelas:

• Tabelas externas
• Tabelas anónimas
• Tabelas vazias
• Clones de tabelas que não têm delta em bytes da tabela de base
• Instantâneos de tabelas que não têm delta em bytes da tabela de base

Quando consulta a vista INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION view, os resultados da consulta contêm uma linha por dia para cada tabela ou vista materializada para toda a organização associada ao projeto atual.

Os dados desta tabela não estão disponíveis em tempo real. Os dados da tabela demoram aproximadamente 72 horas a ser refletidos nesta vista.

A utilização de armazenamento é devolvida em MiB por segundo. Por exemplo, se um projeto usar 1.000.000 de bytes físicos durante 86.400 segundos (24 horas), a utilização física total é de 86.400.000.000 de bytes por segundo, que é convertida em 82.397 MiB por segundo, conforme mostrado no exemplo seguinte:

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

Este é o valor que seria devolvido pela coluna BILLABLE_TOTAL_PHYSICAL_USAGE.

Para mais informações, consulte os detalhes dos preços de armazenamento.

Autorizações necessárias

Para consultar a vista INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION, precisa das seguintes autorizações de gestão de identidade e de acesso (IAM) para a sua organização:

• bigquery.tables.get
• bigquery.tables.list

Cada uma das seguintes funções de IAM predefinidas inclui as autorizações anteriores:

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

Esta vista de esquema só está disponível para utilizadores com Trusted Cloud by S3NS organizações definidas.

Para mais informações sobre as autorizações do BigQuery, consulte o artigo Controlo de acesso com a IAM.

Esquema

A vista INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION tem o seguinte esquema:

Âmbito e sintaxe

As consultas nesta vista têm de incluir um qualificador de região. Se não especificar um qualificador regional, os metadados são obtidos de todas as regiões. A tabela seguinte explica o âmbito da região para esta vista:

• Opcional: PROJECT_ID: o ID do seu projeto do Trusted Cloud Google Cloud. Se não for especificado, é usado o projeto predefinido.
• REGION: qualquer nome da região do conjunto de dados. Por exemplo, `region-us`.

O exemplo seguinte mostra como devolver informações de armazenamento para tabelas num projeto especificado numa organização:

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

O exemplo seguinte mostra como devolver informações de armazenamento por projeto para tabelas numa organização:

SELECT * FROM `region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION;

Exemplo

O exemplo seguinte mostra a utilização de todas as tabelas na organização para a data de utilização mais recente.

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_ORGANIZATION
  )
WHERE rank = 1;

O resultado é semelhante ao seguinte:

+--------------+------------+--------------+------------+------------------------------+-------------------------------+
| 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                   |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+