Supprimer des valeurs de caractéristiques

Vous pouvez supprimer les valeurs de caractéristiques d'un type d'entité de différentes manières :

Supprimer les valeurs de caractéristiques d'entités spécifiées

Vous pouvez supprimer des valeurs de caractéristiques de plusieurs entités dans un type d'entité. Pour spécifier les entités dont vous souhaitez supprimer les valeurs de caractéristiques, vous devez répertorier les ID d'entité dans un fichier CSV.

REST

Pour supprimer des valeurs de caractéristiques, envoyez une requête POST à l'aide de la méthode featurestores.entityTypes.deleteFeatureValues.

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

  • LOCATION_ID : région ou emplacement dans lequel le magasin de caractéristiques est créé. Par exemple, us-central1.
  • PROJECT_ID : l'ID de votre projet.
  • FEATURESTORE_ID : ID du featurestore.
  • ENTITY_TYPE : ID du type d'entité duquel vous souhaitez supprimer les valeurs de caractéristiques.
  • CSV_FILE_URI : spécifiez l'URI Cloud Storage du fichier CSV contenant les ID d'entité pour lesquels vous souhaitez supprimer les valeurs de caractéristiques. La première ligne de ce fichier doit être l'une des suivantes :
    • Si vous spécifiez le paramètre entity_id_field, la première ligne du fichier CSV doit être identique à ENTITY_ID_FIELD.
    • Si vous ne spécifiez pas le paramètre entity_id_field, la première ligne du fichier CSV doit être "entity_id".
  • ENTITY_ID_FIELD : (facultatif) Saisissez la chaîne spécifiée sur la première ligne du fichier CSV dans CSV_FILE_URI.

Méthode HTTP et URL : 

POST http://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE:deleteFeatureValues

Corps JSON de la requête : 

{
  "selectEntity": {
    "entityIdSelector": {
      "csv_source": {
        "gcs_source": {
          "uris": [
            "CSV_FILE_URI"
          ]
        },
        "entity_id_field": "ENTITY_ID_FIELD"
      }
    }
  }
}

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 POST \
     -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/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE:deleteFeatureValues"

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 POST `
    -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/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE:deleteFeatureValues" | Select-Object -Expand Content

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

{
  "name": "projects/571445526053/locations/us-central1/operations/7688824614775947264",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.DeleteFeatureValuesOperationMetadata",
    "genericMetadata": {
      "createTime": "2022-05-09T16:59:38.128375Z",
      "updateTime": "2022-05-09T16:59:38.128375Z",
      "state": "RUNNING",
      "worksOn": [
        "projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID"
      ]
    }
  }
}

Afficher l'état de la requête

Pour vérifier l'état de la requête POST, envoyez la requête GET suivante.

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

  • LOCATION_ID : région ou emplacement dans lequel le magasin de caractéristiques est créé. Par exemple, us-central1.
  • OPERATION_NAME : valeur du champ "name" dans la réponse JSON de la requête POST pour supprimer les valeurs de caractéristiques.

Méthode HTTP et URL : 

GET http://LOCATION_ID-aiplatform.googleapis.com/v1/OPERATION_NAME

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

curl

Exécutez la commande suivante :

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "http://LOCATION_ID-aiplatform.googleapis.com/v1/OPERATION_NAME"

PowerShell

Exécutez la commande suivante :

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "http://LOCATION_ID-aiplatform.googleapis.com/v1/OPERATION_NAME" | Select-Object -Expand Content

Vous devriez recevoir un code d'état indiquant le succès de l'opération (2xx), ainsi qu'une réponse vide.

Supprimer les valeurs de caractéristiques de caractéristiques spécifiées dans une période donnée

Vous pouvez supprimer les valeurs de caractéristiques d'un type d'entité en spécifiant les ID de caractéristique et une période.

REST

Pour supprimer les valeurs de caractéristiques d'un type d'entité, envoyez une requête POST à l'aide de la méthode featurestores.entityTypes.deleteFeatureValues.

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

  • LOCATION_ID : région ou emplacement dans lequel le magasin de caractéristiques est créé. Par exemple, us-central1.
  • PROJECT_ID : l'ID de votre projet.
  • FEATURESTORE_ID : ID du featurestore.
  • ENTITY_TYPE : ID du type d'entité duquel vous souhaitez supprimer les valeurs de caractéristiques.
  • START_TIME : spécifiez l'heure de début de la période.
  • END_TIME : (facultatif) Spécifiez l'heure de fin de la période.
  • SKIP_ONLINE_STORAGE_DELETE : (facultatif) Pour supprimer les valeurs de caractéristiques du stockage en ligne et hors ligne, saisissez false. Sinon, pour supprimer les valeurs de caractéristiques du stockage hors ligne uniquement, saisissez true.

Méthode HTTP et URL : 

POST http://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE:deleteFeatureValues

Corps JSON de la requête : 

{
  "selectTimeRangeAndFeature": {
    "timeRange": {
      "startTime": "START_TIME",
      "endTime": "END_TIME"
    },
    "featureSelector": {
      "idMatcher": {
        "ids": [ "FEATURE_ID", ...]
      }
    },
    "skipOnlineStorageDelete": SKIP_ONLINE_STORAGE_DELETE
  }
}

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 POST \
     -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/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE:deleteFeatureValues"

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 POST `
    -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/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE:deleteFeatureValues" | Select-Object -Expand Content

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

{
  "name": "projects/571445526053/locations/us-central1/operations/7688824614775947264",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.DeleteFeatureValuesOperationMetadata",
    "genericMetadata": {
      "createTime": "2022-05-09T16:59:38.128375Z",
      "updateTime": "2022-05-09T16:59:38.128375Z",
      "state": "RUNNING",
      "worksOn": [
        "projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID"
      ]
    }
  }
}

Afficher l'état de la requête

Pour vérifier l'état de la requête POST, envoyez la requête GET suivante.

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

  • LOCATION_ID : région ou emplacement dans lequel le magasin de caractéristiques est créé. Par exemple, us-central1.
  • OPERATION_NAME : valeur du champ "name" dans la réponse JSON de la requête POST pour supprimer les valeurs de caractéristiques.

Méthode HTTP et URL : 

GET http://LOCATION_ID-aiplatform.googleapis.com/v1/OPERATION_NAME

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

curl

Exécutez la commande suivante :

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "http://LOCATION_ID-aiplatform.googleapis.com/v1/OPERATION_NAME"

PowerShell

Exécutez la commande suivante :

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "http://LOCATION_ID-aiplatform.googleapis.com/v1/OPERATION_NAME" | Select-Object -Expand Content

Vous devriez recevoir un code d'état indiquant le succès de l'opération (2xx), ainsi qu'une réponse vide.

Étapes suivantes

Consultez les quotas et limites de Vertex AI Feature Store.