Ansicht JOBS_BY_FOLDER

Die Ansicht INFORMATION_SCHEMA.JOBS_BY_FOLDER enthält Echtzeit-Metadaten zu allen Jobs, die im übergeordneten Ordner des aktuellen Projekts gesendet wurden, einschließlich der Jobs in Unterordnern.

Erforderliche Berechtigungen

Zum Abfragen der Ansicht INFORMATION_SCHEMA.JOBS_BY_FOLDER benötigen Sie die IAM-Berechtigung (Identity and Access Management) bigquery.jobs.listAll für den übergeordneten Ordner. Jede der folgenden vordefinierten IAM-Rollen enthält die erforderliche Berechtigung:

  • Ordneradministrator
  • BigQuery-Ressourcen-Administrator

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

Schema

Die zugrunde liegenden Daten werden nach der Spalte creation_time partitioniert und nach project_id und user_email geclustert.

Die Ansicht INFORMATION_SCHEMA.JOBS_BY_FOLDER hat das folgende Schema:

Spaltenname Datentyp Wert
creation_time TIMESTAMP (Partitionierungsspalte) Erstellungszeit dieses Jobs. Die Partitionierung basiert auf der UTC-Zeit dieses Zeitstempels.
project_id STRING (Clustering-Spalte) ID des Projekts
project_number INTEGER Nummer des Projekts.
folder_numbers REPEATED INTEGER GAIA-IDs (Google Accounts and ID Administration) von Ordnern im Ancestor eines Projekts, beginnend mit dem Blattordner, der dem Projekt am nächsten ist. Diese Spalte enthält nur in JOBS_BY_FOLDER Werte.
user_email STRING (Clustering-Spalte) E-Mail-Adresse oder Dienstkonto des Nutzers, der den Job ausgeführt hat.
job_id STRING ID des Jobs, z. B. bquxjob_1234.
job_type STRING Typ des Jobs. Kann QUERY, LOAD, EXTRACT, COPY oder null sein. Der Jobtyp null gibt einen internen Job an, z. B. die Auswertung einer Anweisung des Skriptjobs oder die Aktualisierung der materialisierten Ansicht.
statement_type STRING Typ der Abfrageanweisung, sofern gültig. Beispiel: SELECT, INSERT, UPDATE, DELETE oder SCRIPT. Eine Liste der gültigen Werte finden Sie unter QueryStatementType.
priority STRING Die Priorität dieses Jobs Zulässige Werte: INTERACTIVE aud BATCH.
start_time TIMESTAMP Startzeit dieses Jobs.
end_time TIMESTAMP Endzeit dieses Jobs.
query STRING SQL-Abfragetext. Hinweis: Nur die Ansicht JOBS_BY_PROJECT hat die Spalte query.
state STRING Ausführungsstatus des Jobs. Gültige Statuswerte sind PENDING, RUNNING und DONE.
reservation_id STRING Name der primären Reservierung, die diesem Job gegebenenfalls zugewiesen ist Wenn Ihr Job in einem Projekt ausgeführt wurde, das einer Reservierung zugewiesen ist, hat er das Format RESERVATION_ADMIN_PROJECT:RESERVATION_LOCATION.RESERVATION_NAME.

In dieser Ausgabe gilt:

  • RESERVATION_ADMIN_PROJECT: der Name des Google Cloud-Projekts, das die Reservierung verwaltet
  • RESERVATION_LOCATION: der Standort der Reservierung
  • RESERVATION_NAME: der Name der Reservierung
total_bytes_processed INTEGER Gesamtzahl der vom Job verarbeiteten Byte.
total_slot_ms INTEGER Slotmillisekunden für den Job über seine gesamte Dauer
error_result RECORD Fehlerdetails (falls vorhanden) als ErrorProto.
cache_hit BOOLEAN Ob die Abfrageergebnisse dieses Jobs aus einem Cache stammen.
destination_table RECORD Zieltabelle für etwaige Ergebnisse
referenced_tables RECORD Array aus Tabellen, auf die der Job verweist. Wird nur für Abfragejobs ausgefüllt.
labels RECORD Array aus Labels, die als Strings in der Form key, valueauf den Job angewendet werden.
timeline RECORD Abfragezeitachse des Jobs. Enthält Snapshots der Abfrageausführung.
job_stages RECORD Abfragephasen des Jobs
total_bytes_billed INTEGER Wenn das Projekt für die Verwendung von On-Demand-Preisen konfiguriert ist, enthält dieses Feld die Gesamtzahl der für den Job in Rechnung gestellten Byte. Wenn das Projekt für die Verwendung von Pauschalpreisen konfiguriert ist, werden Ihnen keine Byte in Rechnung gestellt. Dieses Feld dient nur zur Information.
parent_job_id STRING ID des übergeordneten Jobs, sofern vorhanden.
transaction_id STRING ID der Transaktion, in der dieser Job ausgeführt wurde (falls vorhanden). (Vorschau)
session_info RECORD Details zur Sitzung, in der dieser Job ausgeführt wurde, sofern vorhanden. (Vorschau)
bi_engine_statistics RECORD Wenn das Projekt für die Verwendung der BI Engine-SQL-Schnittstelle konfiguriert ist, dann enthält dieses Feld BiEngineStatistics. Andernfalls NULL.
total_modified_partitions INTEGER Gesamtzahl der Partitionen, die der Job geändert hat. Dieses Feld wird für LOAD- und QUERY-Jobs ausgefüllt.

Datenaufbewahrung

Diese Ansicht enthält aktuell ausgeführte Jobs und den Jobverlauf der letzten 180 Tage.

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.JOBS_BY_FOLDER Ordner, der das angegebene Projekt enthält REGION
Dabei gilt:

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

Wenn Sie INFORMATION_SCHEMA.JOBS_BY_FOLDER abfragen, um eine Zusammenfassung der Kosten für Abfragejobs zu erhalten, schließen Sie die Anweisung SCRIPT aus. Andernfalls könnten einige Werte zweimal gezählt werden. Die Zeile SCRIPT enthält zusammenfassende Werte für alle untergeordneten Jobs, die im Rahmen dieses Jobs ausgeführt wurden.