Visualizzazione INFORMATION_SCHEMA.BI_CAPACITIES
La vista INFORMATION_SCHEMA.BI_CAPACITIES
contiene metadati sullo stato attuale
della capacità di BI Engine. Se vuoi visualizzare la cronologia delle modifiche apportate alla prenotazione di BI Engine, consulta la vista INFORMATION_SCHEMA.BI_CAPACITY_CHANGES
.
Autorizzazione obbligatoria
Per eseguire una query sulla vista INFORMATION_SCHEMA.BI_CAPACITIES
, devi disporre dell'autorizzazione bigquery.bireservations.get
Identity and Access Management (IAM) per le prenotazioni di 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 della query contengono 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 capacità di BI Engine. |
project_number |
INTEGER |
Il numero del progetto che contiene capacità di BI Engine. |
bi_capacity_name |
STRING |
Il nome dell'oggetto. Attualmente può esistere una sola capacità per progetto, quindi il nome è sempre impostato su default . |
size |
INTEGER |
RAM di BI Engine in byte |
preferred_tables |
REPEATED STRING |
Set di tabelle preferite per le quali deve essere utilizzata la capacità di BI Engine. Se impostata su null , la capacità di BI Engine viene utilizzata per tutte le query nel progetto attuale |
Ambito e sintassi
Le query relative a questa vista devono includere un qualificatore regione. L'ID progetto è facoltativo. Se non viene specificato alcun ID progetto, viene utilizzato il progetto in cui viene eseguita la query.
Nome visualizzazione | Ambito risorsa | Ambito regione |
---|---|---|
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.BI_CAPACITIES |
A livello di progetto | REGION |
- (Facoltativo)
PROJECT_ID
: l'ID del 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 alla capacità di BI Engine dalla vista INFORMATION_SCHEMA.BI_CAPACITIES
.
Per eseguire la query su un progetto diverso da quello in cui è eseguita la query, 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 sarà 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 sarà simile al seguente:
+---------------+---------+ | project_id | size_gb | +---------------+---------+ | my-project-id | 250.0 | +---------------+---------+