Synchroniser les données de caractéristiques avec la boutique en ligne

La synchronisation des données est le processus d'actualisation ou de synchronisation des données dans une vue de caractéristiques d'un magasin en ligne à partir de la source de données de caractéristiques dans BigQuery. Pour synchroniser les données de l'ensemble du magasin en ligne, vous devez synchroniser les données pour toutes ses vues de caractéristiques.

La synchronisation des données pour une vue de caractéristiques se produit de deux manières:

  • Synchronisation planifiée des données: les données de caractéristiques sont automatiquement actualisées, en fonction de la planification de synchronisation configurée pour la vue des caractéristiques à l'aide du paramètre FeatureView.sync_config.

  • Synchronisation manuelle des données: vous pouvez ignorer l'attente entre deux opérations de synchronisation de données planifiées en lançant manuellement la synchronisation des données pour une vue des caractéristiques.

La synchronisation des données peut entraîner des coûts d'utilisation des ressources BigQuery. Pour savoir comment optimiser les coûts tout en définissant la planification de synchronisation pour une vue de caractéristiques, consultez la section Optimiser les coûts pendant la synchronisation.

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.

    Install the Google Cloud CLI, then initialize it by running the following command: 

    gcloud init

Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Google Cloud.

Démarrer manuellement une synchronisation de données

Utilisez l'exemple suivant pour démarrer manuellement la synchronisation des données dans une vue des caractéristiques. Notez qu'une seule opération de synchronisation de données peut être active à tout moment pour une vue de caractéristiques. Si vous essayez de démarrer manuellement la synchronisation des données pendant qu'une autre synchronisation est en cours, la nouvelle opération de synchronisation ne démarre qu'une fois l'opération en cours terminée.

REST

Pour démarrer manuellement une synchronisation des données dans une FeatureView, envoyez une requête POST à l'aide de la méthode featureViews.sync.

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

  • LOCATION_ID : région où se trouve la boutique en ligne, par exemple us-central1.
  • PROJECT_ID : ID de votre projet
  • FEATUREONLINESTORE_NAME: nom de la boutique en ligne contenant la vue de la caractéristique.
  • FEATUREVIEW_NAME: nom de la vue de caractéristiques pour laquelle vous souhaitez démarrer manuellement la synchronisation des données.

Méthode HTTP et URL : 

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME:sync

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

curl

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 "" \
     "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME:sync"

PowerShell

Exécutez la commande suivante :

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

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME:sync" | Select-Object -Expand Content

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

{
  "featureViewSync": "projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME/featureViewSyncs/OPERATION_ID"
}

Étapes suivantes