Cette page a été traduite par l'API Cloud Translation.

Vue ROUTINE_OPTIONS

La vue INFORMATION_SCHEMA.ROUTINE_OPTIONS contient une ligne pour chaque option de chaque routine d'un ensemble de données.

Autorisations requises

Pour interroger la vue INFORMATION_SCHEMA.ROUTINE_OPTIONS, vous avez besoin des autorisations IAM (Identity and Access Management) suivantes:

bigquery.routines.get
bigquery.routines.list

Chacun des rôles IAM prédéfinis suivants inclut les autorisations dont vous avez besoin pour obtenir les métadonnées de routine :

roles/bigquery.admin
roles/bigquery.metadataViewer
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.ROUTINE_OPTIONS, les résultats de la requête contiennent une ligne pour chaque option de chaque routine d'un ensemble de données.

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

Nom de la colonne	Type de données	Valeur
`SPECIFIC_CATALOG`	`STRING`	Nom du projet contenant la routine dans laquelle l'option est définie
`SPECIFIC_SCHEMA`	`STRING`	Nom de l'ensemble de données contenant la routine dans laquelle l'option est définie
`SPECIFIC_NAME`	`STRING`	Nom de la routine
`OPTION_NAME`	`STRING`	Une des valeurs de nom figurant dans la table d'options
`OPTION_TYPE`	`STRING`	Une des valeurs de type de données figurant dans la table d'options
`OPTION_VALUE`	`STRING`	Une des options de valeur figurant dans la table d'options

Table d'options

`OPTION_NAME`	`OPTION_TYPE`	`OPTION_VALUE`
`description`	`STRING`	Description de la routine, si elle est définie
`library`	`ARRAY`	Noms des bibliothèques référencées dans la routine. Applicable uniquement aux fonctions JavaScript définies par l'utilisateur
`data_governance_type`	`DataGovernanceType`	Nom du type de gouvernance des données compatible. Par exemple, `DATA_MASKING`.

Champ d'application et syntaxe

Les requêtes exécutées sur cette vue doivent inclure un ensemble de données ou un qualificatif de région. Pour en savoir plus, consultez la section Syntaxe. Le tableau suivant explique la portée des régions et des ressources pour cette vue :

Nom de la vue	Champ d'application de la ressource	Champ d'application de la région
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.ROUTINE_OPTIONS	Niveau Projet	`REGION`
`[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.ROUTINE_OPTIONS`	Niveau de l'ensemble de données	Emplacement d'un ensemble de données

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.
DATASET_ID : ID de votre ensemble de données. Pour en savoir plus, consultez la section Qualificatif d'ensemble de données.

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 routines in a single dataset.
SELECT * FROM myDataset.INFORMATION_SCHEMA.ROUTINE_OPTIONS;

-- Returns metadata for routines in a region.
SELECT * FROM region-us.INFORMATION_SCHEMA.ROUTINE_OPTIONS;

Exemple

Exemple 1 :

L'exemple suivant récupère les options de toutes les routines dans l'ensemble de données mydataset de votre projet par défaut (myproject) en interrogeant la vue INFORMATION_SCHEMA.ROUTINE_OPTIONS :

SELECT
  *
FROM
  mydataset.INFORMATION_SCHEMA.ROUTINE_OPTIONS;

Le résultat ressemble à ce qui suit :

+-------------------+------------------+---------------+----------------------+---------------+------------------+
| specific_catalog  | specific_schema  | specific_name |     option_name      | option_type   | option_value     |
+-------------------+------------------+---------------+----------------------+---------------+------------------+
| myproject         | mydataset        | myroutine1    | description          | STRING        | "a description"  |
| myproject         | mydataset        | myroutine2    | library              | ARRAY<STRING> | ["a.js", "b.js"] |
+-------------------+------------------+---------------+----------------------+---------------+------------------+