עדכון תכונות בתצוגת תכונות

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

  • אתם רוצים לכתוב תכונות לחנות אונליין מהר יותר מסנכרון באצ'ים, תוך שמירה על רעננות הנתונים ב-100 אלפיות השנייה או פחות.

  • רוצים לאחזר את חותמת הזמן שבה התכונה נכתבת בחנות אונליין.

‫Vertex AI Feature Store לא מעדכן את מקור נתוני התכונות ב-BigQuery על סמך נתוני התכונות שנכתבו ישירות למופע של תצוגת תכונות. במהלך סנכרון הנתונים, Vertex AI Feature Store מעדכן את תצוגת התכונות עם ערך התכונה שכולל את חותמת הזמן העדכנית ביותר. לדוגמה, אם מעדכנים ערך של פיצ'ר ישירות בתצוגת פיצ'ר, ואז מעדכנים את אותו פיצ'ר במקור BigQuery, Vertex AI Feature Store מעדכן את תצוגת הפיצ'ר עם הערך המעודכן האחרון של הפיצ'ר מ-BigQuery במהלך סנכרון הנתונים הבא.

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

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

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

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

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

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

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

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

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

עדכון תכונות ישירות בתצוגת תכונות

אפשר להשתמש בדוגמה הבאה כדי לכתוב תכונות לישות בתצוגת תכונות.

REST

כדי לכתוב ערכי תכונות ישירות למופע FeatureView, שולחים בקשת POST באמצעות השיטה featureViews.directWrite.

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

  • ‫LOCATION_ID: האזור של תצוגת התכונות שבו רוצים לכתוב את התכונות, למשל us-central1.
  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫FEATUREONLINESTORE_NAME: השם של מופע החנות אונליין שמכיל את תצוגת התכונות.
  • ‫FEATUREVIEW_NAME: השם של מופע התצוגה החדש של התכונות שרוצים לכתוב.
  • ‫ENTITY_ID: מזהה הישות שעבורה רוצים להוסיף ערכי תכונות.
  • ‫FEATURE_1 ו-FEATURE_2: התכונות שרוצים להוסיף.
  • ‫FEATURE_1_VALUE ו-FEATURE_2_VALUE: ערכי התכונות של FEATURE_1 ו-FEATURE_2, בהתאמה.

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

POST https://LOCATION_ID-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME:directWrite

גוף בקשת JSON: 

[
  {
      "feature_view": "LOCATION_ID-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME",
      "data_key_and_feature_values": {
        "data_key": {
          "key": "ENTITY_ID"
        },
        "features": [{
          "name": "FEATURE_1",
          "value_and_timestamp": {
            "value": {
              "string_value": "FEATURE_1_VALUE"
            }
          }
        },
        {
          "name": "FEATURE_2",
          "value_and_timestamp": {
            "value": {
              "string_value": "FEATURE_2_VALUE"
            }
          }
        }
      ]
    }
  }
]

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

curl

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה: 

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/v1beta1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME:directWrite"

PowerShell

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה: 

$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/v1beta1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME:directWrite" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "status": {},
  "writeResponses": [
    {
      "dataKey": {
        "key": "ENTITY_ID"
      },
      "onlineStoreWriteTime": "2025-04-01T01:30:09.525061Z"
    }
  ]
}

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