Visualização TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION

A visualização INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION apresenta os totais diários de uso de armazenamento nos últimos 90 dias para os seguintes tipos de tabelas:

Tabelas padrão
Visualizações materializadas
Clonagens de tabelas com um delta em bytes da tabela base
Snapshots da tabela que têm um delta em bytes da tabela base

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

Tabelas externas
Tabelas anônimas
Tabelas vazias
Clonagens de tabela que não têm delta em bytes da tabela base
Snapshots da tabela que não têm delta em bytes da tabela base

Os resultados das consultas na visualização INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION contêm uma linha por dia para cada tabela ou visualização materializada de toda a organização associada ao projeto atual.

Os dados desta tabela não estão disponíveis em tempo real. Leva aproximadamente 72 horas para que os dados da tabela apareçam nessa visualização.

O uso do armazenamento é retornado em MB de segundo. Por exemplo, se um projeto usar 1.000.000 bytes físicos por 86.400 segundos (24 horas), o uso físico total será de 86.400.000.000 bytes em segundos, que são convertidos em 82.397 MB em segundos, conforme mostrado no exemplo a seguir:

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

Esse é o valor que seria retornado pela coluna BILLABLE_TOTAL_PHYSICAL_USAGE.

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

Permissões necessárias

Para consultar a visualização INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION, você precisa das permissões do Identity and Access Management (IAM) para sua organização:

bigquery.tables.get
bigquery.tables.list

Cada um dos seguintes papéis predefinidos do IAM inclui as permissões anteriores:

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

Essa visualização de esquema está disponível apenas para usuários com organizações definidas do Google Cloud.

Para mais informações sobre as permissões do BigQuery, consulte Controle de acesso com o IAM.

Esquema

A visualização INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION tem o seguinte esquema:

`USAGE_DATE`	`DATE`	A data de faturamento para os bytes mostrados
`PROJECT_ID`	`STRING`	O ID do projeto que contém o conjunto de dados
`TABLE_CATALOG`	`STRING`	O ID do projeto que contém o conjunto de dados
`PROJECT_NUMBER`	`INT64`	O número do projeto que contém o conjunto de dados
`TABLE_SCHEMA`	`STRING`	O nome do conjunto de dados que contém a tabela ou a visualização materializada, também conhecido como `datasetId`
`TABLE_NAME`	`STRING`	O nome da tabela ou visualização materializada, também conhecido como `tableId`
`BILLABLE_TOTAL_LOGICAL_USAGE`	`INT64`	O uso lógico total, em MB de segundo. Retorna 0 se o conjunto de dados usar o modelo de faturamento do armazenamento físico.
`BILLABLE_ACTIVE_LOGICAL_USAGE`	`INT64`	O uso lógico de menos de 90 dias, em MB por segundo. Retorna 0 se o conjunto de dados usar o modelo de faturamento do armazenamento físico.
`BILLABLE_LONG_TERM_LOGICAL_USAGE`	`INT64`	O uso lógico de mais de 90 dias, em MB por segundo. Retorna 0 se o conjunto de dados usar o modelo de faturamento do armazenamento físico.
`BILLABLE_TOTAL_PHYSICAL_USAGE`	`INT64`	O uso total em MB por segundo. Isso inclui bytes físicos usados para armazenamento seguro e de viagem no tempo. Retorna 0 se o conjunto de dados usar o modelo de faturamento de armazenamento lógico.
`BILLABLE_ACTIVE_PHYSICAL_USAGE`	`INT64`	O uso físico em menos de 90 dias, em MB por segundo. Isso inclui bytes físicos usados para armazenamento seguro e de viagem no tempo. Retorna 0 se o conjunto de dados usar o modelo de faturamento de armazenamento lógico.
`BILLABLE_LONG_TERM_PHYSICAL_USAGE`	`INT64`	O uso físico com mais de 90 dias, em MB de segundo. Retorna 0 se o conjunto de dados usar o modelo de faturamento de armazenamento lógico.

Escopo e sintaxe

As consultas nessa visualização precisam incluir um qualificador de região. Se você não especificar um qualificador regional, os metadados serão recuperados de todas as regiões. A tabela a seguir explica o escopo da região dessa visualização:

Nome da visualização	Escopo do recurso	Escopo da região
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION	Organização que contém o projeto especificado	`REGION`

Substitua:

Opcional: PROJECT_ID: o ID do seu projeto do Google Cloud. Se não for especificado, o projeto padrão será usado.

+ REGION: qualquer nome da região do conjunto de dados. Por exemplo, region-us.

Observação: é necessário usar um qualificador de região para consultar visualizações INFORMATION_SCHEMA. O local de execução da consulta precisa corresponder à região da visualização INFORMATION_SCHEMA.

O exemplo a seguir mostra como retornar informações de armazenamento para tabelas em um projeto especificado em uma organização:

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

O exemplo a seguir mostra como retornar informações de armazenamento por projeto para tabelas em uma organização:

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

Exemplo

O exemplo a seguir mostra o uso de todas as tabelas da organização na data de uso 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 será 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                   |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+