Esta página foi traduzida pela API Cloud Translation.

Visualização TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER

A visualização INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER 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

A visualização INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER exclui tabelas sem bytes faturáveis. Os seguintes tipos de tabela são excluídos:

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

Quando você consulta a visualização INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER, os resultados da consulta contêm uma linha por dia para cada tabela ou visualização materializada na pasta pai do projeto atual, incluindo as subpastas.

Os dados desta tabela não estão disponíveis em tempo real. Os dados da tabela levam aproximadamente 72 horas para aparecer nessa visualização.

A visualização retorna o uso do armazenamento em segundos de MiB. 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

O valor do uso de armazenamento pode ser encontrado na coluna BILLABLE_TOTAL_PHYSICAL_USAGE. Para mais informações, consulte Detalhes dos preços de armazenamento.

Permissões necessárias

Para consultar a visualização INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER, você precisa das seguintes permissões do Identity and Access Management (IAM) para a pasta mãe do projeto:

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

Para mais informações sobre as permissões do BigQuery, consulte Papéis e permissões do IAM no BigQuery.

Esquema

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

`USAGE_DATE`	`DATE`	A data de faturamento dos bytes mostrados, usando o fuso horário `America/Los_Angeles`
`FOLDER_NUMBERS`	`REPEATED INTEGER`	IDs de número das pastas que contêm o projeto, começando com a pasta que contém o projeto imediatamente, seguido pela pasta que contém a pasta filho e assim por diante. Por exemplo, se `FOLDER_NUMBERS` for `[1, 2, 3]`, a pasta `1` conterá imediatamente o projeto, a pasta `2` conterá `1` e a pasta `3` conterá `2`. Essa coluna é preenchida apenas 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 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 com 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_FOLDER	Pasta que contém o projeto especificado	`REGION`

Substitua:

Opcional: PROJECT_ID: o ID do seu projeto 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.

Para extrair informações de armazenamento de tabelas na pasta mãe do projeto especificado, execute a seguinte consulta:

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

Exemplo

A consulta a seguir mostra o uso 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 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                |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+