Vista INFORMATION_SCHEMA.BI_CAPACITY_CHANGES

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

Autorização necessária

Para consultar a vista INFORMATION_SCHEMA.BI_CAPACITY_CHANGES, precisa da autorização de gestão de identidade e de acesso (IAM) para reservas do BI Engine.bigquery.bireservations.get

Para mais informações sobre as autorizações do BigQuery, consulte o artigo Controlo de acesso com a IAM.

Esquema

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

A vista INFORMATION_SCHEMA.BI_CAPACITY_CHANGES tem o seguinte esquema:

Nome da coluna	Tipo de dados	Valor
change_timestamp	TIMESTAMP	Data/hora em que 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	O endereço de email do utilizador ou o assunto da federação de identidades da força de trabalho que fez a alteração. google para alterações efetuadas pela Google. NULL se o endereço de email for desconhecido.
preferred_tables	REPEATED STRING	O conjunto de tabelas preferenciais para as quais esta capacidade do BI Engine tem de ser usada. Se estiver definido como null, a capacidade do BI Engine é usada para todas as consultas no projeto atual.

Sintaxe

As consultas nesta vista têm de incluir um qualificador de região. Um ID do projeto é opcional. Se não for especificado um ID do projeto, é usado o projeto no qual a consulta é executada.

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

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

Exemplos

O exemplo seguinte obtém as alterações atuais da capacidade do BI Engine a partir da vista INFORMATION_SCHEMA.BI_CAPACITY_CHANGES.

Para executar a consulta num projeto diferente do projeto no qual a consulta está a ser executada, adicione o ID do projeto à região no seguinte formato: `project_id`.`region_id`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES.

O exemplo seguinte obtém todas as alterações feitas à capacidade do BI Engine por um utilizador com o email [e-mail]:

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

O resultado tem um aspeto semelhante ao seguinte:

  +---------------------+---------------+----------------+------------------+--------------+---------------------+----------------------------------------------------------------------------------------+
  |  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 seguinte obtém as alterações de 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 tem um aspeto semelhante ao seguinte:

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