Memulai sinkronisasi data

Jika tampilan fitur Anda dikonfigurasi untuk menggunakan sinkronisasi data terjadwal, Anda dapat secara opsional 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 Anda dikonfigurasi untuk menggunakan sinkronisasi data berkelanjutan. Untuk mengetahui 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 toko 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. 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.

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

Perhatian: Anda tidak dapat memicu sinkronisasi data jika tampilan fitur dikonfigurasi untuk sinkronisasi data berkelanjutan. Jika tampilan fitur Anda dikonfigurasi untuk sinkronisasi data berkelanjutan, data fitur akan diperbarui setiap kali data fitur di sumber data BigQuery diperbarui.

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

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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

• Pelajari cara melihat daftar semua operasi sinkronisasi data yang dijalankan untuk sebuah tampilan fitur.

• Pelajari cara memperbarui tampilan fitur