Mettre à jour une caractéristique

Dans un groupe de caractéristiques, vous pouvez mettre à jour une caractéristique pour l'associer à une colonne spécifique de la source de données BigQuery associée au groupe de caractéristiques.

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

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

REST

Pour mettre à jour une ressource Feature, envoyez une requête PATCH en utilisant la méthode features.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 contenant la caractéristique.
  • FEATURE_NAME : nom de la caractéristique que vous souhaitez mettre à jour.
  • VERSION_COLUMN_NAME : colonne de la table ou de la vue source BigQuery que vous souhaitez associer lors de la mise à jour de la caractéristique.

Méthode HTTP et URL : 

PATCH http://LOCATION_ID-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_NAME/features?feature_id=FEATURE_NAME

Corps JSON de la requête : 

{
  "version_column_name": "VERSION_COLUMN_NAME"
}

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/v1beta1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_NAME/features?feature_id=FEATURE_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/v1beta1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_NAME/features?feature_id=FEATURE_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/features/FEATURE_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1beta1.UpdateFeatureOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T02:36:22.870679Z",
      "updateTime": "2023-09-18T02:36:22.870679Z"
    }
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1beta1.Feature",
    "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_NAME/features/FEATURE_NAME"
  }
}

Étapes suivantes