INFORMATION_SCHEMA.BI_CAPACITY_CHANGES view

Die Ansicht INFORMATION_SCHEMA.BI_CAPACITY_CHANGES enthält den Änderungsverlauf der BI Engine-Kapazität. Den aktuellen Status der BI Engine-Reservierung finden Sie in der Ansicht INFORMATION_SCHEMA.BI_CAPACITIES.

Erforderliche Berechtigung

Zum Abfragen der INFORMATION_SCHEMA.BI_CAPACITY_CHANGES-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 Ansicht INFORMATION_SCHEMA.BI_CAPACITY_CHANGES abfragen, wird im Ergebnis jede Aktualisierung der BI Engine-Kapazität einschließlich des aktuellen Status in einer Zeile dargestellt.

Die Ansicht INFORMATION_SCHEMA.BI_CAPACITY_CHANGES hat das folgende Schema:

Spaltenname	Datentyp	Wert
`change_timestamp`	`TIMESTAMP`	Zeitstempel für die aktuelle Aktualisierung der BI Engine-Kapazität.
`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.
`user_email`	`STRING`	E-Mail-Adresse des Nutzers oder Subjekts der Workload Identity-Föderation, die die Änderung vorgenommen hat. `google` für von Google vorgenommene Änderungen. `NULL`, wenn die E-Mail-Adresse unbekannt ist.
`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.

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_CAPACITY_CHANGES	Projektebene	`REGION`

Ersetzen Sie Folgendes:

Optional: PROJECT_ID: die ID Ihres Google Cloud-Projekts. Wenn keine Angabe erfolgt, wird das Standardprojekt verwendet.

: + REGION: beliebiger Dataset-Regionsname. Beispiel: region-us.

Hinweis: Zum Abfragen von INFORMATION_SCHEMA-Ansichten müssen Sie einen Regions-Qualifier verwenden. Der Ort der Abfrageausführung muss mit der Region der Ansicht INFORMATION_SCHEMA übereinstimmen.

-- Returns the history of BI Engine capacity.
SELECT * FROM myproject.`region-us`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES;

Beispiele

Im folgenden Beispiel werden die aktuellen Änderungen der BI Engine-Kapazität aus der INFORMATION_SCHEMA.BI_CAPACITY_CHANGES-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_CAPACITY_CHANGES.

Im folgenden Beispiel werden alle Änderungen an der BI Engine-Kapazität von einem Nutzer mit der E-Mail-Adresse email@mycompanymail.com abgerufen:

SELECT *
FROM `my-project-id.region-us`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES
WHERE user_email = "email@mycompanymail.com"

Das Ergebnis sieht ungefähr so aus:

  +---------------------+---------------+----------------+------------------+--------------+---------------------+----------------------------------------------------------------------------------------+
  |  change_timestamp   |  project_id   | project_number | bi_capacity_name |     size     |     user_email      |                                               preferred_tables                         |
  +---------------------+---------------+----------------+------------------+--------------+---------------------+----------------------------------------------------------------------------------------+
  | 2022-06-14 02:22:18 | my-project-id |   123456789000 | default          | 268435456000 | email@mycompany.com | ["my-project-id.dataset1.table1","bigquery-public-data.chicago_taxi_trips.taxi_trips"] |
  | 2022-06-08 20:25:51 | my-project-id |   123456789000 | default          | 268435456000 | email@mycompany.com | ["bigquery-public-data.chicago_taxi_trips.taxi_trips"]                                 |
  | 2022-04-01 21:06:49 | my-project-id |   123456789000 | default          | 161061273600 | email@mycompany.com | [""]                                                                                   |
  +---------------------+---------------+----------------+------------------+--------------+---------------------+----------------------------------------------------------------------------------------+

Im folgenden Beispiel werden BI Engine-Kapazitätsänderungen der letzten sieben Tage abgerufen:

SELECT
  change_timestamp,
  size,
  user_email,
  preferred_tables
FROM `my-project-id.region-us`.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES
WHERE change_timestamp > TIMESTAMP_SUB(CURRENT_DATE(), INTERVAL 7 DAY)

Das Ergebnis sieht ungefähr so aus:

  +---------------------+--------------+----------------------+-------------------+
  |  change_timestamp   |     size     |     user_email       |  preferred_tables |                                                                                    |
  +---------------------+--------------+----------------------+-------------------+
  | 2023-07-08 18:25:09 | 268435456000 | sundar@mycompany.com | [""]              |
  | 2023-07-09 17:47:26 | 161061273600 | pichai@mycompany.com | ["pr.dataset.t1"] |
  +---------------------+--------------+----------------------+-------------------+