Vue EFFECTIVE_PROJECT_OPTIONS

Vous pouvez récupérer les métadonnées en temps réel des options de projet effectives BigQuery dans la vue INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS. Cette vue contient les paramètres par défaut au niveau de l'organisation ou du projet.

Autorisations requises

Pour obtenir les métadonnées d'options de projet effectives, vous devez disposer de l'autorisation IAM (Identity and Access Management) bigquery.config.get.

Le rôle IAM prédéfini suivant inclut les autorisations dont vous avez besoin pour obtenir des métadonnées d'options de projet effectives :

  • roles/bigquery.jobUser

Pour plus d'informations sur les autorisations BigQuery précises, consultez la section Rôles et autorisations.

Schéma

Lorsque vous interrogez la vue INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS, les résultats de la requête contiennent une ligne pour chaque configuration d'un projet.

La vue INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS présente le schéma suivant :

Nom de la colonne Type de données Valeur
OPTION_NAME STRING ID d'option pour le paramètre de configuration spécifié
OPTION_DESCRIPTION STRING Description de l'option.
OPTION_TYPE STRING Type de données de OPTION_VALUE.
OPTION_SET_LEVEL STRING Niveau de la hiérarchie auquel le paramètre est défini, avec les valeurs possibles DEFAULT, ORGANIZATION ou PROJECTS
OPTION_SET_ON_ID STRING Définissez la valeur en fonction de la valeur de OPTION_SET_LEVEL :
  • Si la valeur est DEFAULT, la valeur est définie sur null.
  • Si la valeur est ORGANIZATION, la valeur est définie sur "".
  • Si la valeur est PROJECT, la valeur est définie sur ID.
OPTION_VALUE STRING Valeur actuelle de l'option.
Table d'options
OPTION_NAME OPTION_TYPE OPTION_VALUE
default_time_zone STRING Fuseau horaire effectif par défaut pour ce projet
default_kms_key_name STRING Nom de clé effectif par défaut pour ce projet
default_query_job_timeout_ms INT64 Délai avant expiration effectif par défaut pour les requêtes de ce projet, en millisecondes.
default_interactive_query_queue_timeout_ms STRING Délai avant expiration effectif par défaut pour les requêtes interactives en file d'attente dans ce projet, en millisecondes.
default_batch_query_queue_timeout_ms STRING Délai avant expiration effectif par défaut pour les requêtes par lot en file d'attente dans ce projet, en millisecondes.

Conservation des données

Cette vue contient les sessions en cours d'exécution et l'historique des sessions terminées au cours des 180 derniers jours.

Champ d'application et syntaxe

Les requêtes exécutées sur cette vue doivent inclure un qualificatif de région.

Nom de la vue Champ d'application de la ressource Champ d'application de la région
`region-REGION`.INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS Options de configuration dans le projet spécifié. REGION

Remplacez les éléments suivants :

Exemples

L'exemple suivant récupère les colonnes OPTION_NAME, OPTION_TYPE, OPTION_VALUE, OPTION_SET_LEVEL et OPTION_SET_ON_ID de la vue INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS.

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

Le résultat ressemble à ce qui suit :

  +--------------------------------------------+-------------+---------------------+------------------+--------------------+
  | 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      |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+