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, detail untuk grup fitur tersebut juga akan menyertakan alamat email akun layanan terkait. Untuk 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.

Select the tab for how you plan to use the samples on this page:

Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

REST

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

    After installing the Google Cloud CLI, initialize it by running the following command: 

    gcloud init

    If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

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 Google Cloud konsol, 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 salah satu grup fitur yang tercantum dalam respons memiliki konfigurasi akun layanan khusus, alamat email akun layanan juga akan 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