הצגת קבוצות של תכונות

אתם יכולים לאחזר רשימה של כל קבוצות התכונות שנוצרו למיקום ספציפי ב Google Cloud פרויקט, יחד עם ה-URI של טבלת המקור או התצוגה של BigQuery שמשויכים לכל קבוצת תכונות.

אם קבוצת תכונות מוגדרת לשימוש בחשבון שירות ייעודי, הפרטים של קבוצת התכונות הזו כוללים גם את כתובת האימייל בחשבון השירות המשויך. מידע נוסף על יצירת קבוצות תכונות עם הגדרות ייעודיות של חשבון שירות זמין במאמר הגדרת חשבון השירות לקבוצת תכונות.

לפני שמתחילים

מאמתים את Gemini Enterprise Agent Platform, אלא אם כבר עשיתם זאת.

צריך לבחור את הכרטיסייה הרלוונטית לאופן שבו תכננתם להשתמש בדוגמאות בדף הזה:

המסוף

כשמשתמשים במסוף Google Cloud כדי לגשת לשירותים ולממשקי ה-API, לא צריך להגדיר אימות. Google Cloud

REST

כדי להשתמש בסביבת פיתוח מקומית בדוגמאות של API בארכיטקטורת REST שבדף הזה, צריך להשתמש בפרטי הכניסה שאתם נותנים ל-CLI של gcloud.

    התקינו את ה-CLI של Google Cloud.

    אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

מידע נוסף מופיע במאמר אימות לשימוש ב-REST במסמכי האימות של Google Cloud .

רשימת קבוצות של תכונות

בדוגמאות הבאות מוסבר איך לאחזר רשימה של כל קבוצות התכונות למיקום ספציפי בפרויקט.

המסוף

כדי לראות את רשימת קבוצות התכונות למיקום ספציפי באמצעות מסוף Google Cloud , פועלים לפי ההוראות הבאות.

  1. בקטע Agent Platform במסוף Google Cloud , עוברים לדף Feature Store.

    כניסה לדף Feature Store

  2. בקטע קבוצות תכונות, אפשר לראות את רשימת כל קבוצות התכונות של המיקום שנבחר.

REST

כדי לאחזר רשימה של כל משאבי FeatureGroup במיקום ספציפי בפרויקט, שולחים בקשת GET באמצעות השיטה featureGroups.list.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

  • ‫LOCATION_ID: האזור שרוצים להציג את רשימת קבוצות התכונות שלו, למשל us-central1.
  • ‫PROJECT_ID: מזהה הפרויקט.

ה-method של ה-HTTP וכתובת ה-URL: 

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

כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:

curl

מריצים את הפקודה הבאה: 

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

מריצים את הפקודה הבאה: 

$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
אתם אמורים לקבל תגובת JSON שדומה לזו: ‫BIGQUERY_URI_1 היא טבלת המקור או התצוגה המפורטת ב-BigQuery שרשומות באמצעות FEATURE_GROUP_NAME_1, ו-BIGQUERY_URI_2 היא טבלת המקור או התצוגה המפורטת ב-BigQuery שרשומות באמצעות FEATURE_GROUP_NAME_2.‫
אם לאחת מקבוצות התכונות שמופיעות בתשובה יש הגדרה ייעודית של חשבון שירות, כתובת האימייל בחשבון השירות תופיע גם בפרטים שלה. בדוגמה הזו, SERVICE_ACCOUNT_EMAIL היא כתובת האימייל בחשבון השירות שמשויך לקבוצת התכונות 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"
        }
      }
    }
  ]
}

המאמרים הבאים