Gestione modelli
Questa pagina mostra come gestire i modelli BigQuery ML, inclusa la copia personalizzati e rinominando i modelli.
Rinomina i modelli
Non puoi modificare il nome di un modello esistente. Per cambiare il nome del modello, segui i passaggi per copiarlo. Quando specifica la destinazione nell'operazione di copia, utilizza il nuovo nome del modello.
Copia modelli
Puoi copiare uno o più modelli da un set di dati di origine a un set di dati di destinazione di:
- Utilizzo della console Google Cloud.
- Viene utilizzato il comando
bq cp
dello strumento a riga di comando bq. - Chiamata a jobs.insert Metodo API diretto e configurazione di un job di copia o utilizzando le librerie client.
Limitazioni sulla copia dei modelli
I job di copia del modello sono soggetti alle seguenti limitazioni:
- Quando copi un modello, il nome del modello di destinazione deve rispettare le le stesse convenzioni di denominazione usate per la creazione di un modello.
- Le copie del modello sono soggette a BigQuery limiti relativi ai job di copia.
- La copia di un modello non è supportata dalla console Google Cloud.
- La copia di più modelli di origine in un unico comando non è supportata.
- Quando copi un modello utilizzando l'interfaccia a riga di comando, il flag
--destination_kms_key
viene non supportati.
Copia un modello
Puoi copiare un modello tramite:
- Utilizzo del comando
bq cp
dello strumento a riga di comando - Chiamata a
jobs.insert
Metodo API e configurazione di un job di copia o utilizzando le librerie client
Per copiare un modello:
Console
La console Google Cloud non supporta la copia dei modelli.
bq
Esegui il comando bq cp
. Flag facoltativi:
-f
o--force
sovrascrive un modello esistente nel set di dati di destinazione e non richiede una conferma.-n
o--no_clobber
restituisce il seguente messaggio di errore se il modello esiste nel set di dati di destinazione:'[PROJECT_ID]:[DATASET].[MODEL]' already exists, skipping
.Se
-n
non viene specificato, il comportamento predefinito prevede che ti venga chiesto di scegliere se sostituire il modello di destinazione.
Se il set di dati di origine o di destinazione si trova in un progetto diverso da quello predefinito
aggiungi l'ID progetto ai nomi del set di dati nel seguente formato:
PROJECT_ID:DATASET
.
Fornisci le
--location
e imposta il valore sul tuo
località.
bq --location=LOCATION cp -f -n PROJECT_ID:DATASET.SOURCE_MODEL PROJECT_ID:DATASET.DESTINATION_MODEL
Sostituisci quanto segue:
- LOCATION:
il nome della tua posizione. Il flag
--location
è facoltativo. Ad esempio, se utilizzi BigQuery Regione di Tokyo, puoi impostare il valore del flag suasia-northeast1
. Puoi imposta un valore predefinito per la località utilizzando file.bigqueryrc. Per un elenco completo delle località, vedi Località di BigQuery - PROJECT_ID: ID progetto.
- DATASET: il nome del set di dati di origine o di destinazione.
- SOURCE_MODEL: il modello che stai copiando.
- DESTINATION_MODEL: il nome del modello nel set di dati di destinazione.
Esempi:
Inserisci il seguente comando per copiare mydataset.mymodel
in
mydataset2
.
Entrambi i set di dati si trovano nel progetto predefinito e sono
creato nella località multiregionale US
.
bq --location=US cp mydataset.mymodel mydataset2.mymodel
Inserisci il seguente comando per copiare mydataset.mymodel
e sovrascrivere un
modello di destinazione con lo stesso nome. Il set di dati di origine è quello predefinito
progetto. Il set di dati di destinazione si trova in myotherproject
. La scorciatoia -f
è
utilizzato per sovrascrivere il modello di destinazione senza un prompt.
mydataset
e
myotherdataset
sono stati creati nella località multiregionale US
posizione.
bq --location=US cp -f mydataset.mymodel myotherproject:myotherdataset.mymodel
Inserisci il comando seguente per copiare mydataset.mymodel
e restituire un errore
se il set di dati di destinazione contiene un modello con lo stesso nome. Fonte
il set di dati si trova nel progetto predefinito. Il set di dati di destinazione è in
myotherproject
. La scorciatoia -n
viene utilizzata per impedire la sovrascrittura di un modello con
con lo stesso nome.
Entrambe le cose
I set di dati sono stati creati nella località multiregionale US
.
bq --location=US cp -n mydataset.mymodel myotherproject:myotherdataset.mymodel
Inserisci il comando seguente per copiare mydataset.mymodel
in mydataset2
e
per rinominare il modello mymodel2
. Entrambi i set di dati si trovano nel progetto predefinito.
Entrambi i set di dati sono stati creati nella regione asia-northeast1
.
bq --location=asia-northeast1 cp mydataset.mymodel mydataset2.mymodel2
API
Per copiare un modello utilizzando l'API, chiama il metodo
bigquery.jobs.insert
e configurare un job copy
. Specifica la tua località nel
Proprietà location
nella sezione jobReference
di
risorse di lavoro.
Devi specificare i seguenti valori nella configurazione del job:
"copy": { "sourceTable": { // Required "projectId": string, // Required "datasetId": string, // Required "tableId": string // Required }, "destinationTable": { // Required "projectId": string, // Required "datasetId": string, // Required "tableId": string // Required }, "createDisposition": string, // Optional "writeDisposition": string, // Optional },
Dove:
sourceTable
: fornisce informazioni sul modello da copiare.destinationTable
: fornisce informazioni sul nuovo modello.createDisposition
: specifica se creare il modello nel caso in cui non esista.writeDisposition
: specifica se sovrascrivere un modello esistente.
Crittografia dei modelli
Per ulteriori informazioni sull'utilizzo di una chiave di crittografia gestita dal cliente (CMEK) per crittografare un modello, Utilizza CMEK per proteggere i modelli BigQuery ML.
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: