Vue ORGANIZATION_OPTIONS

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

Autorisations requises

Pour obtenir les métadonnées des options d'organisation, 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 d'organisation :

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

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

Nom de la colonne	Type de données	Valeur
`OPTION_NAME`	`STRING`	Une des valeurs de nom figurant dans la table d'options.
`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 cette organisation.
`default_kms_key_name`	`STRING`	Nom de clé par défaut pour cette organisation.
`default_query_job_timeout_ms`	`STRING`	Délai avant expiration par défaut pour les requêtes de cette organisation, 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 de cette organisation, 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 de cette organisation, 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.ORGANIZATION_OPTIONS	Options de configuration au sein de l'organisation spécifiée.	`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 à partir de INFORMATION_SCHEMA.ORGANIZATION_OPTIONS.

SELECT
  option_name, option_type, option_value
FROM
  `region-us`.INFORMATION_SCHEMA.ORGANIZATION_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             |
  +--------------------------------------------+-------------+---------------------+