Ansicht INFORMATION_SCHEMA.BI_CAPACITIES

Die Ansicht INFORMATION_SCHEMA.BI_CAPACITIES enthält Metadaten zum aktuellen Status der BI Engine-Kapazität. Den Verlauf der Änderungen an der BI Engine-Reservierung können Sie der Ansicht INFORMATION_SCHEMA.BI_CAPACITY_CHANGES entnehmen.

Erforderliche Berechtigung

Zum Abfragen der INFORMATION_SCHEMA.BI_CAPACITIES-Ansicht benötigen Sie die IAM-Berechtigung (Identity and Access Management) bigquery.bireservations.get für BI Engine-Reservierungen.

Weitere Informationen zu BigQuery-Berechtigungen finden Sie unter Zugriffssteuerung mit IAM.

Schema

Wenn Sie die INFORMATION_SCHEMA.BI_CAPACITIES-Ansicht abfragen, enthalten die Abfrageergebnisse eine Zeile mit dem aktuellen Status der BI Engine-Kapazität.

Die Ansicht INFORMATION_SCHEMA.BI_CAPACITIES hat das folgende Schema:

Spaltenname Datentyp Wert
project_id STRING Die Projekt-ID des Projekts, das die BI Engine-Kapazität enthält.
project_number INTEGER Die Nummer des Projekts, das die BI Engine-Kapazität enthält.
bi_capacity_name STRING Der Name des Objekts. Derzeit kann nur eine Kapazität pro Projekt vorhanden sein. Daher lautet der Name immer default.
size INTEGER BI Engine-RAM in Byte.
preferred_tables REPEATED STRING Der Satz bevorzugter Tabellen, für die diese BI Engine-Kapazität verwendet werden muss. Wenn null festgelegt ist, wird die BI Engine-Kapazität für alle Abfragen im aktuellen Projekt verwendet.

Bereich und Syntax

Für Abfragen dieser Ansicht muss ein Regions-Qualifier verwendet werden. Die Projekt-ID ist optional. Wenn keine Projekt-ID angegeben ist, wird das Projekt verwendet, in dem die Abfrage ausgeführt wird.

Ansichtsname Ressourcenbereich Regionsbereich
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.BI_CAPACITIES Projektebene REGION
Dabei gilt:

  • Optional: PROJECT_ID: die ID Ihres Google Cloud-Projekts. Wenn keine Angabe erfolgt, wird das Standardprojekt verwendet.
  • REGION: ist ein beliebiger Dataset-Regionsname. Beispiel: region-us

Beispiel

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

Beispiele

Im folgenden Beispiel werden die aktuellen Änderungen der BI Engine-Kapazität aus der INFORMATION_SCHEMA.BI_CAPACITIES-Ansicht abgerufen.

Wenn Sie die Abfrage für ein anderes Projekt ausführen möchten, fügen Sie die Projekt-ID im folgenden Format zur Region hinzu: `project_id`.`region_id`.INFORMATION_SCHEMA.BI_CAPACITIES.

Das folgende Beispiel zeigt den aktuellen Status der BI Engine im Projekt mit der ID „my-project-id“:

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

Das Ergebnis sieht ungefähr so aus:

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

Im folgenden Beispiel wird die Größe der BI Engine-Kapazität für das Abfrageprojekt in Gigabyte zurückgegeben:

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

Das Ergebnis sieht ungefähr so aus:

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