Membuat daftar grup fitur

Anda dapat mengambil daftar semua grup fitur yang dibuat untuk lokasi tertentu dalam project Google Cloud , beserta URI tabel atau tampilan sumber BigQuery yang terkait dengan setiap grup fitur.

Jika grup fitur dikonfigurasi untuk menggunakan akun layanan khusus, maka detail untuk grup fitur tersebut juga mencakup alamat email akun layanan yang terkait. Untuk mengetahui informasi selengkapnya tentang cara membuat grup fitur dengan konfigurasi akun layanan khusus, lihat Mengonfigurasi akun layanan untuk grup fitur.

Sebelum memulai

Lakukan autentikasi ke Vertex AI, kecuali jika Anda telah melakukannya.

Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:

Konsol

Saat menggunakan konsol Google Cloud untuk mengakses layanan Google Cloud dan API, Anda tidak perlu menyiapkan autentikasi.

REST

Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

    Instal Google Cloud CLI.

    Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud .

Membuat daftar grup fitur

Gunakan contoh berikut untuk mengambil daftar semua grup fitur untuk lokasi tertentu di project Anda.

Konsol

Gunakan petunjuk berikut untuk melihat daftar grup fitur untuk lokasi tertentu menggunakan konsol Google Cloud .

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

    Buka halaman Feature Store

  2. Di bagian Grup fitur, Anda dapat melihat daftar semua grup fitur untuk lokasi yang dipilih.

REST

Untuk mengambil daftar semua resource FeatureGroup untuk lokasi tertentu di proyek Anda, kirim permintaan GET menggunakan metode featureGroups.list.

Sebelum menggunakan data permintaan mana pun, lakukan penggantian berikut:

  • LOCATION_ID: Region tempat Anda ingin melihat daftar grup fitur, seperti us-central1.
  • PROJECT_ID: Project ID Anda.

Metode HTTP dan URL: 

GET https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Jalankan perintah berikut: 

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups"

PowerShell

Jalankan perintah berikut: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups" | Select-Object -Expand Content
Anda akan menerima respons JSON yang mirip dengan berikut ini. BIGQUERY_URI_1 adalah tabel atau tampilan sumber BigQuery yang terdaftar melalui FEATURE_GROUP_NAME_1 dan BIGQUERY_URI_2 adalah tabel atau tampilan sumber BigQuery yang terdaftar dengan FEATURE_GROUP_NAME_2.
Jika ada grup fitur yang tercantum dalam respons memiliki konfigurasi akun layanan khusus, maka alamat email akun layanan juga tercantum dalam detailnya. Dalam contoh ini, SERVICE_ACCOUNT_EMAIL adalah alamat email akun layanan yang terkait dengan grup fitur FEATURE_GROUP_NAME_1. 
{
  "featureGroups": [
    {
      "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_NAME_1",
      "createTime": "2023-09-07T00:57:00.142639Z",
      "updateTime": "2023-09-07T00:57:00.142639Z",
      "etag": "AMEw9yOY0byP8qKsDY0DoZyouAtX23zDru2l422C0affZZPYNFOGgIrONELNrM49uH4=",
      "bigQuery": {
        "bigQuerySource": {
          "inputUri": "BIGQUERY_URI_1"
        }
      }
      "serviceAccountEmail": "SERVICE_ACCOUNT_EMAIL"
    },
    {
      "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_NAME_2",
      "createTime": "2023-09-06T23:14:30.795502Z",
      "updateTime": "2023-09-06T23:14:30.795502Z",
      "etag": "AMEw9yO5UfrPWobGR2Ry-PnbJUQoklW5lX0uW4JmKqj6OgQui6p-rMdUHfuENpQjbJ3t",
      "bigQuery": {
        "bigQuerySource": {
          "inputUri": "BIGQUERY_URI_2"
        }
      }
    }
  ]
}

Langkah berikutnya