Questa pagina mostra come eliminare i modelli BigQuery ML. Puoi eliminare un modello:
- Utilizzo di Cloud Console
- Utilizzo del comando
bq rm
dello strumento a riga di comandobq
o del comandobq query
- Chiamata al metodo API
models.delete
o chiamata al metodojobs.query
- Utilizzo delle librerie client
Al momento, puoi eliminare un solo modello alla volta. Quando elimini un modello, vengono eliminati anche tutti i dati che contiene.
Per eliminare automaticamente i modelli dopo un determinato periodo di tempo, imposta la relativa scadenza quando lo crei utilizzando lo strumento a riga di comando bq
, l'API o le librerie client. Se non hai impostato una scadenza al momento della creazione del modello, puoi
aggiornare la data di scadenza del modello.
Limitazioni all'eliminazione dei modelli
L'eliminazione di un modello è soggetta alle seguenti limitazioni:
- Non puoi eliminare più modelli contemporaneamente. Devi eliminarli singolarmente.
- Non puoi ripristinare un modello eliminato.
Autorizzazioni obbligatorie
Per eliminare i modelli in un set di dati, ti deve essere assegnato il ruolo WRITER
nel set di dati oppure devi avere un ruolo IAM a livello di progetto che includa le autorizzazioni bigquery.models.delete
. Se ti vengono concesse le autorizzazioni bigquery.models.delete
a livello di progetto, puoi eliminare i modelli in qualsiasi set di dati del progetto. I seguenti ruoli IAM a livello di progetto includono le autorizzazioni bigquery.models.delete
:
bigquery.dataEditor
bigquery.dataOwner
bigquery.admin
Per ulteriori informazioni sui ruoli IAM e sulle autorizzazioni in BigQuery ML, consulta Controllo dell'accesso. Per ulteriori informazioni sui ruoli a livello di set di dati, consulta Autorizzazioni e ruoli di base nella documentazione di BigQuery.
Eliminazione di un modello
Per eliminare un modello, procedi nel seguente modo:
Console
Puoi eliminare un modello in Cloud Console utilizzando l'opzione Elimina modello
o eseguendo una query che contiene un'istruzione
DROP MODEL | DROP MODEL IF EXISTS
DDL.
Opzione 1: utilizza l'opzione Elimina modello.
In Cloud Console, vai alla pagina BigQuery.
Nella sezione Risorse del pannello di navigazione, espandi il nome del progetto e il nome del set di dati.
Fai clic sul nome del modello. I modelli sono indicati dall'icona del modello:
.
Fai clic su Elimina modello sul lato destro della finestra.
Nella finestra di dialogo Elimina modello, digita il nome del modello e fai clic su Elimina.
Opzione 2: utilizza un'istruzione DDL.
In Cloud Console, vai alla pagina BigQuery.
Fai clic su Crea nuova query.
Digita l'istruzione DDL nell'area di testo Query Editor.
DROP MODEL mydataset.mymodel
Fai clic su Esegui. Una volta completata la query, il modello viene rimosso dal riquadro di navigazione.
bq
Puoi eliminare un modello utilizzando lo strumento a riga di comando bq
inserendo:
- Comando
bq rm
con il flag--model
o-m
bq query
con l'istruzione DDL come parametro di ricerca
Se stai eliminando un modello in un progetto diverso da quello predefinito, aggiungi l'ID progetto al set di dati nel seguente formato:
[PROJECT_ID]:[DATASET].[MODEL]
.
Opzione 1: inserisci il comando bq rm
Quando utilizzi il comando bq rm
per rimuovere un modello, devi confermare l'azione. Puoi utilizzare la scorciatoia --force flag
(o -f
) per ignorare la conferma.
bq rm -f --model [PROJECT_ID]:[DATASET].[MODEL]
Dove:
[PROJECT_ID]
è l'ID progetto.[DATASET]
è il nome del set di dati.[MODEL]
è il nome del modello che stai eliminando.
Il comando rm
non produce alcun output.
Esempi:
Inserisci questo comando per eliminare mymodel
da mydataset
. mydataset
è nel tuo progetto predefinito.
bq rm --model mydataset.mymodel
Inserisci questo comando per eliminare mymodel
da mydataset
. mydataset
si trova in myotherproject
, non è il progetto predefinito.
bq rm --model myotherproject:mydataset.mymodel
Inserisci questo comando per eliminare mymodel
da mydataset
. mydataset
è nel tuo progetto predefinito. Il comando utilizza la scorciatoia -f
per ignorare la conferma.
bq rm -f --model mydataset.mymodel
Puoi confermare che il modello è stato eliminato eseguendo il comando bq ls
.
Per scoprire di più, consulta la sezione Elencare i modelli.
Opzione 2: inserisci il comando bq query
Per eliminare un modello utilizzando il comando bq query
, fornisci l'istruzione DROP MODEL
nel parametro di ricerca e il flag --use_legacy_sql=false
per specificare la sintassi delle query SQL standard.
Esempi:
Inserisci questo comando per eliminare mymodel
da mydataset
. mydataset
è nel tuo progetto predefinito.
bq query --use_legacy_sql=false 'DROP MODEL mydataset.mymodel'
Inserisci questo comando per eliminare mymodel
da mydataset
. mydataset
si trova in myotherproject
, non è il progetto predefinito.
bq query --use_legacy_sql=false \
'DROP MODEL myotherproject:mydataset.mymodel'
API
Opzione 1: chiama il metodo models.delete
Per eliminare un modello, chiama il metodo models.delete
e specifica projectId
, datasetId
e modelId
.
Opzione 2: chiama il metodo jobs.query
Per eliminare un modello, chiama il metodo jobs.query
e fornisci l'istruzione DDL DROP MODEL
nella proprietà query del corpo della richiesta.
Go
Java
Node.js
Python
Ripristino di un modello eliminato
Al momento non puoi ripristinare un modello eliminato.
Passaggi successivi
- Per una panoramica di BigQuery ML, consulta la pagina Introduzione a BigQuery ML.
- Per iniziare a utilizzare BigQuery ML, consulta la guida introduttiva a BigQuery ML con Cloud Console.
- Per scoprire di più sull'utilizzo dei modelli, vedi: