Visualização INFORMATION_SCHEMA.BI_CAPACITIES

A visualização INFORMATION_SCHEMA.BI_CAPACITIES contém metadados sobre o estado atual da capacidade do BI Engine. Se você quiser visualizar o histórico de mudanças na reserva do BI Engine, consulte a visualização INFORMATION_SCHEMA.BI_CAPACITY_CHANGES.

Permissão necessária

Para consultar a visualização INFORMATION_SCHEMA.BI_CAPACITIES, é necessário ter a permissão bigquery.bireservations.get do Identity and Access Management (IAM) para reservas do BI Engine.

Para mais informações sobre as permissões do BigQuery, consulte Controle de acesso com o IAM.

Esquema

Quando você consulta a visualização INFORMATION_SCHEMA.BI_CAPACITIES, os resultados da consulta contêm uma linha com o estado atual da capacidade do BI Engine.

A visualização INFORMATION_SCHEMA.BI_CAPACITIES tem o seguinte esquema:

Nome da coluna Tipo de dados Valor
project_id STRING O ID do projeto que contém a capacidade do BI Engine.
project_number INTEGER O número do projeto que contém a capacidade do BI Engine.
bi_capacity_name STRING O nome do objeto. Atualmente, só pode haver uma capacidade por projeto. Por isso, o nome é sempre definido como default.
size INTEGER RAM do BI Engine em bytes
preferred_tables REPEATED STRING Conjunto de tabelas preferenciais para usar a capacidade do BI Engine. Se definida como null, a capacidade do BI Engine será usada para todas as consultas no projeto atual

Escopo e sintaxe

As consultas nessa visualização precisam incluir um qualificador de região. Um ID do projeto é opcional. Se nenhum ID de projeto for especificado, o projeto em que a consulta será executada será usado.

Nome da visualização Escopo do recurso Escopo da região
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.BI_CAPACITIES Nível do projeto REGION
Substitua:

  • Opcional: PROJECT_ID: o ID do seu projeto do Google Cloud. Se não for especificado, o projeto padrão será usado.
+ REGION: qualquer nome da região do conjunto de dados. Por exemplo, region-us.

Exemplo

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

Exemplos

O exemplo a seguir recupera as mudanças atuais de capacidade do BI Engine da visualização INFORMATION_SCHEMA.BI_CAPACITIES.

Para executar a consulta em um projeto diferente do projeto em que a consulta está sendo executada, adicione o ID do projeto à região no seguinte formato: `project_id`.`region_id`.INFORMATION_SCHEMA.BI_CAPACITIES.

O exemplo a seguir mostra o estado atual do BI Engine no projeto com o ID "my-project-id":

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

O resultado será semelhante a este:

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

O exemplo a seguir retorna o tamanho da capacidade do BI Engine em gigabytes para o projeto de consulta:

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

O resultado será semelhante a este:

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