Vue SCHEMATA_OPTIONS

La vue INFORMATION_SCHEMA.SCHEMATA_OPTIONS contient une ligne pour chaque option définie dans chaque ensemble de données d'un projet.

Avant de commencer

Pour interroger la vue SCHEMATA_OPTIONS pour les métadonnées de l'ensemble de données, vous devez disposer de l'autorisation Identity and Access Management (IAM) bigquery.datasets.get au niveau du projet.

Chacun des rôles IAM prédéfinis suivants inclut les autorisations dont vous avez besoin pour obtenir la vue SCHEMATA_OPTIONS :

roles/bigquery.admin
roles/bigquery.dataEditor
roles/bigquery.dataOwner
roles/bigquery.dataViewer

Pour plus d'informations sur les autorisations BigQuery, consultez la page Contrôle des accès avec IAM.

Schéma

Lorsque vous interrogez la vue INFORMATION_SCHEMA.SCHEMATA_OPTIONS, les résultats des requêtes contiennent une ligne pour chaque option définie dans chaque ensemble de données d'un projet.

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

Nom de la colonne	Type de données	Valeur
`CATALOG_NAME`	`STRING`	Nom du projet qui contient l'ensemble de données
`SCHEMA_NAME`	`STRING`	Nom de l'ensemble de données, également appelé `datasetId`.
`OPTION_NAME`	`STRING`	Nom de l'option. Pour obtenir la liste des options acceptées, consultez la liste des options de schéma.
`OPTION_TYPE`	`STRING`	Type de données de l'option.
`OPTION_VALUE`	`STRING`	Valeur de l'option.

Champ d'application et syntaxe

Les requêtes exécutées sur cette vue doivent inclure un qualificatif de région. Si vous ne spécifiez pas de qualificatif de région, les métadonnées sont extraites de la région US Le tableau suivant explique le champ d'application de la région pour cette vue :

Nom de la vue	Champ d'application de la ressource	Champ d'application de la région
`[PROJECT_ID.]INFORMATION_SCHEMA.SCHEMATA_OPTIONS`	Niveau Projet	Région US
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA_OPTIONS	Niveau Projet	`REGION`

Remplacez les éléments suivants :

Facultatif : PROJECT_ID : ID de votre projet Google Cloud. Si non spécifié, le projet par défaut est utilisé.
REGION : tout nom de région d'ensemble de données. Exemple :region-us

Remarque : Vous devez utiliser un qualificatif de région pour interroger les vues INFORMATION_SCHEMA. L'emplacement d'exécution de la requête doit correspondre à la région de la vue INFORMATION_SCHEMA.

Exemple

-- Returns metadata for datasets in a region.
SELECT * FROM region-us.INFORMATION_SCHEMA.SCHEMATA_OPTIONS;

Examples

Récupérer le délai d'expiration de table par défaut pour tous les ensembles de données de votre projet

Pour exécuter la requête sur un projet autre que celui par défaut, ajoutez l'ID du projet au nom de l'ensemble de données, en respectant le format suivant :

`PROJECT_ID`.INFORMATION_SCHEMA.SCHEMATA_OPTIONS

Par exemple : `myproject`.INFORMATION_SCHEMA.SCHEMATA_OPTIONS.

SELECT
  *
FROM
  INFORMATION_SCHEMA.SCHEMATA_OPTIONS
WHERE
  option_name = 'default_table_expiration_days';

Le résultat ressemble à ce qui suit :

  +----------------+---------------+-------------------------------+-------------+---------------------+
  |  catalog_name  |  schema_name  |          option_name          | option_type |    option_value     |
  +----------------+---------------+-------------------------------+-------------+---------------------+
  | myproject      | mydataset3    | default_table_expiration_days | FLOAT64     | 0.08333333333333333 |
  | myproject      | mydataset2    | default_table_expiration_days | FLOAT64     | 90.0                |
  | myproject      | mydataset1    | default_table_expiration_days | FLOAT64     | 30.0                |
  +----------------+---------------+-------------------------------+-------------+---------------------+

Récupérer les libellés de tous les ensembles de données de votre projet

Pour exécuter la requête sur un projet autre que celui par défaut, ajoutez l'ID du projet à l'ensemble de données, en respectant le format suivant :

`PROJECT_ID`.INFORMATION_SCHEMA.SCHEMATA_OPTIONS

. Par exemple : `myproject`.INFORMATION_SCHEMA.SCHEMATA_OPTIONS.

SELECT
  *
FROM
  INFORMATION_SCHEMA.SCHEMATA_OPTIONS
WHERE
  option_name = 'labels';

Le résultat ressemble à ce qui suit :

  +----------------+---------------+-------------+---------------------------------+------------------------+
  |  catalog_name  |  schema_name  | option_name |          option_type            |      option_value      |
  +----------------+---------------+-------------+---------------------------------+------------------------+
  | myproject      | mydataset1    | labels      | ARRAY<STRUCT<STRING, STRING>>   | [STRUCT("org", "dev")] |
  | myproject      | mydataset2    | labels      | ARRAY<STRUCT<STRING, STRING>>   | [STRUCT("org", "dev")] |
  +----------------+---------------+-------------+---------------------------------+------------------------+