Démarrer une synchronisation de données

Si votre vue des caractéristiques est configurée pour utiliser la synchronisation planifiée des données, vous pouvez éventuellement éviter d'attendre la prochaine opération de synchronisation planifiée en lançant manuellement la synchronisation des données.

Vous ne pouvez pas déclencher manuellement la synchronisation des données si votre vue des caractéristiques est configurée pour utiliser la synchronisation continue des données. Pour en savoir plus sur les types de synchronisation des données compatibles avec Vertex AI Feature Store et découvrir comment configurer le type de synchronisation pour une vue de caractéristiques, consultez Synchroniser des données de caractéristiques dans une vue de caractéristiques.

Notez que 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 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 API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à la gcloud CLI.

    Installez la Google Cloud CLI. Une fois que la Google Cloud CLI est installée, initialisez-la en exécutant la commande suivante : 

    gcloud init

    Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

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 configurée pour la synchronisation planifiée des données.

Notez qu'une seule opération de synchronisation des 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 le magasin en ligne, par exemple us-central1.
  • PROJECT_ID : ID de votre projet.
  • FEATUREONLINESTORE_NAME : nom du magasin en ligne contenant la vue des caractéristiques.
  • FEATUREVIEW_NAME : nom de la vue des 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