Vista TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER

A vista INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER apresenta totais de utilização de armazenamento diários dos ú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

A vista INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER exclui tabelas sem bytes faturáveis. Os seguintes tipos de tabelas estão excluídos:

  • 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_FOLDER, os resultados da consulta contêm uma linha por dia para cada tabela ou vista materializada na pasta principal do projeto atual, incluindo as respetivas subpastas.

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

A vista devolve a utilização de armazenamento em segundos MiB. 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, o que se converte em 82.397 MiB por segundo, conforme mostrado no exemplo seguinte:

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

Pode encontrar o valor de utilização do armazenamento na 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_FOLDER, precisa das seguintes autorizações da gestão de identidade e de acesso (IAM) para a pasta principal do projeto:

  • 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

Para mais informações acerca das autorizações do BigQuery, consulte o artigo Funções e autorizações do IAM do BigQuery.

Esquema

A vista INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER tem o seguinte esquema:

USAGE_DATE DATE A data de faturação dos bytes apresentados, usando o America/Los_Angeles fuso horário
FOLDER_NUMBERS REPEATED INTEGER Os IDs numéricos das pastas que contêm o projeto, começando pela pasta que contém imediatamente o projeto, seguida da pasta que contém a pasta secundária e assim sucessivamente. Por exemplo, se FOLDER_NUMBERS for [1, 2, 3], a pasta 1 contém imediatamente o projeto, a pasta 2 contém 1 e a pasta 3 contém 2. Esta coluna só é preenchida em TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER.
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 vista materializada, também conhecido como datasetId
TABLE_NAME STRING O nome da tabela ou da vista materializada, também conhecido como tableId
BILLABLE_TOTAL_LOGICAL_USAGE INT64

A utilização lógica total, em segundos de MiB.

Devolve 0 se o conjunto de dados usar o modelo de faturação de armazenamento físico.
BILLABLE_ACTIVE_LOGICAL_USAGE INT64

A utilização lógica com menos de 90 dias, em MiB/segundo.

Devolve 0 se o conjunto de dados usar o modelo de faturação de armazenamento físico.
BILLABLE_LONG_TERM_LOGICAL_USAGE INT64

A utilização lógica com mais de 90 dias, em MiB/segundo.

Devolve 0 se o conjunto de dados usar o modelo de faturação de armazenamento físico.
BILLABLE_TOTAL_PHYSICAL_USAGE INT64

A utilização total em MiB segundo. Isto inclui: bytes físicos usados para segurança e armazenamento de viagem no tempo.

Devolve 0 se o conjunto de dados usar o modelo de faturação de armazenamento lógico.
BILLABLE_ACTIVE_PHYSICAL_USAGE INT64

A utilização física com menos de 90 dias, em segundos MiB. Isto inclui os bytes físicos usados para armazenamento à prova de falhas e de viagem no tempo.

Devolve 0 se o conjunto de dados usar o modelo de faturação de armazenamento lógico.
BILLABLE_LONG_TERM_PHYSICAL_USAGE INT64

A utilização física com mais de 90 dias, em segundos MiB.

Devolve 0 se o conjunto de dados usar o modelo de faturação de armazenamento lógico.

Â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:

Nome da visualização de propriedade Âmbito do recurso Âmbito da região
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER Pasta que contém o projeto especificado REGION
Substitua o seguinte:
  • 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`.

Para obter informações de armazenamento de tabelas na pasta principal do projeto especificado, execute a seguinte consulta:

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

Exemplo

A consulta seguinte mostra a utilização de todas as tabelas na pasta na data 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_FOLDER
  )
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                |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+