Supprimer des modèles
Cette page explique comment supprimer des modèles BigQuery ML à l'aide des méthodes suivantes :
- En utilisant la console Google Cloud
- En utilisant la commande
bq rm
ou la commandebq query
de l'outil de ligne de commande bq - En appelant la méthode
models.delete
de l'API ou la méthodejobs.query
- Utiliser les bibliothèques clientes
Actuellement, vous ne pouvez supprimer qu'un modèle à la fois. Lorsque vous supprimez un modèle, toutes ses données sont également supprimées.
Pour supprimer automatiquement les modèles après une période spécifiée, définissez la date d'expiration du modèle lorsque vous le créez à l'aide de l'outil de ligne de commande bq, de l'API ou des bibliothèques clientes. Si vous n'avez pas défini de délai d'expiration lors de la création du modèle, vous pouvez le mettre à jour.
Limites applicables à la suppression de modèles
La suppression d'un modèle est soumise aux limites suivantes :
- Vous ne pouvez pas supprimer plusieurs modèles en même temps. Vous devez les supprimer un par un.
- Vous ne pouvez pas restaurer un modèle supprimé.
Autorisations requises
Pour supprimer des modèles dans un ensemble de données, vous devez disposer du rôle WRITER
au niveau de l'ensemble de données, ou d'un rôle Identity and Access Management (IAM) au niveau du projet incluant les autorisations bigquery.models.delete
. Si vous disposez des autorisations bigquery.models.delete
au niveau du projet, vous pouvez supprimer des modèles dans n'importe quel ensemble de données du projet. Les rôles IAM suivants au niveau du projet comprennent les autorisations bigquery.models.delete
:
bigquery.dataEditor
bigquery.dataOwner
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.
Supprimer un modèle
Pour supprimer un modèle, procédez comme suit :
Console
Vous pouvez supprimer un modèle dans la console Google Cloud à l'aide de l'option Supprimer un modèle ou en exécutant une requête contenant une instruction LDD DROP MODEL | DROP MODEL IF EXISTS
.
Option 1 : utilisez l'option Supprimer le modèle.
Dans Google Cloud Console, accédez à la page "BigQuery".
Dans le panneau de navigation, dans la section Ressources, développez le nom de votre projet et celui de l'ensemble de données.
Cliquez sur le nom de votre modèle. Les modèles sont indiqués par l'icône .
Sur le côté droit de la fenêtre, cliquez sur Supprimer le modèle.
Dans la boîte de dialogue Supprimer le modèle, saisissez le nom du modèle, puis cliquez sur Supprimer.
Option 2 : utilisez une instruction LDD.
Dans Google Cloud Console, accédez à la page "BigQuery".
Cliquez sur Saisir une nouvelle requête.
Saisissez votre instruction LDD dans la zone de texte de l'éditeur de requête.
DROP MODEL mydataset.mymodel
Cliquez sur Run (Exécuter). Une fois la requête terminée, le modèle est supprimé du volet de navigation.
bq
Vous pouvez supprimer un modèle à l'aide de l'outil de ligne de commande bq en saisissant les éléments suivants :
- la commande
bq rm
avec l'option--model
ou-m
; - la commande
bq query
avec l'instruction LDD comme paramètre de requête.
Si vous supprimez un modèle dans un projet autre que votre projet par défaut, ajoutez l'ID du projet au nom de l'ensemble de données en respectant le format suivant : [PROJECT_ID]:[DATASET].[MODEL]
.
Option 1 : saisir la commande bq rm
Lorsque vous utilisez la commande bq rm
pour supprimer un modèle, vous devez confirmer l'action. Vous pouvez utiliser l'option --force flag
(ou le raccourci -f
) pour ignorer la confirmation.
bq rm -f --model [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 que vous supprimez.
La commande rm
n'affiche aucun résultat.
Exemples :
Saisissez la commande suivante pour supprimer mymodel
de mydataset
. mydataset
se trouve dans votre projet par défaut.
bq rm --model mydataset.mymodel
Saisissez la commande suivante pour supprimer mymodel
de mydataset
. mydataset
se trouve dans myotherproject
, et non dans votre projet par défaut.
bq rm --model myotherproject:mydataset.mymodel
Saisissez la commande suivante pour supprimer mymodel
de mydataset
. mydataset
se trouve dans votre projet par défaut. La commande utilise le raccourci -f
pour contourner la confirmation.
bq rm -f --model mydataset.mymodel
Vous pouvez confirmer la suppression du modèle à l'aide de la commande bq ls
.
Pour en savoir plus, consultez la section Répertorier les modèles.
Option 2 : saisir la commande bq query
Pour supprimer un modèle à l'aide de la commande bq query
, spécifiez l'instruction DROP MODEL
dans le paramètre de requête, ainsi que l'option --use_legacy_sql=false
pour spécifier la syntaxe de requête GoogleSQL.
Exemples :
Saisissez la commande suivante pour supprimer mymodel
de mydataset
. mydataset
se trouve dans votre projet par défaut.
bq query --use_legacy_sql=false 'DROP MODEL mydataset.mymodel'
Saisissez la commande suivante pour supprimer mymodel
de mydataset
. mydataset
se trouve dans myotherproject
, et non dans votre projet par défaut.
bq query --use_legacy_sql=false \
'DROP MODEL myotherproject:mydataset.mymodel'
API
Option 1 : appeler la méthode models.delete
Pour supprimer un modèle, appelez la méthode models.delete
et spécifiez les paramètres projectId
, datasetId
et modelId
.
Option 2 : appeler la méthode jobs.query
Pour supprimer un modèle, appelez la méthode jobs.query
et spécifiez l'instruction LDD DROP MODEL
dans la propriété query du corps de la requête.
Go
Avant d'essayer cet exemple, suivez les instructions de configuration pour Go du guide de démarrage rapide de BigQuery : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API BigQuery pour Go.
Pour vous authentifier auprès de BigQuery, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez la page Configurer l'authentification pour les bibliothèques clientes.
Java
Avant d'essayer cet exemple, suivez les instructions de configuration pour Java du guide de démarrage rapide de BigQuery : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API BigQuery pour Java.
Pour vous authentifier auprès de BigQuery, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez la page Configurer l'authentification pour les bibliothèques clientes.
Node.js
Avant d'essayer cet exemple, suivez les instructions de configuration pour Node.js du guide de démarrage rapide de BigQuery : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API BigQuery pour Node.js.
Pour vous authentifier auprès de BigQuery, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez la page Configurer l'authentification pour les bibliothèques clientes.
Python
Avant d'essayer cet exemple, suivez les instructions de configuration pour Python du guide de démarrage rapide de BigQuery : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API BigQuery pour Python.
Pour vous authentifier auprès de BigQuery, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez la page Configurer l'authentification pour les bibliothèques clientes.
Restaurer un modèle supprimé
Actuellement, vous ne pouvez pas restaurer de modèle supprimé.
Étapes suivantes
- Pour obtenir plus d'informations sur BigQuery ML, consultez la page Présentation de BigQuery ML.
- Consultez la page Créer des modèles de machine learning dans BigQuery ML pour faire vos premiers pas avec BigQuery ML.
- Pour en savoir plus sur l'utilisation des modèles, consultez les pages suivantes :