vista INFORMATION_SCHEMA.BI_CAPACITIES

La vista INFORMATION_SCHEMA.BI_CAPACITIES contiene metadati relativi allo stato attuale della capacità di BI Engine. Se vuoi visualizzare la cronologia di modifiche alla prenotazione BI Engine, consulta INFORMATION_SCHEMA.BI_CAPACITY_CHANGES visualizzazione.

Autorizzazione obbligatoria

Per eseguire query sulla vista INFORMATION_SCHEMA.BI_CAPACITIES, è necessario il bigquery.bireservations.get Autorizzazione Identity and Access Management (IAM) per nelle prenotazioni BI Engine.

Per ulteriori informazioni sulle autorizzazioni BigQuery, consulta Controllo dell'accesso con IAM.

Schema

Quando esegui una query sulla vista INFORMATION_SCHEMA.BI_CAPACITIES, i risultati contiene una riga con lo stato attuale della capacità di BI Engine.

La vista INFORMATION_SCHEMA.BI_CAPACITIES ha il seguente schema:

Nome colonna Tipo di dati Valore
project_id STRING L'ID del progetto che contiene BI Engine e la capacità di archiviazione.
project_number INTEGER Il numero del progetto che contiene dalla capacità di BI Engine.
bi_capacity_name STRING Il nome dell'oggetto. Attualmente può esserci una sola capacità per progetto, perciò il nome è sempre impostato su default.
size INTEGER RAM BI Engine in byte
preferred_tables REPEATED STRING Insieme di tabelle preferite che deve essere la capacità di BI Engine usato. Se impostato su null, la capacità di BI Engine viene utilizzato per tutte le query nel progetto attuale

Ambito e sintassi

Le query relative a questa vista devono includere un qualificatore regione. Un ID progetto è facoltativo. Se non viene specificato alcun ID progetto, il progetto eseguito dalla query .

Nome vista Ambito risorsa Ambito della regione
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.BI_CAPACITIES Livello di progetto REGION
Sostituisci quanto segue:

  • (Facoltativo) PROJECT_ID: l'ID del tuo progetto Google Cloud. Se non specificato, viene utilizzato il progetto predefinito.
  • REGION: qualsiasi nome della regione del set di dati. Ad esempio: region-us.

Esempio

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

Esempi

L'esempio seguente recupera le modifiche attuali della capacità di BI Engine da INFORMATION_SCHEMA.BI_CAPACITIES visualizzazione.

Eseguire la query su un progetto diverso da quello a cui si riferisce la query in esecuzione, aggiungi l'ID progetto alla regione nel seguente formato: `project_id`.`region_id`.INFORMATION_SCHEMA.BI_CAPACITIES.

L'esempio seguente mostra lo stato attuale di BI Engine nella progetto con ID "my-project-id":

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

Il risultato è simile al seguente:

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

L'esempio seguente restituisce la dimensione della capacità di BI Engine in gigabyte per il progetto di query:

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

Il risultato è simile al seguente:

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