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: ist ein beliebiger Dataset-Regionsname. Beispiel: `region-us`

    • 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";