Esta página foi traduzida pela API Cloud Translation.

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 Google Cloud 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:

`USAGE_DATE`	`DATE`	A data de faturação dos bytes apresentados, usando o `America/Los_Angeles` fuso horário
`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_ORGANIZATION	Organização que contém o projeto especificado	`REGION`

Substitua o seguinte:

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

Nota: tem de usar um qualificador de região para consultar as visualizações INFORMATION_SCHEMA. A localização da execução da consulta tem de corresponder à região da vista INFORMATION_SCHEMA.

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