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 [e-mail]:

SELECT *
FROM `my-project-id.region-us`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES
WHERE user_email = "[e-mail]"

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 | [e-mail] | ["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 | [e-mail] | ["bigquery-public-data.chicago_taxi_trips.taxi_trips"]                                 |
  | 2022-04-01 21:06:49 | my-project-id |   123456789000 | default          | 161061273600 | [e-mail] | [""]                                                                                   |
  +---------------------+---------------+----------------+------------------+--------------+---------------------+----------------------------------------------------------------------------------------+
  

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 | [e-mail] | [""]              |
  | 2023-07-09 17:47:26 | 161061273600 | [e-mail] | ["pr.dataset.t1"] |
  +---------------------+--------------+----------------------+-------------------+