Elenco modelli
Questa pagina mostra come elencare i modelli BigQuery ML in un set di dati. Puoi elencare i modelli BigQuery ML:
- Utilizzando la console Google Cloud.
- Utilizzo del comando
bq ls
nello strumento a riga di comando bq. - Chiamando il metodo dell'API
models.list
direttamente o utilizzando le librerie client.
Autorizzazioni obbligatorie
Per elencare i modelli in un set di dati, devi disporre del ruolo READER
per il set di dati oppure devi disporre di un ruolo IAM (Identity and Access Management) a livello di progetto che includa le autorizzazioni bigquery.models.list
. Se ti sono state concesse le autorizzazionibigquery.models.list
a livello di progetto, puoi elencare i modelli in qualsiasi set di dati del progetto. I seguenti ruoli IAM predefiniti a livello di progetto includono le autorizzazioni bigquery.models.list
:
bigquery.dataViewer
bigquery.dataEditor
bigquery.dataOwner
bigquery.metadataViewer
bigquery.user
bigquery.admin
Per ulteriori informazioni su ruoli e autorizzazioni IAM in BigQuery ML, consulta Controllo dell'accesso. Per ulteriori informazioni sui ruoli a livello di set di dati, consulta la sezione Ruoli di base per i set di dati.
Elenco modelli
Per elencare i modelli in un set di dati:
Console
Nella console Google Cloud, vai alla pagina BigQuery.
Nel riquadro Explorer, espandi il progetto e poi un set di dati.
Espandi la cartella Modelli nel set di dati.
bq
Esegui il comando bq ls
con il flag --models
o -m
. Il
--format
flag può essere utilizzato per controllare l'output. Se elenchi i modelli
in un progetto diverso da quello predefinito,
aggiungi l'ID progetto al set di dati nel seguente formato:
[PROJECT_ID]:[DATASET]
.
bq ls -m --format=pretty PROJECT_ID:DATASET
Sostituisci quanto segue:
PROJECT_ID
è l'ID progetto.DATASET
è il nome del set di dati.
L'output del comando è simile al seguente quando viene utilizzato il flag --format=pretty
. --format=pretty
genera un output di tabelle formattate. La colonna Model Type
mostra il tipo di modello, ad esempio KMEANS
.
+-------------------------+------------+--------+-----------------+ | Id | Model Type | Labels | Creation Time | +-------------------------+------------+--------+-----------------+ | mymodel | KMEANS | | 03 May 03:02:27 | +-------------------------+------------+--------+-----------------+
Esempi:
Inserisci il comando seguente per elencare i modelli nel set di dati mydataset
nel
tuo progetto predefinito.
bq ls --models --format=pretty mydataset
Inserisci il seguente comando per elencare i modelli nel set di dati mydataset
in
myotherproject
. Questo comando utilizza la scorciatoia -m
per elencare i modelli.
bq ls -m --format=pretty myotherproject:mydataset
API
Per elencare i modelli utilizzando l'API, chiama il metodo models.list
e fornisci projectId
e datasetId
.
Vai
Prima di provare questo esempio, segui le istruzioni di configurazione Go riportate nella guida rapida all'utilizzo di BigQuery con le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API BigQuery Go.
Per autenticarti in BigQuery, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione Java riportate nella guida rapida all'utilizzo di BigQuery con le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API BigQuery Java.
Per autenticarti in BigQuery, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione Node.js riportate nella guida rapida all'utilizzo di BigQuery con le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API BigQuery Node.js.
Per autenticarti in BigQuery, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione Python riportate nella guida rapida all'utilizzo di BigQuery con le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API BigQuery Python.
Per autenticarti in BigQuery, configura le Credenziali predefinite dell'applicazione. Per saperne di più, 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ù sull'utilizzo dei modelli, consulta: