Ansicht EFFECTIVE_PROJECT_OPTIONS

Sie können die INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS-Ansicht abfragen, um Echtzeit-Metadaten zu den effektiven Projektoptionen von BigQuery abzurufen. Diese Ansicht enthält Standardeinstellungen auf Organisations- oder Projektebene.

Erforderliche Berechtigungen

Zum Abrufen effektiver Metadaten der Projektoptionen benötigen Sie die IAM-Berechtigung bigquery.config.get (Identity and Access Management).

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

roles/bigquery.jobUser

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

Schema

Wenn Sie die INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS-Ansicht abfragen, wird im Ergebnis jede Konfiguration in einem Projekt in einer eigenen Zeile dargestellt.

Die Ansicht INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS hat das folgende Schema:

Spaltenname	Datentyp	Wert
`OPTION_NAME`	`STRING`	Option: ID für die angegebene Konfigurationseinstellung.
`OPTION_DESCRIPTION`	`STRING`	Die Beschreibung der Option.
`OPTION_TYPE`	`STRING`	Der Datentyp von `OPTION_VALUE`.
`OPTION_SET_LEVEL`	`STRING`	Die Ebene in der Hierarchie, auf der die Einstellung definiert ist, mit den möglichen Werten: `DEFAULT`, `ORGANIZATION` oder `PROJECTS`.
`OPTION_SET_ON_ID`	`STRING`	Legen Sie den Wert anhand des Werts von `OPTION_SET_LEVEL` fest: Bei `DEFAULT` auf `null`. Bei `ORGANIZATION` auf `""`. Bei `PROJECT` auf `ID`.
`OPTION_VALUE`	`STRING`	Der aktuelle Wert der Option.

Optionstabelle

`OPTION_NAME`	`OPTION_TYPE`	`OPTION_VALUE`
`default_time_zone`	`STRING`	Die effektive Standardzeitzone für dieses Projekt.
`default_kms_key_name`	`STRING`	Der effektive Standardschlüsselname für dieses Projekt.
`default_query_job_timeout_ms`	`INT64`	Das effektive Standardabfragezeitlimit in Millisekunden für dieses Projekt.
`default_interactive_query_queue_timeout_ms`	`STRING`	Das effektive Standardzeitlimit in Millisekunden für interaktive Abfragen in der Warteschlange für dieses Projekt.
`default_batch_query_queue_timeout_ms`	`STRING`	Das effektive Standardzeitlimit in Millisekunden für Batchabfragen in der Warteschlange für dieses Projekt.

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.EFFECTIVE_PROJECT_OPTIONS	Konfigurationsoptionen innerhalb des angegebenen Projekts.	`REGION`

Dabei gilt:

REGION: ist ein beliebiger Dataset-Regionsname. Beispiel: region-us

Beispiele

Im folgenden Beispiel werden die Spalten OPTION_NAME, OPTION_TYPE, OPTION_VALUE, OPTION_SET_LEVEL und OPTION_SET_ON_ID aus der INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS-Ansicht abgerufen.

SELECT
  option_name, option_type, option_value, option_set_level, option_set_on_id
FROM
  `region-REGION`.INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS;

Das Ergebnis sieht etwa so aus:

  +--------------------------------------------+-------------+---------------------+------------------+--------------------+
  | option_name                                | option_type | option_value        | option_set_level | option_set_on_id   |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+
  | default_time_zone                          | STRING      | America/Los_Angeles | organizations    | my_organization_id |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+
  | default_kms_key_name                       | STRING      | test/testkey1       | projects         | my_project_id      |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+
  | default_query_job_timeout_ms               | INT64       | 18000000            | projects         | my_project_id      |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+
  | default_interactive_query_queue_timeout_ms | INT64       | 600000              | organization     | my_organization_id |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+
  | default_batch_query_queue_timeout_ms       | INT64       | 1200000             | projects         | my_project_id      |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+