Vista INFORMATION_SCHEMA.BI_CAPACITIES

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

Permiso obligatorio

Para consultar la vista INFORMATION_SCHEMA.BI_CAPACITIES, necesita el permiso de gestión de identidades y accesos (IAM) bigquery.bireservations.get para las reservas de BI Engine.

Para obtener más información sobre los permisos de BigQuery, consulta Control de acceso con gestión de identidades y accesos.

Esquema

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 la capacidad de BI Engine.
project_number INTEGER El número de proyecto del proyecto que contiene la 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 Conjunto de tablas preferidas que debe usar esta capacidad de BI Engine. Si se define como null, la capacidad de BI Engine se utiliza para todas las consultas del proyecto actual.

Ámbito y sintaxis

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

Nombre de la vista Ámbito de los recursos Ámbito de la región
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.BI_CAPACITIES Nivel de proyecto REGION
Sustituye lo siguiente:
  • Opcional: PROJECT_ID: el ID de tu Google Cloud proyecto. 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;

Ejemplos

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

Para ejecutar la consulta en un proyecto distinto del proyecto en el que se está ejecutando, añade el ID del proyecto a la región con el siguiente formato: `project_id`.`region_id`.INFORMATION_SCHEMA.BI_CAPACITIES.

En el siguiente ejemplo 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 siguiente ejemplo se devuelve el tamaño de la capacidad de BI Engine en gigabytes del proyecto de la 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  |
  +---------------+---------+