Memulai sinkronisasi data

Jika tampilan fitur dikonfigurasi untuk menggunakan sinkronisasi data terjadwal, Anda dapat memilih untuk melewati waktu tunggu hingga operasi sinkronisasi terjadwal berikutnya dengan memulai sinkronisasi data secara manual.

Anda tidak dapat memicu sinkronisasi data secara manual jika tampilan fitur dikonfigurasi untuk menggunakan sinkronisasi data berkelanjutan. Untuk informasi selengkapnya tentang jenis sinkronisasi data yang didukung Vertex AI Feature Store dan cara mengonfigurasi jenis sinkronisasi untuk tampilan fitur, lihat Menyinkronkan data fitur dalam tampilan fitur.

Perhatikan bahwa untuk menyinkronkan data untuk seluruh penyimpanan online, Anda perlu menyinkronkan data untuk semua tampilan fiturnya.

Sinkronisasi data mungkin memerlukan biaya terkait penggunaan resource BigQuery. Untuk mengetahui cara mengoptimalkan biaya sekaligus menetapkan jadwal sinkronisasi untuk tampilan fitur, lihat Mengoptimalkan biaya selama sinkronisasi.

Sebelum memulai

Lakukan autentikasi ke Vertex AI, kecuali jika Anda telah melakukannya.

Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

    Install the Google Cloud CLI, then initialize it by running the following command:

    gcloud init

Untuk informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud.

Memulai sinkronisasi data secara manual

Gunakan contoh berikut untuk memulai sinkronisasi data di tampilan fitur yang dikonfigurasi untuk sinkronisasi data terjadwal secara manual.

Perhatikan bahwa hanya satu operasi sinkronisasi data yang dapat aktif pada satu waktu tertentu untuk tampilan fitur. Jika Anda mencoba memulai sinkronisasi data secara manual saat sinkronisasi lain sedang berlangsung, operasi sinkronisasi baru hanya akan dimulai setelah operasi sinkronisasi yang sedang berlangsung berakhir.

REST

Untuk memulai sinkronisasi data secara manual di FeatureView, kirim permintaan POST dengan menggunakan metode featureViews.sync.

Sebelum menggunakan data permintaan mana pun, lakukan penggantian berikut:

  • LOCATION_ID: Region tempat toko online berada, seperti us-central1.
  • PROJECT_ID: Project ID Anda.
  • FEATUREONLINESTORE_NAME: Nama penyimpanan online yang berisi tampilan fitur.
  • FEATUREVIEW_NAME: Nama tampilan fitur tempat Anda ingin memulai sinkronisasi data secara manual.

Metode HTTP dan URL:

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

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Jalankan perintah berikut:

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

Jalankan perintah berikut:

$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

Anda akan menerima respons JSON yang mirip seperti berikut:

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

Langkah berikutnya