Visão geral
Nesta página, você verá como listar modelos do BigQuery ML em um conjunto de dados. É possível fazer isso:
- Usando o Console do Google Cloud.
- use o comando
bq ls
na ferramenta de linha de comandobq
. - chamando o método da API
models.list
diretamente ou usando as bibliotecas de cliente.
Permissões necessárias
Para listar modelos em um conjunto de dados, você deve receber o papel READER
no conjunto de dados ou um papel IAM para envolvidos no projeto que inclua permissões bigquery.models.list
. Se você receber as permissões bigquery.models.list
para envolvidos no projeto, poderá listar modelos em qualquer conjunto de dados no projeto. Os seguintes papéis predefinidos do IAM para envolvidos no projeto incluem permissões bigquery.models.list
:
bigquery.dataViewer
bigquery.dataEditor
bigquery.dataOwner
bigquery.metadataViewer
bigquery.user
bigquery.admin
Para informações sobre papéis e permissões do IAM no BigQuery ML, consulte Controle de acesso. Para mais informações sobre papéis no nível do conjunto de dados, consulte Papéis básicos para conjuntos de dados na documentação do BigQuery.
Como listar modelos
Para listar modelos em um conjunto de dados:
Console
No console do Google Cloud, acesse a página do BigQuery.
Na seção Recursos do painel de navegação, clique no nome do projeto.
À medida que você expande cada um dos conjuntos de dados em um projeto, os modelos são listados junto a outros recursos do BigQuery nos conjuntos de dados. Os modelos são indicados pelo ícone do modelo:
.
bq
Emita o comando bq ls
com a sinalização --models
ou -m
. A sinalização --format
pode ser usada para controlar a saída. Se estiver listando modelos em um projeto diferente do projeto padrão, adicione a ID do projeto ao conjunto de dados no seguinte formato: [PROJECT_ID]:[DATASET]
.
bq ls -m --format=pretty [PROJECT_ID]:[DATASET]
Em que:
[PROJECT_ID]
é o ID do projeto;[DATASET]
é o nome do conjunto de dados.
A resposta ao comando será semelhante à seguinte quando a sinalização --format=pretty
for usada. --format=pretty
produz saída de tabela formatada. A coluna Model Type
exibe o tipo de modelo, por exemplo, KMEANS
.
+-------------------------+------------+--------+-----------------+ | Id | Model Type | Labels | Creation Time | +-------------------------+------------+--------+-----------------+ | mymodel | KMEANS | | 03 May 03:02:27 | +-------------------------+------------+--------+-----------------+
Exemplos:
Digite o comando a seguir para listar modelos no conjunto de dados mydataset
no seu projeto padrão.
bq ls --models --format=pretty mydataset
Digite o comando a seguir para listar modelos no conjunto de dados mydataset
em myotherproject
. Esse comando usa o atalho -m
para fazer a listagem.
bq ls -m --format=pretty myotherproject:mydataset
API
Para listar modelos usando a API, chame o método models.list
e forneça projectId
e datasetId
.
Go
Java
Node.js
Python
A seguir
- Para uma visão geral sobre ML do BigQuery, consulte Introdução ao ML do BigQuery.
- Para começar a usar o BigQuery ML, consulte Primeiros passos com o BigQuery ML usando o console do Google Cloud.
- Para mais informações sobre como utilizar os modelos, consulte: