Actualizar metadatos de modelos

Consola

1. En la Google Cloud consola, ve a la página BigQuery.

   Ir a la página de BigQuery

2. En el panel Explorador, expande tu proyecto y, a continuación, un conjunto de datos.

3. Expanda la carpeta Modelos del conjunto de datos y, a continuación, haga clic en el nombre de un modelo para seleccionarlo.

4. Haga clic en la pestaña Detalles.

5. Para actualizar la descripción del modelo, haz clic en Editar edit.

6. En el cuadro de diálogo Editar detalles, actualiza la descripción y haz clic en Guardar.

bq

Para actualizar la descripción de un modelo, ejecuta el comando bq update con las marcas --model o -m y --description.

Si vas a actualizar un modelo en un proyecto que no sea el predeterminado, añade el ID del proyecto al conjunto de datos con el siguiente formato: [PROJECT_ID]:[DATASET].

bq update --model --description "[STRING]" PROJECT_ID:DATASET.MODEL

Haz los cambios siguientes:

• STRING es la cadena de texto que describe tu modelo entre comillas.
• PROJECT_ID es el ID del proyecto.
• DATASET es el nombre del conjunto de datos.
• MODEL es el nombre del modelo.

La salida del comando es similar a la siguiente:

Model 'myproject.mydataset.mymodel' successfully updated.

Puedes confirmar los cambios con el comando bq show. Para obtener más información, consulta Obtener metadatos de modelos.

Ejemplos:

Introduce el siguiente comando para actualizar la descripción de mymodel en mydataset en tu proyecto predeterminado.

bq update --model --description "My updated description" \
mydataset.mymodel

Introduce el siguiente comando para actualizar la descripción de mymodel en mydataset en myotherproject.

bq update --model --description "My updated description" \
myotherproject:mydataset.mymodel

API

Para actualizar la descripción de un modelo mediante la API, llama al método models.patch y proporciona los valores projectId, datasetId y modelId. Para modificar la descripción, añade o actualiza la propiedad "description" del recurso de modelo.

Go

import (
	"context"
	"fmt"

	"cloud.google.com/go/bigquery"
)

// updateModelDescription demonstrates fetching BigQuery ML model metadata and updating the
// Description metadata.
func updateModelDescription(projectID, datasetID, modelID string) error {
	// projectID := "my-project-id"
	// datasetID := "mydataset"
	// modelID := "mymodel"
	ctx := context.Background()
	client, err := bigquery.NewClient(ctx, projectID)
	if err != nil {
		return fmt.Errorf("bigquery.NewClient: %w", err)
	}
	defer client.Close()

	model := client.Dataset(datasetID).Model(modelID)
	oldMeta, err := model.Metadata(ctx)
	if err != nil {
		return fmt.Errorf("couldn't retrieve model metadata: %w", err)
	}
	update := bigquery.ModelMetadataToUpdate{
		Description: "This model was modified from a Go program",
	}
	if _, err = model.Update(ctx, update, oldMeta.ETag); err != nil {
		return fmt.Errorf("couldn't update model: %w", err)
	}
	return nil
}

Java

import com.google.cloud.bigquery.BigQuery;
import com.google.cloud.bigquery.BigQueryException;
import com.google.cloud.bigquery.BigQueryOptions;
import com.google.cloud.bigquery.Model;
import com.google.cloud.bigquery.ModelId;

// Sample to update description on a model
public class UpdateModelDescription {

  public static void runUpdateModelDescription() {
    // TODO(developer): Replace these variables before running the sample.
    String datasetName = "MY_DATASET_NAME";
    String modelName = "MY_MODEL_NAME";
    String newDescription = "A really great model.";
    updateModelDescription(datasetName, modelName, newDescription);
  }

  public static void updateModelDescription(
      String datasetName, String modelName, String newDescription) {
    try {
      // Initialize client that will be used to send requests. This client only needs to be created
      // once, and can be reused for multiple requests.
      BigQuery bigquery = BigQueryOptions.getDefaultInstance().getService();

      Model model = bigquery.getModel(ModelId.of(datasetName, modelName));
      bigquery.update(model.toBuilder().setDescription(newDescription).build());
      System.out.println("Model description updated successfully to " + newDescription);
    } catch (BigQueryException e) {
      System.out.println("Model description was not updated \n" + e.toString());
    }
  }
}

Node.js

// Import the Google Cloud client library
const {BigQuery} = require('@google-cloud/bigquery');
const bigquery = new BigQuery();

async function updateModel() {
  // Updates a model's metadata.

  /**
   * TODO(developer): Uncomment the following lines before running the sample
   */
  // const datasetId = "my_dataset";
  // const modelId = "my__model";

  const metadata = {
    description: 'A really great model.',
  };

  const dataset = bigquery.dataset(datasetId);
  const [apiResponse] = await dataset.model(modelId).setMetadata(metadata);
  const newDescription = apiResponse.description;

  console.log(`${modelId} description: ${newDescription}`);
}

Python

from google.cloud import bigquery

# Construct a BigQuery client object.
client = bigquery.Client()

# TODO(developer): Set model_id to the ID of the model to fetch.
# model_id = 'your-project.your_dataset.your_model'

model = client.get_model(model_id)  # Make an API request.
model.description = "This model was modified from a Python program."
model = client.update_model(model, ["description"])  # Make an API request.

full_model_id = "{}.{}.{}".format(model.project, model.dataset_id, model.model_id)
print(
    "Updated model '{}' with description '{}'.".format(
        full_model_id, model.description
    )
)

Consola

1. En el panel Explorador, expande tu proyecto y, a continuación, un conjunto de datos.

2. Expanda la carpeta Modelos del conjunto de datos y, a continuación, haga clic en el nombre de un modelo para seleccionarlo.

3. Haga clic en la pestaña Detalles.

4. Para actualizar las etiquetas del modelo, haz clic en Editar edit.

5. En el cuadro de diálogo Editar detalle, añade, elimina o modifica etiquetas y, a continuación, haz clic en Guardar.

bq

Para actualizar las etiquetas de un modelo, ejecuta el comando bq update con las marcas --model o -m y --set_label. Repite la marca --set_label para añadir o actualizar varias etiquetas.

Si vas a actualizar un modelo en un proyecto que no sea el predeterminado, añade el ID del proyecto al conjunto de datos con el siguiente formato: [PROJECT_ID]:[DATASET].

bq update --model --set_label KEY:VALUE \
PROJECT_ID:DATASET.MODEL

Haz los cambios siguientes:

• KEY:VALUE corresponde a un par clave-valor de una etiqueta que quiera añadir o actualizar. Si especificas la misma clave que una etiqueta ya creada, se actualizará el valor de la etiqueta. La clave debe ser única.
• PROJECT_ID es el ID del proyecto.
• DATASET es el nombre del conjunto de datos.
• MODEL es el nombre del modelo.

La salida del comando tiene el siguiente aspecto.

Model 'myproject.mydataset.mymodel' successfully updated.

Puedes confirmar los cambios con el comando bq show. Para obtener más información, consulta Obtener metadatos de modelos.

Ejemplos:

Para actualizar la etiqueta department en mymodel, introduce el comando bq update y especifica department como clave de etiqueta. Por ejemplo, para cambiar la etiqueta department:shipping a department:logistics, introduce el siguiente comando. mydataset está en myotherproject, no en tu proyecto predeterminado.

bq update --model --set_label department:logistics \
myotherproject:mydataset.mymodel

API

Para actualizar las etiquetas de un modelo mediante la API, llama al método models.patch y proporciona los valores projectId, datasetId y modelId. Para modificar las etiquetas, añade o actualiza la propiedad "labels" del recurso de modelo.

Consola

La consola no admite la configuración ni la actualización de la hora de vencimiento de un modelo. Google Cloud

bq

Para actualizar la hora de vencimiento de un modelo, ejecuta el comando bq update con las marcas --model o -m y la marca --expiration.

Si vas a actualizar un modelo en un proyecto que no sea el predeterminado, añade el ID del proyecto al conjunto de datos con el siguiente formato: [PROJECT_ID]:[DATASET].

bq update --model --expiration INTEGER \
PROJECT_ID:DATASET.MODEL

Haz los cambios siguientes:

• INTEGER es el tiempo de vida del modelo (en segundos). El valor mínimo es de 3600 segundos (una hora). La hora de vencimiento se calcula como la hora UTC actual más el valor entero.
• PROJECT_ID es el ID del proyecto.
• DATASET es el nombre del conjunto de datos.
• MODEL es el nombre del modelo.

La salida del comando tiene el siguiente aspecto.

Model 'myproject.mydataset.mymodel' successfully updated.

Puedes confirmar los cambios con el comando bq show. Para obtener más información, consulta Obtener metadatos de modelos.

Ejemplos:

Introduce el siguiente comando para actualizar el tiempo de vencimiento de mymodel en mydataset a 5 días (432.000 segundos). mydataset está en tu proyecto predeterminado.

bq update --model --expiration 432000 mydataset.mymodel

Introduce el siguiente comando para actualizar el tiempo de vencimiento de mymodel en mydataset a 5 días (432.000 segundos). mydataset está en myotherproject, no en tu proyecto predeterminado.

bq update --model --expiration 432000 myotherproject:mydataset.mymodel

API

Para actualizar la caducidad de un modelo mediante la API, llama al método models.patch y proporciona los valores projectId, datasetId y modelId. Para modificar la caducidad, añade o actualiza la propiedad "expirationTime" del recurso de modelo. "expirationTime" se expresa en milisegundos desde el inicio del registro de tiempo.