Obtenir des métadonnées de modèle

Présentation

Cette page explique comment obtenir des informations ou des métadonnées sur des modèles BigQuery ML à l'aide des méthodes suivantes :

• En utilisant la console GCP
• En utilisant la commande bq show de la CLI
• En appelant directement la méthode API models.get ou en utilisant les bibliothèques clientes

Remarque : Il n'est actuellement pas possible d'obtenir des informations sur les modèles en interrogeant les vues INFORMATION_SCHEMA.

Autorisations requises

Pour obtenir des métadonnées de modèle, vous devez disposer du rôle READER sur l'ensemble de données ou d'un rôle IAM au niveau du projet avec des autorisations bigquery.models.getMetadata. Si des autorisations bigquery.models.getMetadata vous sont accordées au niveau du projet, vous pouvez obtenir des métadonnées sur les modèles de n'importe quel ensemble de données du projet. Les rôles IAM prédéfinis ci-dessous au niveau du projet incluent les autorisations bigquery.models.getMetadata :

• bigquery.dataViewer
• bigquery.dataEditor
• bigquery.dataOwner
• bigquery.metadataViewer
• bigquery.admin

Pour en savoir plus sur les rôles et les autorisations IAM dans BigQuery ML, consultez la page Contrôle des accès. Pour en savoir plus sur les rôles au niveau des ensembles de données, consultez la section Rôles primitifs pour les ensembles de données dans la documentation BigQuery.

Obtenir des métadonnées de modèle

Pour obtenir des métadonnées sur des modèles, procédez comme suit :

Console

1. Dans la section Ressources du panneau de navigation, développez votre projet et sélectionnez un ensemble de données.

2. Cliquez sur le nom du modèle.

3. Sous la zone de l'éditeur de requête, cliquez sur Details (Détails). Cette page affiche les métadonnées du modèle, y compris la description, les étiquettes, les détails et les options d'entraînement.

   

CLI

Envoyez la commande bq show avec les indicateurs --model ou -m pour afficher les métadonnées du modèle. L'indicateur --format peut être utilisé pour contrôler le résultat.

Pour n'afficher que les colonnes de caractéristiques de votre modèle, utilisez l'indicateur --schema avec l'indicateur --model. Lorsque vous utilisez l'indicateur --schema, --format doit être défini sur json ou prettyjson.

Si vous voulez obtenir des informations sur un modèle d'un projet autre que votre projet par défaut, ajoutez l'ID de projet à l'ensemble de données au format suivant : [PROJECT_ID]:[DATASET].

bq show --model --format=prettyjson [PROJECT_ID]:[DATASET].[MODEL]

Où :

• [PROJECT_ID] est l'ID de votre projet.
• [DATASET] est le nom de l'ensemble de données.
• [MODEL] est le nom du modèle.

Le résultat de la commande se présente comme suit lorsque l'indicateur --format=pretty est utilisé. Pour voir tous les détails, utilisez le format --format=prettyjson. L'exemple de résultat ci-dessous montre les métadonnées d'un modèle de régression logistique.

+--------------+---------------------+---------------------+---------------------------+--------+-----------------+-----------------+
|      Id      |     Model Type      |   Feature Columns   |       Label Columns       | Labels |  Creation Time  | Expiration Time |
+--------------+---------------------+---------------------+---------------------------+--------+-----------------+-----------------+
| sample_model | LOGISTIC_REGRESSION | |- column1: string  | |- label_column: int64    |        | 03 May 23:14:42 |                 |
|              |                     | |- column2: bool    |                           |        |                 |                 |
|              |                     | |- column3: string  |                           |        |                 |                 |
|              |                     | |- column4: int64   |                           |        |                 |                 |
+--------------+---------------------+---------------------+---------------------------+--------+-----------------+-----------------+

Exemples :

Saisissez la commande suivante pour afficher toutes les informations sur mymodel dans mydataset. mydataset est dans votre projet par défaut.

bq show --model --format=prettyjson mydataset.mymodel

Saisissez la commande suivante pour afficher toutes les informations sur mymodel dans mydataset. mydataset est dans myotherproject, et non dans votre projet par défaut.

bq show --model --format=prettyjson myotherproject:mydataset.mymodel

Saisissez la commande suivante pour afficher uniquement les colonnes de caractéristiques pour mymodel dans mydataset. mydataset est dans myotherproject, et non dans votre projet par défaut.

bq show --model --schema --format=prettyjson \
myotherproject:mydataset.mymodel

API

Pour obtenir des métadonnées de modèle en utilisant l'API, appelez la méthode models.get, et fournissez les projectId, datasetId et modelId.

Étapes suivantes

• Pour obtenir plus d'informations sur BigQuery ML, consultez la page Présentation de BigQuery ML.
• Pour démarrer avec BigQuery ML, consultez la page Premiers pas avec BigQuery ML à l'aide de l'interface utilisateur Web ou Premiers pas avec BigQuery ML à l'aide de Cloud Datalab.
• Pour en savoir plus sur l'utilisation des modèles, consultez les pages suivantes :
  • Répertorier des modèles
  • Mettre à jour les métadonnées de modèle
  • Gérer des modèles
  • Supprimer des modèles