Anda dapat membuat fitur setelah membuat grup fitur dan mengaitkan tabel BigQuery atau tampilan BigQuery dengan grup tersebut. Anda dapat membuat beberapa fitur untuk grup fitur dan mengaitkan setiap fitur dengan kolom spesifik dalam sumber data BigQuery. Untuk mendapatkan informasi cara menggunakan BigQuery, baca dokumentasi BigQuery.
Misalnya, jika grup fitur featuregroup1
dikaitkan dengan
tabel BigQuery datasource_1
yang berisi nilai fitur di kolom
fval1
dan fval2
, Anda dapat membuat fitur feature_1
di bagian
featuregroup1
dan mengaitkannya dengan nilai fitur di kolomfval1
.
Demikian pula, Anda dapat membuat fitur lain bernama feature_2
dan mengaitkannya
dengan nilai fitur di kolom fval2
.
Mendaftarkan sumber data Anda menggunakan grup fitur dan fitur memiliki beberapa keuntungan berikut:
Anda dapat menentukan tampilan fitur untuk penayangan online menggunakan kolom fitur tertentu dari beberapa sumber data BigQuery.
Anda dapat memformat data sebagai deret waktu dengan menyertakan kolom
feature_timestamp
. Vertex AI Feature Store hanya menyalurkan nilai fitur terbaru dari data fitur dan tidak menyertakan nilai historis.
Gunakan contoh berikut untuk membuat fitur dalam grup fitur dan mengaitkan kolom yang berisi nilai fitur dari sumber data BigQuery yang terdaftar untuk grup fitur.
Konsol
Gunakan petunjuk berikut untuk menambahkan fitur ke grup fitur yang ada menggunakan konsol Google Cloud.
Di bagian Vertex AI pada Konsol Google Cloud, buka halaman Feature Store.
Di bagian Feature groups, klik
di baris yang sesuai dengan grup fitur tempat Anda ingin menambahkan fitur, lalu klik Add features.Untuk setiap fitur, masukkan Feature name, lalu klik nama kolom sumber BigQuery yang sesuai dalam daftar. Untuk menambahkan fitur lainnya, klik Tambahkan fitur lain.
Klik Create.
REST
Untuk membuat resource Feature
, kirim permintaan POST
menggunakan
metode
features.create.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- LOCATION_ID: Region tempat grup fitur berada, misalnya
us-central1
. - PROJECT_ID: Project ID Anda.
- FEATUREGROUP_NAME: Nama grup fitur tempat Anda ingin membuat fitur tersebut.
- FEATURE_NAME: Nama fitur baru yang ingin Anda buat.
- VERSION_COLUMN_NAME: Opsional: Kolom dari tabel atau tampilan BigQuery yang ingin dikaitkan dengan fitur tersebut. Jika Anda tidak menentukannya, parameter ini akan ditetapkan ke FEATURE_NAME, secara default.
Metode HTTP dan URL:
POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups/FEATUREGROUP_NAME/features?feature_id=FEATURE_NAME
Isi JSON permintaan:
{ "version_column_name": "VERSION_COLUMN_NAME" }
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/featureGroups/FEATUREGROUP_NAME/features?feature_id=FEATURE_NAME"
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/featureGroups/FEATUREGROUP_NAME/features?feature_id=FEATURE_NAME" | Select-Object -Expand Content
Anda akan melihat respons JSON yang mirip dengan berikut ini:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureGroups/FEATUREGROUP_NAME/features/FEATURE_NAME/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.aiplatform.v1.UpdateFeatureOperationMetadata", "genericMetadata": { "createTime": "2023-09-18T02:36:22.870679Z", "updateTime": "2023-09-18T02:36:22.870679Z" } } }
Langkah selanjutnya
Pelajari cara mencantumkan semua fitur dalam grup fitur.
Pelajari cara memperbarui fitur.
Pelajari cara menghapus fitur.
Pelajari cara memperbarui grup fitur.
Jenis penayangan online di Vertex AI Feature Store.