Vista INFORMATION_SCHEMA.BI_CAPACITIES

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

Autorizzazione obbligatoria

Per eseguire query sulla visualizzazione INFORMATION_SCHEMA.BI_CAPACITIES, devi disporre dell'autorizzazione Identity and Access Management (IAM) bigquery.bireservations.get per le prenotazioni BI Engine.

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

Schema

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

La vista INFORMATION_SCHEMA.BI_CAPACITIES ha lo schema seguente:

Nome colonna Tipo di dati Valore
project_id STRING L'ID progetto del progetto che contiene la capacità di BI Engine.
project_number INTEGER Il numero di progetto del progetto che contiene la capacità di BI Engine.
bi_capacity_name STRING Il nome dell'oggetto. Può esserci una sola capacità per progetto, quindi il nome è sempre impostato su default.
size INTEGER RAM di BI Engine in byte
preferred_tables REPEATED STRING Il set di tabelle preferite per cui deve essere utilizzata questa capacità di BI Engine. Se impostato su null, la capacità di BI Engine viene utilizzata per tutte le query nel progetto corrente

Ambito e sintassi

Le query su questa visualizzazione devono includere un qualificatore di regione. L'ID progetto è facoltativo. Se non viene specificato alcun ID progetto, viene utilizzato il progetto in cui viene eseguita la query.

Nome vista Ambito risorsa Ambito regione
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.BI_CAPACITIES Livello progetto REGION
Sostituisci quanto segue:
  • (Facoltativo) PROJECT_ID: l'ID del tuo Google Cloud progetto. 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 alla capacità di BI Engine correnti dalla visualizzazione INFORMATION_SCHEMA.BI_CAPACITIES.

Per eseguire la query su un progetto diverso da quello in cui viene eseguita, 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 nel 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 le dimensioni 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  |
  +---------------+---------+