Avviare una sincronizzazione dei dati

Se la visualizzazione delle funzionalità è configurata per utilizzare la sincronizzazione pianificata dei dati, puoi facoltativamente saltare l'attesa fino alla successiva operazione di sincronizzazione pianificata avviando manualmente la sincronizzazione dei dati.

Non puoi attivare manualmente una sincronizzazione dei dati se la visualizzazione delle funzionalità è configurata per utilizzare la sincronizzazione continua dei dati. Per saperne di più sui tipi di sincronizzazione dei dati supportati da Vertex AI Feature Store e su come configurare il tipo di sincronizzazione per una visualizzazione delle caratteristiche, consulta Sincronizzare i dati delle caratteristiche in una visualizzazione delle caratteristiche.

Tieni presente che per sincronizzare i dati dell'intero archivio online, devi sincronizzare i dati di tutte le relative visualizzazioni 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 funzionalità, consulta Ottimizzare i costi durante la sincronizzazione.

Prima di iniziare

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

    After installing the Google Cloud CLI, initialize it 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.

Per saperne di più, consulta la sezione Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud .

Avviare manualmente una sincronizzazione dei dati

Utilizza il seguente esempio per avviare manualmente la sincronizzazione dei dati in una visualizzazione delle funzionalità configurata per la sincronizzazione pianificata dei dati.

Tieni presente che può essere attiva una sola operazione di sincronizzazione dei dati in qualsiasi momento per una visualizzazione delle funzionalità. Se provi ad avviare manualmente la sincronizzazione dei dati mentre un'altra sincronizzazione è in corso, la nuova operazione di sincronizzazione inizia 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, apporta le seguenti sostituzioni:

  • LOCATION_ID: la regione in cui si trova il negozio online, ad esempio us-central1.
  • PROJECT_ID: il tuo ID progetto.
  • FEATUREONLINESTORE_NAME: Il nome dell'archivio online contenente la visualizzazione delle funzionalità.
  • FEATUREVIEW_NAME: il nome della vista delle funzionalità 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 di queste 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