Visualização INFORMATION_SCHEMA.BI_CAPACITY_CHANGES

A visualização INFORMATION_SCHEMA.BI_CAPACITY_CHANGES contém o histórico de alterações na capacidade do BI Engine. Se você quiser ver o estado atual da reserva do BI Engine, consulte a visualização INFORMATION_SCHEMA.BI_CAPACITIES.

Permissão necessária

Para consultar a visualização INFORMATION_SCHEMA.BI_CAPACITY_CHANGES, é necessário ter a permissão bigquery.bireservations.get do Identity and Access Management (IAM) para reservas do BI Engine.

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

Esquema

Quando é feita uma consulta da visualização INFORMATION_SCHEMA.BI_CAPACITY_CHANGES, os resultados dela contêm uma linha para cada atualização de capacidade do BI Engine, incluindo a do estado atual.

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

Nome da coluna	Tipo de dados	Valor
`change_timestamp`	`TIMESTAMP`	Carimbo de data/hora de quando a atualização atual da capacidade do BI Engine foi feita.
`project_id`	`STRING`	O ID do projeto que contém a capacidade do BI Engine.
`project_number`	`INTEGER`	O número do projeto que contém a capacidade do BI Engine.
`bi_capacity_name`	`STRING`	O nome do objeto. Atualmente, só pode haver uma capacidade por projeto. Por isso, o nome é sempre `default`.
`size`	`INTEGER`	RAM do BI Engine em bytes.
`user_email`	`STRING`	Endereço de e-mail do usuário ou sujeito da federação de identidade da força de trabalho que fez a alteração. `google` para alterações feitas pelo Google. `NULL` se o endereço de e-mail for desconhecido.
`preferred_tables`	`REPEATED STRING`	O conjunto de tabelas preferenciais em que a capacidade do BI Engine precisa ser usada. Se definida como `null`, a capacidade do BI Engine será usada para todas as consultas no projeto atual.

Sintaxe

As consultas nessa visualização precisam incluir um qualificador de região. Um ID do projeto é opcional. Se nenhum ID de projeto for especificado, o projeto em que a consulta será executada será usado.

Nome da visualização	Escopo do recurso	Escopo da região
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES	Nível do projeto	`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.

-- Returns the history of BI Engine capacity.
SELECT * FROM myproject.`region-us`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES;

Exemplos

O exemplo a seguir recupera as mudanças atuais da capacidade do BI Engine da visualização INFORMATION_SCHEMA.BI_CAPACITY_CHANGES.

Para executar a consulta em um projeto diferente daquele em que a consulta está sendo executada, adicione o ID do projeto à região no seguinte formato: `project_id`.`region_id`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES.

O exemplo a seguir mostra todas as alterações feitas na capacidade do BI Engine por um usuário com o e-mail email@mycompanymail.com:

SELECT *
FROM `my-project-id.region-us`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES
WHERE user_email = "email@mycompanymail.com"

O resultado será semelhante a este:

  +---------------------+---------------+----------------+------------------+--------------+---------------------+----------------------------------------------------------------------------------------+
  |  change_timestamp   |  project_id   | project_number | bi_capacity_name |     size     |     user_email      |                                               preferred_tables                         |
  +---------------------+---------------+----------------+------------------+--------------+---------------------+----------------------------------------------------------------------------------------+
  | 2022-06-14 02:22:18 | my-project-id |   123456789000 | default          | 268435456000 | email@mycompany.com | ["my-project-id.dataset1.table1","bigquery-public-data.chicago_taxi_trips.taxi_trips"] |
  | 2022-06-08 20:25:51 | my-project-id |   123456789000 | default          | 268435456000 | email@mycompany.com | ["bigquery-public-data.chicago_taxi_trips.taxi_trips"]                                 |
  | 2022-04-01 21:06:49 | my-project-id |   123456789000 | default          | 161061273600 | email@mycompany.com | [""]                                                                                   |
  +---------------------+---------------+----------------+------------------+--------------+---------------------+----------------------------------------------------------------------------------------+

O exemplo a seguir mostra as alterações da capacidade do BI Engine nos últimos sete dias:

SELECT
  change_timestamp,
  size,
  user_email,
  preferred_tables
FROM `my-project-id.region-us`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES
WHERE change_timestamp > TIMESTAMP_SUB(CURRENT_DATE(), INTERVAL 7 DAY)

O resultado será semelhante a este:

  +---------------------+--------------+----------------------+-------------------+
  |  change_timestamp   |     size     |     user_email       |  preferred_tables |                                                                                    |
  +---------------------+--------------+----------------------+-------------------+
  | 2023-07-08 18:25:09 | 268435456000 | sundar@mycompany.com | [""]              |
  | 2023-07-09 17:47:26 | 161061273600 | pichai@mycompany.com | ["pr.dataset.t1"] |
  +---------------------+--------------+----------------------+-------------------+