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.
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 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 |
- 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.
Un ejemplo es region-us
.
Ejemplo
-- Returns current state of BI Engine capacity.
SELECT * FROM myproject.`region-us`.INFORMATION_SCHEMA.BI_CAPACITIES;
Ejemplos
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 | +---------------+---------+