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.

Avant de commencer

Authentifiez-vous auprès de Vertex AI, sauf si vous l'avez déjà fait.

Pour utiliser les exemples d'API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à gcloud CLI.

    Installez Google Cloud CLI, puis initialisez-la en exécutant la commande suivante : 

    gcloud init

Mettre à jour 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 https://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 \
     "https://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 "https://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