Sincronizza i dati delle funzionalità con il negozio online

La sincronizzazione dei dati è il processo di aggiornamento o sincronizzazione dei dati in una visualizzazione delle caratteristiche all'interno di un archivio online dall'origine dati delle caratteristiche in BigQuery. Per sincronizzare i dati per l'intero archivio online, devi sincronizzare i dati per tutte le sue visualizzazioni caratteristiche.

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

  • Sincronizzazione dei dati pianificata: i dati della funzionalità vengono aggiornati automaticamente in base alla programmazione della sincronizzazione configurata per la visualizzazione delle caratteristiche utilizzando il parametro FeatureView.sync_config.

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

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

Prima di iniziare

Autentica in Vertex AI, se non l'hai 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 maggiori informazioni, consulta 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. Tieni presente che può essere attiva una sola operazione di sincronizzazione dei dati in qualsiasi momento per una visualizzazione delle caratteristiche. Se provi ad avviare manualmente la sincronizzazione dei dati mentre è in corso un'altra sincronizzazione, la nuova operazione di sincronizzazione verrà avviata solo al termine di quella in corso.

REST

Per avviare manualmente una sincronizzazione dei dati in un FeatureView, invia una richiesta POST utilizzando il metodo 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