Ansicht ASSIGNMENTS

Die Ansicht INFORMATION_SCHEMA.ASSIGNMENTS enthält eine Liste aller aktuellen Zuweisungen im Administrationsprojekt nahezu in Echtzeit. Jede Zeile steht für eine einzelne aktuelle Zuweisung. Eine aktuelle Zuweisung ist entweder ausstehend oder aktiv und wurde nicht gelöscht. Weitere Informationen zur Reservierung finden Sie unter Einführung in Reservierungen.

Erforderliche Berechtigung

Zum Abfragen der INFORMATION_SCHEMA.ASSIGNMENTS-Ansicht benötigen Sie die IAM-Berechtigung (Identity and Access Management) bigquery.reservationAssignments.list für das Projekt. Jede der folgenden vordefinierten IAM-Rollen enthält die erforderliche Berechtigung:

roles/bigquery.resourceAdmin
roles/bigquery.resourceEditor
roles/bigquery.resourceViewer
roles/bigquery.user
roles/bigquery.admin

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

Schema

Die Ansicht INFORMATION_SCHEMA.ASSIGNMENTS hat das folgende Schema:

Spaltenname	Datentyp	Wert
`ddl`	`STRING`	Die DDL-Anweisung, die zum Erstellen dieser Zuweisung verwendet wird.
`project_id`	`STRING`	ID des Administrationsprojekts.
`project_number`	`INTEGER`	Nummer des Administrationsprojekts.
`assignment_id`	`STRING`	ID, die die Zuweisung eindeutig kennzeichnet.
`reservation_name`	`STRING`	Name der Reservierung, die die Zuweisung verwendet.
`job_type`	`STRING`	Die Art des Jobs, der die Reservierung verwenden kann. Kann `PIPELINE`, `QUERY`, `CONTINUOUS`, `ML_EXTERNAL` oder `BACKGROUND` sein.
`assignee_id`	`STRING`	ID, die die Ressource des Empfängers der Zuweisung eindeutig identifiziert.
`assignee_number`	`INTEGER`	Zahl, die die Ressource des Empfängers der Zuweisung eindeutig identifiziert.
`assignee_type`	`STRING`	Typ der zugewiesenen Ressource. Kann `organization`, `folder` oder `project` sein.

Bereich und Syntax

Für Abfragen dieser Ansicht muss ein Regions-Qualifier verwendet werden. Wenn Sie keinen regionalen Qualifier angeben, werden Metadaten aus allen Regionen abgerufen. In der folgenden Tabelle wird der Regionsbereich für diese Ansicht erläutert:

Ansichtsname	Ressourcenbereich	Regionsbereich
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.ASSIGNMENTS[_BY_PROJECT]	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.

Beispiel

Wenn Sie die Abfrage für ein anderes Projekt als Ihr Standardprojekt ausführen möchten, fügen Sie die Projekt-ID im folgenden Format hinzu: .

`PROJECT_ID`.`region-REGION_NAME`.INFORMATION_SCHEMA.ASSIGNMENTS

Ersetzen Sie dabei Folgendes:

PROJECT_ID: die ID des Projekts, dem Sie Reservierungen zugewiesen haben.
REGION_NAME: der Name der Region.

Beispiel: `myproject`.`region-us`.INFORMATION_SCHEMA.ASSIGNMENTS.

Im folgenden Beispiel werden die aktuell zugewiesene Reservierung und die Slotkapazität des Projekts abgerufen. Diese Informationen sind nützlich für das Debugging der Jobleistung. Dazu vergleichen Sie die Slotnutzung des Projekts mit der Slotkapazität der Reservierung.

SELECT
  reservation.reservation_name,
  reservation.slot_capacity
FROM
  `RESERVATION_ADMIN_PROJECT.region-REGION_NAME`.
  INFORMATION_SCHEMA.ASSIGNMENTS_BY_PROJECT assignment
INNER JOIN
  `RESERVATION_ADMIN_PROJECT.region-REGION_NAME`.
  INFORMATION_SCHEMA.RESERVATIONS_BY_PROJECT AS reservation
ON
  (assignment.reservation_name = reservation.reservation_name)
WHERE
   assignment.assignee_id = "PROJECT_ID"
  AND job_type = "QUERY";