Vista INFORMATION_SCHEMA.BI_CAPACITIES

A vista INFORMATION_SCHEMA.BI_CAPACITIES contém metadados sobre o estado atual da capacidade do BI Engine. Se quiser ver o histórico de alterações à reserva do BI Engine, consulte a vista INFORMATION_SCHEMA.BI_CAPACITY_CHANGES.

Autorização necessária

Para consultar a vista INFORMATION_SCHEMA.BI_CAPACITIES, precisa da autorização de gestão de identidade e de acesso (IAM) para reservas do BI Engine.bigquery.bireservations.get

Para mais informações sobre as autorizações do BigQuery, consulte o artigo Controlo de acesso com a IAM.

Esquema

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

A vista 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 existir 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 que esta capacidade do BI Engine tem de ser usada para. Se estiver definido como null, a capacidade do BI Engine é usada para todas as consultas no projeto atual

Âmbito e sintaxe

As consultas nesta vista têm de incluir um qualificador de região. Um ID do projeto é opcional. Se não for especificado um ID do projeto, é usado o projeto no qual a consulta é executada.

Nome da visualização de propriedade Âmbito do recurso Âmbito da região
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.BI_CAPACITIES Nível do projeto REGION
Substitua o seguinte:
  • Opcional: PROJECT_ID: o ID do seu projeto do Google Cloud Google Cloud. Se não for especificado, é usado o projeto predefinido.
  • 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 seguinte obtém as alterações atuais da capacidade do BI Engine a partir da visualização INFORMATION_SCHEMA.BI_CAPACITIES.

Para executar a consulta num projeto diferente do projeto no qual a consulta está a ser executada, adicione o ID do projeto à região no seguinte formato: `project_id`.`region_id`.INFORMATION_SCHEMA.BI_CAPACITIES.

O exemplo seguinte 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 tem um aspeto semelhante ao seguinte:

  +---------------+----------------+------------------+--------------+-----------------------------------------------------------------------------------------------+
  |  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 seguinte devolve 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 tem um aspeto semelhante ao seguinte:

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