Eliminazione modelli
Questa pagina mostra come eliminare i modelli BigQuery ML. Puoi eliminare un modello di:
- Utilizzo della console Google Cloud
- Utilizzo del comando
bq rm
obq query
dello strumento a riga di comando bq - Chiamata a
models.delete
o chiamando il metodo Metodojobs.query
- Utilizzo delle librerie client
Al momento puoi eliminare un solo modello alla volta. Quando elimini un modello, vengono eliminati anche i dati del modello.
Per eliminare automaticamente i modelli dopo un determinato periodo di tempo, imposta il valore e scadenza quando lo crei usando lo strumento a riga di comando bq, l'API o il client librerie. Se non hai impostato la scadenza al momento della creazione del modello, puoi aggiornare la data e l'ora 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 eliminarle singolarmente.
- Non puoi ripristinare un modello eliminato.
Autorizzazioni obbligatorie
Per eliminare i modelli in un set di dati, ti deve essere assegnato il
WRITER
nel set di dati oppure ti deve essere assegnato un ruolo Identity and Access Management (IAM) a livello di progetto che
include le autorizzazioni bigquery.models.delete
. Se ti viene concesso
bigquery.models.delete
autorizzazioni a livello di progetto, puoi eliminare i modelli
in qualsiasi set di dati nel progetto. I seguenti ruoli IAM a livello di progetto
includi bigquery.models.delete
autorizzazioni:
bigquery.dataEditor
bigquery.dataOwner
bigquery.admin
Per saperne di più su ruoli e autorizzazioni IAM in BigQuery ML, consulta Controllo dell'accesso.
Eliminazione di un modello
Per eliminare un modello:
Console
Puoi eliminare un modello nella console Google Cloud utilizzando l'opzione Elimina modello.
oppure eseguendo una query contenente
DROP MODEL | DROP MODEL IF EXISTS
l'istruzione DDL.
Opzione uno: utilizza l'opzione Elimina modello.
Nella console Google Cloud, vai alla pagina BigQuery.
Nel pannello di navigazione, nella sezione Risorse, espandi le il nome del progetto e quello del set di dati.
Fai clic sul nome del modello. I modelli sono indicato 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 due: utilizza un'istruzione DDL.
Nella console Google Cloud, vai alla pagina BigQuery.
Fai clic su Crea nuova query.
Digita l'istruzione DDL nell'area di testo Editor di query.
DROP MODEL mydataset.mymodel
Fai clic su Esegui. Al termine della query, il modello viene rimosso nel 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
- Comando
bq query
con l'istruzione DDL come parametro di query
Se elimini 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 uno: inserisci il comando bq rm
Quando utilizzi il comando bq rm
per rimuovere un modello, devi confermare il valore
un'azione. Puoi usare --force flag
(o la scorciatoia -f
) per saltare 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 il seguente comando per eliminare mymodel
da mydataset
. mydataset
è incluso nel progetto predefinito.
bq rm --model mydataset.mymodel
Inserisci il seguente comando per eliminare mymodel
da mydataset
. mydataset
si trova in myotherproject
, non nel tuo progetto predefinito.
bq rm --model myotherproject:mydataset.mymodel
Inserisci il seguente comando per eliminare mymodel
da mydataset
. mydataset
è incluso nel progetto predefinito. Il comando usa la scorciatoia -f
per bypassare
conferma.
bq rm -f --model mydataset.mymodel
Puoi confermare che il modello è stato eliminato inviando il comando bq ls
.
Per maggiori informazioni, consulta Elenco dei modelli.
Opzione due: inserisci il comando bq query
Per eliminare un modello utilizzando il comando bq query
, fornisci il valore DROP MODEL
nel parametro di query e fornisci l'istruzione --use_legacy_sql=false
per specificare la sintassi delle query GoogleSQL.
Esempi:
Inserisci il seguente comando per eliminare mymodel
da mydataset
. mydataset
è incluso nel progetto predefinito.
bq query --use_legacy_sql=false 'DROP MODEL mydataset.mymodel'
Inserisci il seguente comando per eliminare mymodel
da mydataset
. mydataset
si trova in myotherproject
, non nel tuo progetto predefinito.
bq query --use_legacy_sql=false \
'DROP MODEL myotherproject:mydataset.mymodel'
API
Opzione uno: chiama il metodo models.delete
Per eliminare un modello, chiama models.delete
e fornire i projectId
, datasetId
e modelId
.
Opzione due: chiama il metodo jobs.query
Per eliminare un modello, chiama jobs.query
e fornisci l'istruzione DDL DROP MODEL
nel corpo della richiesta
query.
Vai
Prima di provare questo esempio, segui le istruzioni per la configurazione di Go nel Guida rapida di BigQuery con librerie client. Per ulteriori informazioni, consulta API Go BigQuery documentazione di riferimento.
Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per le librerie client.
Java
Prima di provare questo esempio, segui le istruzioni per la configurazione di Java nel Guida rapida di BigQuery con librerie client. Per ulteriori informazioni, consulta API Java BigQuery documentazione di riferimento.
Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per le librerie client.
Node.js
Prima di provare questo esempio, segui le istruzioni per la configurazione di Node.js nel Guida rapida di BigQuery con librerie client. Per ulteriori informazioni, consulta API Node.js BigQuery documentazione di riferimento.
Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per le librerie client.
Python
Prima di provare questo esempio, segui le istruzioni per la configurazione di Python nel Guida rapida di BigQuery con librerie client. Per ulteriori informazioni, consulta API Python BigQuery documentazione di riferimento.
Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per le librerie client.
Ripristinare un modello eliminato
Al momento, non puoi ripristinare un modello eliminato.
Passaggi successivi
- Per una panoramica di BigQuery ML, consulta Introduzione a BigQuery ML.
- Per iniziare a utilizzare BigQuery ML, consulta Creare modelli di machine learning in BigQuery ML.
- Per scoprire di più sull'utilizzo dei modelli, consulta: