Ansicht PROJECT_OPTIONS

Sie können die Ansicht INFORMATION_SCHEMA.PROJECT_OPTIONS abfragen, um Echtzeit-Metadaten zu den Projektoptionen von BigQuery abzurufen. Diese Ansicht enthält Konfigurationsoptionen, die auf Projektebene festgelegt wurden. Die Standardwerte für eine Konfigurationsoption finden Sie unter Konfigurationseinstellungen.

Erforderliche Berechtigungen

Zum Abrufen der Metadaten der Konfigurationsoptionen benötigen Sie folgende IAM-Berechtigungen (Identity and Access Management):

  • bigquery.config.get

Die folgende vordefinierte IAM-Rolle enthält die Berechtigungen, die Sie benötigen, um die Metadaten der Projektoptionen abzurufen:

  • roles/bigquery.jobUser

Weitere Informationen über detaillierte BigQuery-Berechtigungen finden Sie unter Rollen und Berechtigungen.

Schema

Wenn Sie die Ansicht INFORMATION_SCHEMA.PROJECT_OPTIONS abfragen, wird im Ergebnis jede Konfigurationsoption in einem Projekt, die vom Standardwert abweicht, in einer eigenen Zeile dargestellt.

Die Ansicht INFORMATION_SCHEMA.PROJECT_OPTIONS hat das folgende Schema:

Spaltenname Datentyp Wert
option_name STRING Option: ID für die angegebene Konfigurationseinstellung.
project_id STRING Die ID des Projekts
project_number INTEGER Nummer des Projekts.
option_description STRING Die Beschreibung der Option.
option_type STRING Der Datentyp von OPTION_VALUE.
option_value STRING Der aktuelle Wert der Option.
Optionstabelle
option_name option_type option_value
default_time_zone STRING Die Standardzeitzone für dieses Projekt.
default_kms_key_name STRING Der Standardschlüsselname für dieses Projekt.
default_query_job_timeout_ms STRING Das Standardzeitlimit für Abfragen in Millisekunden für dieses Projekt. Dies gilt auch für kontinuierliche Abfragen.
default_interactive_query_queue_timeout_ms STRING Das Standardzeitlimit in Millisekunden für interaktive Abfragen in der Warteschlange für dieses Projekt.
default_batch_query_queue_timeout_ms STRING Das Standardzeitlimit in Millisekunden für Batchabfragen in der Warteschlange für dieses Projekt.
preflight_fluid_autoscaling_reservations STRING Die Liste der Reservierungen, für die die flexible Skalierung für die sekundengenaue Abrechnung ohne Mindestdauer aktiviert ist.
reusable_column_aliases_mode STRING Gibt an, ob wiederverwendbare Spaltenaliase in diesem Projekt aktiviert sind.

Aus Stabilitätsgründen empfehlen wir, Spalten in Ihren Informationsschemaabfragen explizit aufzulisten, anstatt einen Platzhalter (SELECT *) zu verwenden. Wenn Sie Spalten explizit auflisten, wird verhindert, dass Abfragen fehlschlagen, wenn sich das zugrunde liegende Schema ändert.

Datenaufbewahrung

Diese Ansicht enthält derzeit ausgeführte Sitzungen und den Verlauf der Sitzungen, die in den letzten 180 Tagen abgeschlossen wurden.

Bereich und Syntax

Für Abfragen dieser Ansicht muss ein Region-Qualifizierer verwendet werden.

Ansichtsname Ressourcenbereich Regionsbereich
`region-REGION`.INFORMATION_SCHEMA.PROJECT_OPTIONS Konfigurationsoptionen innerhalb des angegebenen Projekts. REGION

Dabei gilt:

Beispiele

Im folgenden Beispiel werden die Spalten OPTION_NAME, OPTION_TYPE und OPTION_VALUE aus der Ansicht INFORMATION_SCHEMA.PROJECT_OPTIONS abgerufen.

SELECT
  option_name, option_type, option_value
FROM
  `region-REGION`.INFORMATION_SCHEMA.PROJECT_OPTIONS;

Das Ergebnis sieht etwa so aus:

  +--------------------------------------------+-------------+---------------------+
  | option_name                                | option_type | option_value        |
  +--------------------------------------------+-------------+---------------------+
  | default_time_zone                          | STRING      | America/Los_Angeles |
  +--------------------------------------------+-------------+---------------------+
  | default_kms_key_name                       | STRING      | test/testkey1       |
  +--------------------------------------------+-------------+---------------------+
  | default_query_job_timeout_ms               | INT64       | 18000000            |
  +--------------------------------------------+-------------+---------------------+
  | default_interactive_query_queue_timeout_ms | INT64       | 600000              |
  +--------------------------------------------+-------------+---------------------+
  | default_batch_query_queue_timeout_ms       | INT64       | 1200000             |
  +--------------------------------------------+-------------+---------------------+