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 Konfigurationsoptionen, die auf Organisations- oder Projektebene festgelegt sind. Wenn dieselbe Konfigurationsoption sowohl auf Organisations- als auch auf Projektebene festgelegt ist, wird der Konfigurationswert des Projekts angezeigt. Die Standardwerte für eine Konfigurationsoption finden Sie in den Konfigurationseinstellungen.
Erforderliche Berechtigungen
Zum Abrufen der Metadaten der gültigen Projektoptionen benötigen Sie die IAM-Berechtigung (Identity and Access Management) bigquery.config.get
.
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 basierend auf dem Wert von OPTION_SET_LEVEL fest:
|
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 Standardzeitlimit für Abfragen 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. |
enable_reservation_based_fairness |
BOOL |
Verwenden Sie die reservierungsbasierte Fairness anstelle der projektbasierten Fairness. |
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 | +--------------------------------------------+-------------+---------------------+------------------+--------------------+