Sincronizza i dati delle funzionalità con il negozio online

La sincronizzazione dei dati è il processo di aggiornamento o sincronizzazione dei dati di una funzionalità all'interno di un negozio online dall'origine dati delle caratteristiche in BigQuery. Per sincronizzare i dati per l'intero archivio online, devi sincronizzare i dati per tutti delle sue viste delle caratteristiche.

Esistono due modi in cui la sincronizzazione dei dati avviene per una visualizzazione caratteristiche:

  • Sincronizzazione dei dati pianificata. I dati della funzione vengono aggiornati automaticamente in base alle la pianificazione della sincronizzazione configurata per la visualizzazione caratteristiche utilizzando FeatureView.sync_config.

  • Sincronizzazione manuale dei dati: puoi saltare l'attesa tra due sincronizzazioni dei dati pianificate avviando manualmente la sincronizzazione dei dati per una visualizzazione caratteristiche.

La sincronizzazione dei dati potrebbe comportare costi per l'utilizzo delle risorse BigQuery. Per informazioni su come ottimizzare i costi e pianificare la sincronizzazione per un visualizzazione delle caratteristiche, consulta Ottimizzare i costi durante la sincronizzazione.

Prima di iniziare

Autentica in Vertex AI, a meno che tu non l'abbia già fatto.

Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.

    Installa Google Cloud CLI, quindi initialize eseguendo questo comando: 

    gcloud init

Per ulteriori informazioni, vedi Esegui l'autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.

Avviare manualmente una sincronizzazione dei dati

Utilizza l'esempio seguente per avviare manualmente la sincronizzazione dei dati in una visualizzazione caratteristiche. Nota sia possibile attivare in qualsiasi momento una sola operazione di sincronizzazione dei dati per visualizzazione delle caratteristiche. Se provi ad avviare manualmente la sincronizzazione dei dati durante un'altra sincronizzazione è in corso, la nuova operazione di sincronizzazione inizierà solo dopo l'operazione di sincronizzazione.

REST

Per avviare manualmente una sincronizzazione dei dati in un FeatureView, invia una richiesta POST utilizzando featureViews.sync .

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • LOCATION_ID: regione in cui si trova il negozio online, ad esempio us-central1.
  • PROJECT_ID: l'ID progetto.
  • FEATUREONLINESTORE_NAME: il nome del negozio online contenente la visualizzazione delle caratteristiche.
  • FEATUREVIEW_NAME: il nome della visualizzazione delle caratteristiche in cui vuoi avviare manualmente la sincronizzazione dei dati.

Metodo HTTP e URL: 

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

Per inviare la richiesta, scegli una delle seguenti opzioni:

curl

Esegui questo comando: 

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

Esegui questo comando: 

$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

Dovresti ricevere una risposta JSON simile alla seguente:

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

Passaggi successivi