Obtén metadatos del modelo

Descripción general

En esta página, se muestra cómo obtener información o metadatos sobre los modelos de BigQuery ML. Para obtener metadatos de modelos, haz lo siguiente:

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

Nota: Actualmente, no se admite obtener información sobre los modelos mediante consultas a las vistas INFORMATION_SCHEMA.

Permisos necesarios

Para obtener los metadatos del modelo, debes tener asignada la función READER en el conjunto de datos, o una función de IAM a nivel del proyecto que incluya los permisos bigquery.models.getMetadata. Si tienes permisos bigquery.models.getMetadata a nivel del proyecto, puedes obtener metadatos sobre 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.getMetadata:

• bigquery.dataViewer
• bigquery.dataEditor
• bigquery.dataOwner
• bigquery.metadataViewer
• 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.

Obtén metadatos del modelo

Para obtener metadatos sobre los modelos:

Console

1. En el panel de navegación, en la sección Recursos, expande tu proyecto y selecciona un conjunto de datos.

2. Haz clic en el nombre del modelo.

3. Debajo de la casilla del editor de consultas, haz clic en Detalles (Details). En esta página, se muestran los metadatos del modelo, incluidas las opciones de entrenamiento, las etiquetas, los detalles y la descripción.

   

CLI

Ejecuta el comando bq show con la marca --model o -m para mostrar los metadatos del modelo. La marca --format se puede usar para controlar el resultado.

Para ver solo las columnas de atributos de tu modelo, usa la marca --schema con la marca --model. Cuando usas la marca --schema, debes configurar --format en json o prettyjson.

Si obtienes información sobre un modelo en otro proyecto que no sea el predeterminado, agrega el ID del proyecto al conjunto de datos en el siguiente formato: [PROJECT_ID]:[DATASET].

bq show --model --format=prettyjson [PROJECT_ID]:[DATASET].[MODEL]

Aquí:

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

El resultado del comando es similar al siguiente ejemplo cuando se usa la marca --format=pretty. Para ver todos los detalles, usa el formato --format=prettyjson. El resultado de muestra presenta metadatos para un modelo de regresión logística.

+--------------+---------------------+---------------------+---------------------------+--------+-----------------+-----------------+
|      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   |                           |        |                 |                 |
+--------------+---------------------+---------------------+---------------------------+--------+-----------------+-----------------+

Ejemplos:

Ingresa el siguiente comando para mostrar toda la información sobre mymodel en mydataset. mydataset se encuentra en tu proyecto predeterminado.

bq show --model --format=prettyjson mydataset.mymodel

Ingresa el siguiente comando para mostrar toda la información sobre mymodel en mydataset. mydataset se encuentra en myotherproject, no en tu proyecto predeterminado.

bq show --model --format=prettyjson myotherproject:mydataset.mymodel

Ingresa el siguiente comando para mostrar solo las columnas de atributos para mymodel en mydataset. mydataset se encuentra en myotherproject, no en tu proyecto predeterminado.

bq show --model --schema --format=prettyjson \
myotherproject:mydataset.mymodel

API

Para obtener los metadatos del modelo con la API, llama al método models.get y proporciona el projectId, datasetId y modelId.

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:
  • Muestra una lista de modelos
  • Actualiza los metadatos del modelo
  • Administra modelos
  • Borra modelos