Membuat grup fitur

Anda dapat membuat grup fitur untuk mendaftarkan tabel atau tampilan BigQuery yang berisi data fitur Anda.

Untuk setiap tabel atau tampilan BigQuery yang dikaitkan dengan grup fitur, Anda harus memastikan hal-hal berikut:

  • Skema sumber data sesuai dengan Panduan persiapan sumber data.

  • Sumber data berisi ID entity sebagai nilai string dalam kolom bernama entity_id.

  • Sumber data berisi stempel waktu fitur jenis timestamp dalam kolom bernama feature_timestamp.

Setelah membuat grup fitur dan mengaitkan sumber data BigQuery, Anda dapat membuat fitur untuk dikaitkan dengan kolom dalam sumber data. Menentukan sumber data saat membuat grup fitur bersifat opsional. Namun, Anda harus menentukan sumber data sebelum membuat fitur.

Mendaftarkan sumber data Anda menggunakan fitur dan grup fitur memiliki beberapa keuntungan berikut:

  • Anda dapat menentukan tampilan fitur untuk penyaluran 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 grup fitur dan mengaitkan sumber data BigQuery.

Konsol

Gunakan petunjuk berikut untuk membuat grup fitur menggunakan Konsol Google Cloud.

  1. Di bagian Vertex AI pada Konsol Google Cloud, buka halaman Feature Store.

    Buka halaman Feature Store

  2. Di bagian Feature groups, klik Create untuk membuka panel Basic info di halaman Create Feature Group.

  3. Menentukan Feature group name.

  4. Opsional: Untuk menambahkan label, klik Tambahkan label, lalu tentukan nama dan nilai label. Anda dapat menambahkan beberapa label ke grup fitur.

  5. Di kolom BigQuery path, klik Browse untuk memilih tabel sumber atau tampilan BigQuery yang akan dikaitkan dengan grup fitur.

  6. Opsional: Dalam daftar Kolom ID Entitas, klik kolom ID entitas dari tabel atau tampilan sumber BigQuery.

  7. Klik Lanjutkan.

  8. Di panel Register, klik salah satu opsi berikut untuk menunjukkan apakah Anda ingin menambahkan fitur ke grup fitur baru:

    • Sertakan semua kolom dari tabel BigQuery—Membuat fitur dalam grup fitur untuk semua kolom di tabel atau tampilan sumber BigQuery.

    • Memasukkan fitur secara manual—Buat fitur berdasarkan kolom tertentu di sumber BigQuery. Untuk setiap fitur, masukkan Feature name, lalu klik nama kolom sumber BigQuery yang sesuai dalam daftar.

      Untuk menambahkan fitur lainnya, klik Tambahkan fitur lainnya.

    • Buat grup fitur kosong—Buat grup fitur tanpa menambahkan fitur ke dalamnya.

  9. Klik Create.

REST

Untuk membuat resource FeatureGroup, kirim permintaan POST menggunakan metode featureGroups.create.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • LOCATION_ID: Region tempat Anda ingin membuat grup fitur, misalnya us-central1.
  • PROJECT_ID: Project ID Anda.
  • FEATUREGROUP_NAME: Nama grup fitur baru yang ingin Anda buat.
  • BIGQUERY_SOURCE_URI: URI tabel atau tampilan sumber BigQuery yang ingin Anda daftarkan untuk grup fitur.

Metode HTTP dan URL:

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups?feature_group_id=FEATUREGROUP_NAME

Isi JSON permintaan:

{
  "big_query": {
    "big_query_source": {
      "input_uri": "BIGQUERY_SOURCE_URI"
    }
  }
}

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?feature_group_id=FEATUREGROUP_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?feature_group_id=FEATUREGROUP_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/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.UpdateFeatureGroupOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T03:00:13.060636Z",
      "updateTime": "2023-09-18T03:00:13.060636Z"
    }
  }
}

Langkah selanjutnya