Démarrer une synchronisation des 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.

Install the Google Cloud CLI. After installation, initialize the Google Cloud CLI by running the following command:

gcloud init

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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 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.

Attention : Vous ne pouvez pas déclencher la synchronisation des données si votre vue des caractéristiques est configurée pour la synchronisation continue des données. Si votre vue de caractéristiques est configurée pour la synchronisation continue des données, les données de caractéristiques sont actualisées chaque fois que les données de caractéristiques de la source de données BigQuery sont modifiées.

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

Remarque : Pour la commande suivante, nous partons du principe que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

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

Remarque : Pour la commande suivante, nous partons du principe que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

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

• Découvrez comment afficher la liste de toutes les opérations de synchronisation de données exécutées pour une vue de caractéristiques.

• Découvrez comment mettre à jour une vue de caractéristiques.