Vue PROJECT_OPTIONS

Vous pouvez récupérer les métadonnées en temps réel des options de projet BigQuery en interrogeant la vue INFORMATION_SCHEMA.PROJECT_OPTIONS. Cette vue contient les paramètres par défaut au niveau du projet.

Autorisations requises

Pour obtenir les métadonnées des options de projet, vous avez besoin des autorisations IAM (Identity and Access Management) suivantes :

bigquery.config.get

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

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.PROJECT_OPTIONS, les résultats de la requête contiennent une ligne pour chaque configuration d'un projet.

La vue INFORMATION_SCHEMA.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_VALUE`	`STRING`	Valeur actuelle de l'option.

Table d'options

`OPTION_NAME`	`OPTION_TYPE`	`OPTION_VALUE`
`default_time_zone`	`STRING`	Fuseau horaire 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`	`STRING`	Délai avant expiration par défaut pour les requêtes de ce projet, en millisecondes.
`default_interactive_query_queue_timeout_ms`	`STRING`	Délai avant expiration par défaut pour les requêtes interactives en file d'attente pour ce projet, en millisecondes.
`default_batch_query_queue_timeout_ms`	`STRING`	Délai avant expiration par défaut pour les requêtes par lot en file d'attente pour 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.PROJECT_OPTIONS	Options de configuration dans le projet spécifié.	`REGION`

Remplacez les éléments suivants :

REGION : tout nom de région d'ensemble de données. Exemple : region-us.

Exemples

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

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

Le résultat ressemble à ce qui suit :

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