Vista INFORMATION_SCHEMA.BI_CAPACITIES

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

Permiso necesario

A fin de consultar la vista INFORMATION_SCHEMA.BI_CAPACITIES, 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_CAPACITIES, los resultados de la consulta contienen una fila con el estado actual de la capacidad de BI Engine.

La vista INFORMATION_SCHEMA.BI_CAPACITIES tiene el siguiente esquema:

Nombre de la columna Tipo de datos Valor
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
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.

Permiso y 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_CAPACITIES 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.

Ejemplo

-- Returns current state of BI Engine capacity.
SELECT * FROM myproject.`region-us`.INFORMATION_SCHEMA.BI_CAPACITIES;

Examples

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

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_CAPACITIES.

En el ejemplo siguiente, se muestra el estado actual de BI Engine en el proyecto con el ID “my-project-id”:

SELECT *
FROM `my-project-id.region-us`.INFORMATION_SCHEMA.BI_CAPACITIES

El resultado es similar al siguiente:

  +---------------+----------------+------------------+--------------+-----------------------------------------------------------------------------------------------+
  |  project_id   | project_number | bi_capacity_name |     size     |                                               preferred_tables                                |
  +---------------+----------------+------------------+--------------+-----------------------------------------------------------------------------------------------+
  | my-project-id |   123456789000 | default          | 268435456000 | "my-company-project-id.dataset1.table1","bigquery-public-data.chicago_taxi_trips.taxi_trips"] |
  +---------------+----------------+------------------+--------------+-----------------------------------------------------------------------------------------------+

En el ejemplo siguiente, se muestra el tamaño de la capacidad de BI Engine en gigabytes para el proyecto de consulta:

SELECT
  project_id,
  size/1024.0/1024.0/1024.0 AS size_gb
FROM `region-us`.INFORMATION_SCHEMA.BI_CAPACITIES

El resultado es similar al siguiente:

  +---------------+---------+
  |  project_id   | size_gb |
  +---------------+---------+
  | my-project-id |  250.0  |
  +---------------+---------+