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 |
- 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;
Examples
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 | +---------------+---------+