Dengan penyaluran online, Anda dapat menyalurkan nilai fitur untuk batch kecil entity pada latensi rendah. Untuk setiap permintaan, Anda hanya dapat menyalurkan nilai fitur dari satu jenis entity. Vertex AI Feature Store (Lama) hanya menampilkan nilai non-null terbaru dari setiap fitur.
Biasanya, Anda menggunakan penyaluran online untuk menyalurkan nilai fitur ke model yang di-deploy untuk prediksi online. Misalnya, Anda mungkin memiliki perusahaan rental sepeda dan ingin memprediksi berapa lama pengguna tertentu akan menyewa sepeda. Anda dapat menyertakan input real-time dari pengguna dan data dari featurestore untuk melakukan prediksi online. Dengan begitu, Anda dapat menentukan alokasi resource secara real time.
Nilai null
Untuk hasil penyaluran online, jika nilai terbaru untuk suatu fitur adalah null, Vertex AI Feature Store (Lama) akan menampilkan nilai selain null terbaru. Jika tidak ada nilai sebelumnya, Vertex AI Feature Store (Lama) akan menampilkan null.
Sebelum memulai
Pastikan featurestore tempat Anda melakukan panggilan memiliki toko online (jumlah
node harus lebih besar dari 0
). Jika tidak, permintaan penyaluran online
akan menampilkan error. Untuk mengetahui info selengkapnya, lihat Mengelola
featurestores.
Menyalurkan nilai dari satu entity
Menyalurkan nilai fitur dari satu entity untuk jenis entity tertentu.
REST
Untuk mendapatkan nilai fitur dari entity, kirim permintaan POST menggunakan metode featurestores.entityTypes.readFeatureValues.
Contoh berikut mendapatkan nilai terbaru untuk dua fitur yang berbeda untuk
entity tertentu. Perhatikan bahwa untuk kolom ids
, Anda dapat menentukan
["*"]
, bukan ID fitur, untuk memilih semua fitur
entity.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- LOCATION_ID: Region tempat featurestore dibuat. Contoh,
us-central1
. - PROJECT_ID: Project ID Anda.
- FEATURESTORE_ID: ID featurestore.
- ENTITY_TYPE_ID: ID jenis entity.
- ENTITY_ID: ID entity yang akan mendapatkan nilai fiturnya.
- FEATURE_ID: ID fitur yang ingin diperoleh nilainya.
Metode HTTP dan URL:
POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID:readFeatureValues
Isi JSON permintaan:
{ "entityId": "ENTITY_ID", "featureSelector": { "idMatcher": { "ids": ["FEATURE_ID_1", "FEATURE_ID_2"] } } }
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Simpan isi permintaan dalam file bernama request.json
,
dan jalankan perintah berikut:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID:readFeatureValues"
PowerShell
Simpan isi permintaan dalam file bernama request.json
,
dan jalankan perintah berikut:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID:readFeatureValues" | Select-Object -Expand Content
Anda akan melihat respons JSON seperti berikut:
{ "header": { "entityType": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID", "featureDescriptors": [ { "id": "FEATURE_ID_1" }, { "id": "FEATURE_ID_2" } ] }, "entityView": { "entityId": "ENTITY_ID", "data": [ { "value": { "VALUE_TYPE_1": "FEATURE_VALUE_1", "metadata": { "generateTime": "2019-10-28T15:38:10Z" } } }, { "value": { "VALUE_TYPE_2": "FEATURE_VALUE_2", "metadata": { "generateTime": "2019-10-28T15:38:10Z" } } } ] } }
Python
Untuk mempelajari cara menginstal atau mengupdate Vertex AI SDK untuk Python, lihat Menginstal Vertex AI SDK untuk Python. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Python API.
Python
Library klien untuk Vertex AI disertakan saat Anda menginstal Vertex AI SDK untuk Python. Guna mempelajari cara menginstal Vertex AI SDK untuk Python, lihat Menginstal Vertex AI SDK untuk Python. Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi API Vertex AI SDK untuk Python.
Java
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Java di Panduan memulai Vertex AI menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi API Java Vertex AI.
Untuk melakukan autentikasi ke Vertex AI, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Node.js di Panduan memulai Vertex AI menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi API Node.js Vertex AI.
Untuk melakukan autentikasi ke Vertex AI, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Menyalurkan nilai dari beberapa entity
Menyalurkan nilai fitur dari satu atau beberapa entity untuk jenis entity tertentu.
Untuk mendapatkan performa yang lebih baik, gunakan metode streamingReadFeatureValues
, dan jangan
mengirim permintaan paralel ke metode readFeatureValues
.
REST
Untuk mendapatkan nilai fitur dari beberapa entity, kirim permintaan POST menggunakan, metode featurestores.entityTypes.streamingReadFeatureValues.
Contoh berikut mendapatkan nilai terbaru untuk dua fitur yang berbeda untuk dua
entity yang berbeda. Perhatikan bahwa untuk kolom ids
, Anda dapat menentukan
["*"]
, bukan ID fitur, untuk memilih semua fitur
entity.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- LOCATION_ID: Region tempat featurestore dibuat. Contoh,
us-central1
. - PROJECT_ID: Project ID Anda.
- FEATURESTORE_ID: ID featurestore.
- ENTITY_TYPE_ID: ID jenis entity.
- ENTITY_ID: ID entity yang akan mendapatkan nilai fiturnya.
- FEATURE_ID: ID fitur yang ingin diperoleh nilainya.
Metode HTTP dan URL:
POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID:streamingReadFeatureValues
Isi JSON permintaan:
{ "entityIds": ["ENTITY_ID_1", "ENTITY_ID_2"], "featureSelector": { "idMatcher": { "ids": ["FEATURE_ID_1", "FEATURE_ID_2"] } } }
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Simpan isi permintaan dalam file bernama request.json
,
dan jalankan perintah berikut:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID:streamingReadFeatureValues"
PowerShell
Simpan isi permintaan dalam file bernama request.json
,
dan jalankan perintah berikut:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID:streamingReadFeatureValues" | Select-Object -Expand Content
Anda akan melihat respons JSON seperti berikut:
[{ "header": { "entityType": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID", "featureDescriptors": [ { "id": "FEATURE_ID_1" }, { "id": "FEATURE_ID_2" } ] } }, { "entityView": { "entityId": "ENTITY_ID_1", "data": [ { "value": { "VALUE_TYPE_1": "FEATURE_VALUE_A", "metadata": { "generateTime": "2019-10-28T15:38:10Z" } } }, { "value": { "VALUE_TYPE_2": "FEATURE_VALUE_B", "metadata": { "generateTime": "2019-10-28T15:38:10Z" } } } ] } }, { "entityView": { "entityId": "ENTITY_ID_2", "data": [ { "value": { "VALUE_TYPE_1": "FEATURE_VALUE_C", "metadata": { "generateTime": "2019-10-28T21:21:37Z" } } }, { "value": { "VALUE_TYPE_2": "FEATURE_VALUE_D", "metadata": { "generateTime": "2019-10-28T21:21:37Z" } } } ] } }]
Bahasa tambahan
Anda dapat menginstal dan menggunakan library klien Vertex AI berikut untuk memanggil Vertex AI API. Library Klien Cloud memberikan pengalaman developer, yang dioptimalkan menggunakan konvensi dan, gaya alami dari setiap bahasa yang didukung.
Langkah selanjutnya
- Pelajari cara menyerap nilai fitur secara massal.
- Pelajari cara menyalurkan fitur melalui penyaluran batch.
- Lihat kuota penyaluran online Vertex AI Feature Store (Lama).
- Memecahkan masalah umum Vertex AI Feature Store (Lama).