Recupero metadati modello
Questa pagina mostra come ottenere informazioni o metadati sui modelli BigQuery ML. Per recuperare i metadati del modello:
- Utilizzo della Google Cloud console
- Utilizzo del comando
bq show
CLI - Chiamare il metodo dell'API
models.get
direttamente o utilizzando le librerie client
Autorizzazioni obbligatorie
Per ottenere i metadati del modello, devi disporre del ruolo
READER
nel set di dati oppure devi disporre di un ruolo IAM (Identity and Access Management) a livello di progetto che include le autorizzazioni bigquery.models.getMetadata
. Se ti sono state concesse autorizzazioni bigquery.models.getMetadata
a livello di progetto, puoi recuperare i metadati dei modelli in qualsiasi set di dati del progetto. I seguenti ruoli IAM predefiniti a livello di progetto includono le autorizzazioni bigquery.models.getMetadata
:
bigquery.dataViewer
bigquery.dataEditor
bigquery.dataOwner
bigquery.metadataViewer
bigquery.admin
Per ulteriori informazioni su ruoli e autorizzazioni IAM in BigQuery ML, consulta Controllo dell'accesso.
Recupero metadati modello
Per recuperare i metadati dei modelli:
Console
Nel riquadro Explorer, espandi il progetto e poi un set di dati.
Espandi la cartella Modelli nel set di dati, quindi fai clic sul nome di un modello per selezionarlo.
Fai clic sulla scheda Dettagli. Questa scheda mostra i metadati del modello, tra cui descrizione, etichette, tipo di modello e opzioni di addestramento.
bq
Esegui il comando bq show
con il flag --model
o -m
per visualizzare
i metadati del modello. Il flag --format
può essere utilizzato per controllare l'output.
Per visualizzare solo le colonne di caratteristiche del modello, utilizza il flag --schema
con il flag --model
. Quando utilizzi il flag --schema
, --format
deve essere impostato su json
o prettyjson
.
Se ricevi informazioni su un modello in un progetto diverso da quello predefinito, aggiungi l'ID progetto al set di dati nel seguente formato: [PROJECT_ID]:[DATASET]
.
bq show --model --format=prettyjson PROJECT_ID:DATASET.MODEL
Sostituisci quanto segue:
PROJECT_ID
è l'ID progetto.DATASET
è il nome del set di dati.MODEL
è il nome del modello.
L'output del comando è simile al seguente quando viene utilizzato il flag --format=pretty
. Per visualizzare tutti i dettagli, utilizza il formato --format=prettyjson
. L'output di esempio mostra i metadati di un modello di regressione logistica.
+--------------+---------------------+---------------------+---------------------------+--------+-----------------+-----------------+ | Id | Model Type | Feature Columns | Label Columns | Labels | Creation Time | Expiration Time | +--------------+---------------------+---------------------+---------------------------+--------+-----------------+-----------------+ | sample_model | LOGISTIC_REGRESSION | |- column1: string | |- label_column: int64 | | 03 May 23:14:42 | | | | | |- column2: bool | | | | | | | | |- column3: string | | | | | | | | |- column4: int64 | | | | | +--------------+---------------------+---------------------+---------------------------+--------+-----------------+-----------------+
Esempi:
Inserisci il seguente comando per visualizzare tutte le informazioni su mymodel
in
mydataset
. mydataset
si trova nel tuo progetto predefinito.
bq show --model --format=prettyjson mydataset.mymodel
Inserisci il seguente comando per visualizzare tutte le informazioni su mymodel
in
mydataset
. mydataset
si trova in myotherproject
, non nel progetto predefinito.
bq show --model --format=prettyjson myotherproject:mydataset.mymodel
Inserisci il comando seguente per visualizzare solo le colonne delle funzionalità per
mymodel
in mydataset
. mydataset
si trova in myotherproject
, non nel
tuo progetto predefinito.
bq show --model --schema --format=prettyjson \
myotherproject:mydataset.mymodel
API
Per ottenere i metadati del modello utilizzando l'API, chiama il metodo models.get
e fornisci projectId
, datasetId
e modelId
.
Vai
Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella guida rapida di BigQuery relativa all'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API BigQuery Go.
Per effettuare l'autenticazione in BigQuery, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per le librerie client.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida di BigQuery relativa all'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API BigQuery Java.
Per effettuare l'autenticazione in BigQuery, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per le librerie client.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida di BigQuery relativa all'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API BigQuery Node.js.
Per effettuare l'autenticazione in BigQuery, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per le librerie client.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida di BigQuery relativa all'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API BigQuery Python.
Per effettuare l'autenticazione in BigQuery, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per le librerie client.
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ù su come utilizzare i modelli, consulta: