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 MiB 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 MiB 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 doCloud de Confiance by S3NS.

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 dos bytes mostrados, usando o fuso horário America/Los_Angeles
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 MiB por 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 MiB 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 MiB 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 MiB 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 MiB 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 MiB por 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 Cloud de Confiance . 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`.

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