Cette page explique comment supprimer des modèles BigQuery ML à l'aide des méthodes suivantes :
- En utilisant la console GCP
- En utilisant la commande
bq rmoubq queryde l'outil de ligne de commande - En appelant la méthode API
models.deleteoujobs.query - En utilisant 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 la CLI, de l'API ou des bibliothèques clientes. Si vous n'avez pas défini la date d'expiration lors de la création du modèle, vous pouvez la 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. Les modèles doivent être supprimés individuellement.
- La suppression d'un modèle ne peut pas être annulée.
Autorisations requises
Pour supprimer des modèles dans un ensemble de données, vous devez disposer du rôle WRITER sur l'ensemble de données ou d'un rôle IAM au niveau du projet avec des autorisations bigquery.models.delete. Si des autorisations bigquery.models.delete vous sont accordées au niveau du projet, vous pouvez supprimer des modèles de n'importe quel ensemble de données du projet. Les rôles IAM au niveau du projet ci-dessous incluent les autorisations bigquery.models.delete :
bigquery.dataEditorbigquery.dataOwnerbigquery.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.
Supprimer un modèle
Pour supprimer un modèle, procédez comme suit :
Console
Vous pouvez supprimer un modèle dans l'interface utilisateur Web de BigQuery à l'aide de l'option Supprimer le 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.
Accédez à l'interface utilisateur Web de BigQuery dans la console GCP.
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.
Accédez à l'UI Web de BigQuery.
Cliquez sur Saisir une requête.
Saisissez votre instruction DDL dans la zone de texte Nouvelle requête.
DROP MODEL mydataset.mymodel
Cliquez sur Exécuter la requête. Une fois la requête terminée, le modèle est supprimé du volet de navigation.
CLI
Vous pouvez supprimer un modèle à l'aide de l'outil de ligne de commande bq en saisissant les éléments suivants :
- Commande
bq rmavec les indicateurs--modelou-m. - Commande
bq queryavec l'instruction LDD en tant que paramètre de requête
Si vous supprimez un modèle dans 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].[MODEL].
Option 1 : saisissez la commande bq rm.
Lorsque vous utilisez la commande bq rm pour supprimer un modèle, vous devez confirmer cette action. L'indicateur --force (ou le raccourci -f) vous permet d'ignorer cette étape.
bq rm -f --model [PROJECT_ID]:[DATASET].[MODEL]
Où :
[PROJECT_ID]correspond à 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 ne produit aucun résultat.
Exemples :
Saisissez la commande suivante pour supprimer mymodel de mydataset. mydataset est dans votre projet par défaut.
bq rm --model mydataset.mymodel
Saisissez la commande suivante pour supprimer mymodel de mydataset. mydataset est 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 est dans votre projet par défaut. La commande se sert du raccourci -f pour contourner la confirmation.
bq rm -f --model mydataset.mymodel
Vous pouvez confirmer que le modèle a été supprimé en exécutant la commande bq ls.
Pour en savoir plus, reportez-vous à la page Répertorier des modèles.
Option 2 : saisissez la commande bq query.
Pour supprimer un modèle à l'aide de la commande bq query, indiquez l'instruction DROP MODEL dans le paramètre de requête et ajoutez l'indicateur --use_legacy_sql=false pour spécifier la syntaxe de requête en SQL standard.
Exemples :
Saisissez la commande suivante pour supprimer mymodel de mydataset. mydataset est 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 est dans myotherproject, et non dans votre projet par défaut.
bq query --use_legacy_sql=false \
'DROP MODEL myotherproject:mydataset.mymodel'
API
Option 1 : appelez la méthode models.delete.
Pour supprimer un modèle, appelez la méthode models.delete, et fournissez les projectId, datasetId, et modelId.
Option 2 : appelez la méthode jobs.query.
Pour supprimer un modèle, appelez la méthode jobs.query, et fournissez l'instruction LDD DROP MODEL dans la propriété requête du corps de la requête.
Restaurer un modèle supprimé
Actuellement, il n'est pas possible de restaurer un modèle supprimé.
É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 :
