Vista de INFORMATION_SCHEMA.BI_CAPACITY_CHANGE

La vista INFORMATION_SCHEMA.BI_CAPACITY_CHANGES contiene el historial de cambios de la capacidad de BI Engine. Si deseas ver el estado actual de la reserva de BI Engine, consulta la vista INFORMATION_SCHEMA.BI_CAPACITIES.

Permiso necesario

A fin de consultar la vista INFORMATION_SCHEMA.BI_CAPACITY_CHANGES, necesitas el permiso bigquery.bireservations.get de Identity and Access Management (IAM) para las reservas de BI Engine.

Para obtener más información sobre IAM de BigQuery, consulta Control de acceso con IAM.

Schema

Cuando consultas la vista INFORMATION_SCHEMA.BI_CAPACITY_CHANGES, los resultados contienen una fila por cada actualización de la capacidad de BI Engine, incluido el estado actual.

La vista INFORMATION_SCHEMA.BI_CAPACITY_CHANGES tiene el siguiente esquema:

Nombre de la columna Tipo de datos Valor
change_timestamp TIMESTAMP Marca de tiempo en la que se realizó la actualización actual de la capacidad de BI Engine.
project_id STRING El ID del proyecto que contiene capacidad de BI Engine.
project_number INTEGER El número del proyecto que contiene capacidad de BI Engine.
bi_capacity_name STRING El nombre del objeto. Actualmente, solo puede haber una capacidad por proyecto, por lo que el nombre siempre es default.
size INTEGER RAM de BI Engine en bytes.
user_email STRING Dirección de correo electrónico del usuario o persona de la federación de Workforce Identity que realizó el cambio. google para los cambios que realizó Google. NULL si se desconoce la dirección de correo electrónico.
preferred_tables REPEATED STRING El conjunto de tablas preferidas para el que se debe usar esta capacidad de BI Engine. Si se configura como null, la capacidad de BI Engine se usa para todas las consultas del proyecto actual.

Sintaxis

Las consultas realizadas a esta vista deben incluir un calificador de región. El uso de un ID del proyecto es opcional. Si no se especifica un ID del proyecto, se usa el proyecto en el que se ejecuta la consulta.

Nombre de la vista Permiso del recurso Permiso de la región
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES Nivel de proyecto REGION
Reemplaza lo siguiente:

  • Opcional: PROJECT_ID: el ID del proyecto de Google Cloud. Si no se especifica, se usa el proyecto predeterminado.
  • REGION: Cualquier nombre de región del conjunto de datos. Por ejemplo, region-us.
-- Returns the history of BI Engine capacity.
SELECT * FROM myproject.`region-us`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES;

Ejemplos

En el ejemplo siguiente, se recuperan los cambios actuales de capacidad de BI Engine desde la vista INFORMATION_SCHEMA.BI_CAPACITY_CHANGES.

Para ejecutar la consulta en un proyecto que no sea el en el que se ejecuta la consulta, agrega el ID del proyecto a la región con el siguiente formato: `project_id`.`region_id`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES.

En el siguiente ejemplo, se muestran todos los cambios realizados en la capacidad de BI Engine por un usuario con el correo electrónico email@mycompanymail.com:

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

El resultado es similar al siguiente:

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

En el siguiente ejemplo, se obtienen cambios de capacidad de BI Engine durante los últimos siete días:

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)

El resultado es similar al siguiente:

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