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.

Nota: Debes especificar la ubicación para consultar las vistas de INFORMATION_SCHEMA y la ubicación de la ejecución de la consulta debe coincidir con la región de la vista de INFORMATION_SCHEMA.

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