Memperbarui fitur

Dalam sebuah grup fitur, Anda dapat memperbarui fitur untuk mengaitkannya dengan kolom spesifik dalam sumber data BigQuery yang terkait dengan grup fitur tersebut.

Saat membuat atau memperbarui fitur, Anda memiliki opsi untuk menambahkan metadata yang ditentukan pengguna dalam bentuk label ke fitur tersebut. Untuk mengetahui informasi selengkapnya tentang cara memperbarui label yang ditentukan pengguna untuk fitur, lihat Memperbarui label untuk fitur.

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 Mengautentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud .

Memperbarui fitur

Gunakan contoh berikut untuk memperbarui fitur dalam grup fitur.

REST

Untuk mengupdate resource Feature, kirim permintaan PATCH menggunakan metode features.patch.

Sebelum menggunakan salah satu data permintaan, lakukan proses penggantian berikut:

  • LOCATION_ID: Region tempat grup fitur yang berisi fitur berada, seperti us-central1.
  • PROJECT_ID: Project ID Anda.
  • FEATURE_GROUP_NAME: Nama grup fitur yang berisi fitur.
  • FEATURE_NAME: Nama fitur yang ingin diperbarui.
  • VERSION_COLUMN_NAME: Kolom dari tabel atau tampilan sumber BigQuery yang ingin Anda kaitkan saat memperbarui fitur.

Metode HTTP dan URL: 

PATCH https://LOCATION_ID-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_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 PATCH \
     -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/v1beta1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_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 PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_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/FEATURE_GROUP_NAME/features/FEATURE_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1beta1.UpdateFeatureOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T02:36:22.870679Z",
      "updateTime": "2023-09-18T02:36:22.870679Z"
    }
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1beta1.Feature",
    "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_NAME/features/FEATURE_NAME"
  }
}

Langkah berikutnya