Mettre à jour un groupe de caractéristiques

Vous pouvez mettre à jour un groupe de caractéristiques pour enregistrer une table ou une vue BigQuery en tant que source de données de caractéristiques pour ce groupe de caractéristiques. Si le groupe de caractéristiques est déjà associé à une source de données, vous pouvez associer une table ou une vue BigQuery différente en tant que source de données de caractéristique.

Lors de la création ou de la mise à jour d'un groupe de caractéristiques, vous avez la possibilité d'ajouter des métadonnées définies par l'utilisateur sous forme de libellés au groupe de caractéristiques. Pour en savoir plus sur la mise à jour des libellés définis par l'utilisateur pour un groupe de caractéristiques, consultez la page Mettre à jour les libellés d'un groupe de caractéristiques.

Utilisez l'exemple suivant pour mettre à jour un groupe de caractéristiques.

REST

Pour mettre à jour une ressource FeatureGroup, envoyez une requête PATCH à l'aide de la méthode featureGroups.patch.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • LOCATION_ID: région où se trouve le groupe de caractéristiques, par exemple us-central1.
  • PROJECT_ID : ID de votre projet
  • FEATURE_GROUP_NAME: nom du groupe de caractéristiques que vous souhaitez mettre à jour.
  • BIGQUERY_SOURCE_URI: URI de la table ou de la vue source BigQuery que vous souhaitez associer au groupe de caractéristiques.

Méthode HTTP et URL : 

PATCH http://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups?feature_group_id=FEATURE_GROUP_NAME

Corps JSON de la requête : 

{
  "big_query": {
    "big_query_source": {
      "input_uri": "BIGQUERY_SOURCE_URI"
    }
  }
}

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "http://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups?feature_group_id=FEATURE_GROUP_NAME"

PowerShell

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "http://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups?feature_group_id=FEATURE_GROUP_NAME" | Select-Object -Expand Content

Vous devriez recevoir une réponse JSON de ce type :

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.UpdateFeatureGroupOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T03:00:13.060636Z",
      "updateTime": "2023-09-18T03:00:13.060636Z"
    }
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.FeatureGroup",
    "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_NAME"
  }
}

Étapes suivantes