Atualize os metadados do modelo

Consola

1. Na Trusted Cloud consola, aceda à página do BigQuery.

   Aceda à página do BigQuery

2. No painel Explorador, expanda o seu projeto e, em seguida, expanda um conjunto de dados.

3. Expanda a pasta Modelos no conjunto de dados e, de seguida, clique no nome de um modelo para selecionar o modelo.

4. Clique no separador Detalhes.

5. Para atualizar a descrição do modelo, clique em Editar edit.

6. Na caixa de diálogo Editar detalhes, atualize a descrição e, de seguida, clique em Guardar.

bq

Para atualizar a descrição de um modelo, execute o comando bq update com a flag --model ou -m e a flag --description.

Se estiver a atualizar um modelo num projeto que não seja o seu projeto predefinido, adicione o ID do projeto ao conjunto de dados no seguinte formato: [PROJECT_ID]:[DATASET].

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

Substitua o seguinte:

• STRING é a string de texto que descreve o seu modelo entre aspas.
• PROJECT_ID é o ID do seu projeto.
• DATASET é o nome do conjunto de dados.
• MODEL é o nome do modelo.

O resultado do comando tem o seguinte aspeto:

Model 'myproject.mydataset.mymodel' successfully updated.

Pode confirmar as alterações emitindo o comando bq show. Para mais informações, consulte o artigo Obtenha metadados do modelo.

Exemplos:

Introduza o seguinte comando para atualizar a descrição de mymodel em mydataset no seu projeto predefinido.

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

Introduza o seguinte comando para atualizar a descrição de mymodel em mydataset em myotherproject.

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

API

Para atualizar a descrição de um modelo através da API, chame o método models.patch e forneça o projectId, o datasetId e o modelId. Para modificar a descrição, adicione ou atualize a propriedade "description" do recurso model.

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. No painel Explorador, expanda o seu projeto e, em seguida, expanda um conjunto de dados.

2. Expanda a pasta Modelos no conjunto de dados e, de seguida, clique no nome de um modelo para selecionar o modelo.

3. Clique no separador Detalhes.

4. Para atualizar as etiquetas do modelo, clique em Editar edit.

5. Na caixa de diálogo Editar detalhe, adicione, elimine ou modifique etiquetas e, de seguida, clique em Guardar.

bq

Para atualizar as etiquetas de um modelo, execute o comando bq update com a flag --model ou -m e a flag --set_label. Repita a flag --set_label para adicionar ou atualizar várias etiquetas.

Se estiver a atualizar um modelo num projeto que não seja o seu projeto predefinido, adicione o ID do projeto ao conjunto de dados no seguinte formato: [PROJECT_ID]:[DATASET].

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

Substitua o seguinte:

• KEY:VALUE corresponde a um par de chave:valor para uma etiqueta que quer adicionar ou atualizar. Se especificar a mesma chave que uma etiqueta existente, o valor da etiqueta existente é atualizado. A chave tem de ser exclusiva.
• PROJECT_ID é o ID do seu projeto.
• DATASET é o nome do conjunto de dados.
• MODEL é o nome do modelo.

O resultado do comando tem o seguinte aspeto.

Model 'myproject.mydataset.mymodel' successfully updated.

Pode confirmar as alterações emitindo o comando bq show. Para mais informações, consulte o artigo Obtenha metadados do modelo.

Exemplos:

Para atualizar a etiqueta department em mymodel, introduza o comando bq update e especifique department como a chave da etiqueta. Por exemplo, para atualizar a etiqueta department:shipping para department:logistics, introduza o seguinte comando. O recurso mydataset está em myotherproject e não no seu projeto predefinido.

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

API

Para atualizar as etiquetas de um modelo através da API, chame o método models.patch e forneça os valores projectId, datasetId e modelId. Para modificar as etiquetas, adicione ou atualize a propriedade "labels" do recurso model.

Consola

A definição ou a atualização da hora de expiração num modelo não é suportada pela Trusted Cloud consola.

bq

Para atualizar a hora de validade de um modelo, execute o comando bq update com a flag --model ou -m e a flag --expiration.

Se estiver a atualizar um modelo num projeto que não seja o seu projeto predefinido, adicione o ID do projeto ao conjunto de dados no seguinte formato: [PROJECT_ID]:[DATASET].

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

Substitua o seguinte:

• INTEGER é o tempo de vida (em segundos) do modelo. O valor mínimo é de 3600 segundos (uma hora). O tempo de expiração é avaliado como a hora UTC atual mais o valor inteiro.
• PROJECT_ID é o ID do seu projeto.
• DATASET é o nome do conjunto de dados.
• MODEL é o nome do modelo.

O resultado do comando tem o seguinte aspeto.

Model 'myproject.mydataset.mymodel' successfully updated.

Pode confirmar as alterações emitindo o comando bq show. Para mais informações, consulte o artigo Obtenha metadados do modelo.

Exemplos:

Introduza o seguinte comando para atualizar a hora de validade de mymodel em mydataset para 5 dias (432 000 segundos). mydataset está no seu projeto predefinido.

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

Introduza o seguinte comando para atualizar a hora de validade de mymodel em mydataset para 5 dias (432 000 segundos). mydataset está em myotherproject, não no seu projeto predefinido.

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

API

Para atualizar a expiração de um modelo através da API, chame o método models.patch e forneça os valores projectId, datasetId e modelId. Para modificar a validade, adicione ou atualize a propriedade "expirationTime" para o recurso de modelo. "expirationTime" é expresso em milissegundos desde epoch.