Muestra una lista de modelos

Descripción general

En esta página, se muestra cómo crear una lista de los modelos de BigQuery ML en un conjunto de datos. Para crear una lista de los modelos de BigQuery ML, haz lo siguiente:

• Usa GCP Console.
• Usa el comando bq ls de CLI.
• Llama al método de la API models.list directamente o usa las bibliotecas cliente.

Permisos necesarios

Para crear una lista de modelos en un conjunto de datos, debes tener asignada la función READER en el conjunto de datos, o una función de IAM a nivel del proyecto, que incluya permisos bigquery.models.list. Si tienes permisos bigquery.models.list a nivel del proyecto, puedes crear una lista de los modelos de cualquier conjunto de datos en el proyecto. Las siguientes funciones de IAM predefinidas a nivel del proyecto incluyen los permisos bigquery.models.list:

• bigquery.dataViewer
• bigquery.dataEditor
• bigquery.dataOwner
• bigquery.metadataViewer
• bigquery.user
• bigquery.admin

Para obtener más información sobre las funciones de IAM y los permisos en BigQuery ML, consulta Control de acceso. Si deseas obtener más información sobre las funciones a nivel del conjunto de datos, consulta Funciones básicas para conjuntos de datos en la documentación de BigQuery.

Muestra una lista de modelos

Para crear una lista de los modelos en un conjunto de datos, haz lo siguiente:

Console

1. Ve a la IU web de BigQuery en GCP Console.

   Ir a la IU web de BigQuery

2. En el panel de navegación, en la sección Recursos (Resources), haz clic en el nombre de tu proyecto.

3. A medida que expandes cada uno de los conjuntos de datos en un proyecto, se enumeran los modelos junto con los otros recursos de BigQuery en los conjuntos de datos. Los modelos se indican con el ícono de modelo: .

CLI

Ejecuta el comando bq ls con la marca --models o -m. La marca --format se puede usar para controlar el resultado. Si creas listas de los modelos en un proyecto que no sea el predeterminado, agrega el ID del proyecto al conjunto de datos en el siguiente formato: [PROJECT_ID]:[DATASET].

bq ls -m --format=pretty [PROJECT_ID]:[DATASET]

Aquí:

• [PROJECT_ID] es el ID del proyecto.
• [DATASET] es el nombre del conjunto de datos.

El resultado del comando es similar al siguiente ejemplo cuando se usa la marca --format=pretty. --format=pretty produce como resultado una tabla con formato. La columna Model Type muestra el tipo de modelo, por ejemplo, KMEANS.

+-------------------------+------------+--------+-----------------+
|           Id            | Model Type | Labels |  Creation Time  |
+-------------------------+------------+--------+-----------------+
| mymodel                 | KMEANS     |        | 03 May 03:02:27 |
+-------------------------+------------+--------+-----------------+

Ejemplos:

Ingresa el siguiente comando para crear una lista de modelos en el conjunto de datos mydataset en tu proyecto predeterminado.

bq ls --models --format=pretty mydataset

Ingresa el siguiente comando para crear una lista de los modelos en un conjunto de datos mydataset en myotherproject. Este comando usa el acceso directo -m para crear una lista de los modelos.

bq ls -m --format=pretty myotherproject:mydataset

API

Para crear una lista de los modelos con la API, llama al método models.list y proporciona el projectId y datasetId.

Qué sigue

• Para obtener una descripción general de BigQuery ML, consulta Introducción a BigQuery ML.
• Para comenzar a usar BigQuery ML, consulta Cómo comenzar a usar BigQuery ML mediante la IU web o Cómo comenzar a usar BigQuery ML con Cloud Datalab.
• Para obtener más información sobre cómo trabajar con modelos, consulta:
  • Obtén metadatos del modelo
  • Actualiza los metadatos del modelo
  • Administra modelos
  • Borra modelos