יצירת מופע של חנות וירטואלית

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

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

אחרי שיוצרים את החנות אונליין, אפשר להוסיף תצוגות של מאפיינים ולשייך אותן למקורות נתונים של מאפיינים ב-BigQuery.

אתם יכולים להצפין את המכונה של חנות האונליין שלכם על ידי ציון מפתח הצפנה בניהול הלקוח (CMEK) כשאתם יוצרים את המכונה של חנות האונליין. רק Bigtable online serving תומך בהצפנה באמצעות CMEK. כדי להבין יותר על היתרונות של שימוש ב-CMEK ולהבין אם CMEK שימושי לחנות האונליין שלכם, כדאי לעיין ביתרונות של CMEK.

שימוש במפתחות CMEK עשוי לכלול עלויות שימוש נוספות, בהתאם לסוג המפתח שבו נעשה שימוש. מידע נוסף על תמחור זמין במאמר בנושא תמחור של Cloud Key Management Service.

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

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

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

יצירת חנות וירטואלית להצגת נתונים אונליין ב-Bigtable

כשמשתמשים ב-Bigtable להצגת נתונים אונליין, אפשר להצפין את החנות הווירטואלית באמצעות CMEK.

יצירת חנות וירטואלית להצגת נתונים אונליין ב-Bigtable ללא CMEK

כדי ליצור מופע של חנות אונליין להצגת נתונים אונליין ב-Bigtable עם שינוי גודל אוטומטי, בלי לציין CMEK, משתמשים במסוף Cloud de Confiance או ב-API בארכיטקטורת REST.

from google.cloud import aiplatform
from vertexai.resources.preview import feature_store


def create_bigtable_feature_online_store_sample(
    project: str,
    location: str,
    feature_online_store_id: str,
):
    aiplatform.init(project=project, location=location)
    fos = feature_store.FeatureOnlineStore.create_bigtable_store(
        feature_online_store_id
    )
    return fos

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME

{
  "bigtable": {
    "auto_scaling": {
      "min_node_count": 1,
      "max_node_count": 3,
      "cpu_utilization_target": 50
    }
  }
}

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/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME"

$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/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand Content

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureOnlineStoreOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T17:49:23.847496Z",
      "updateTime": "2023-09-18T17:49:23.847496Z"
    }
  }
}

יצירת חנות אונליין שמשתמשת במפתח CMEK

כדי ליצור מופע של חנות וירטואלית להצגת נתונים אונליין ב-Bigtable שמוצפנים באמצעות CMEK, פועלים לפי השלבים הבאים.

שימוש בהצפנת CMEK עשוי לכלול עלויות שימוש נוספות, בהתאם לסוג המפתח שבו נעשה שימוש. מידע נוסף על תמחור זמין במאמר בנושא תמחור של Cloud Key Management Service.

1. שימוש ב-Cloud Key Management Service כדי להגדיר מפתח הצפנה בניהול הלקוח

2. כדי ליצור משאב FeatureOnlineStore, שולחים את בקשת POST הבאה באמצעות השיטה featureOnlineStores.create ומציינים את ה-CMEK.

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

   • ‫LOCATION_ID: האזור שבו רוצים ליצור את חנות האונליין, למשל us-central1.
   • ‫PROJECT_ID: מזהה הפרויקט.
   • ‫FEATUREONLINESTORE_NAME: השם של המופע החדש של החנות אונליין.
   • ‫BOOLEAN: אופציונלי: כדי ליצור חנות אונליין שתומכת בניהול הטמעה, מזינים true. ערך ברירת המחדל הוא false.
   • ‫KEY_NAME: השם של מפתח ההצפנה שרוצים להשתמש בו עבור מאגר המטא-נתונים הזה.

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

   POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME

   גוף בקשת JSON:

   {
     "bigtable": {
       "auto_scaling": {
         "min_node_count": 1,
         "max_node_count": 3,
         "cpu_utilization_target": 50
       }
     },
     "encryption_spec": {
       "kms_key_name": "KEY_NAME"
     }
   }
   

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

   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/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME"

   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/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand Content

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

   {
     "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/operations/OPERATION_ID",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureOnlineStoreOperationMetadata",
       "genericMetadata": {
         "createTime": "2023-09-18T17:49:23.847496Z",
         "updateTime": "2023-09-18T17:49:23.847496Z"
       }
     }
   }
   

יצירת חנות וירטואלית להצגה אופטימלית של מודעות אונליין

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

יצירת חנות וירטואלית להצגה אונליין אופטימלית עם נקודת קצה ציבורית

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

from google.cloud import aiplatform
from vertexai.resources.preview import feature_store


def create_optimized_public_feature_online_store_sample(
    project: str,
    location: str,
    feature_online_store_id: str,
):
    aiplatform.init(project=project, location=location)
    fos = feature_store.FeatureOnlineStore.create_optimized_store(
        feature_online_store_id
    )
    return fos

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME

{
  "optimized": {}
}

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/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME"

$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/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand Content

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureOnlineStoreOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T17:49:23.847496Z",
      "updateTime": "2023-09-18T17:49:23.847496Z"
    }
  }
}

יצירת חנות וירטואלית להצגה אונליין אופטימלית עם נקודת קצה מסוג Private Service Connect

בדוגמאות הבאות מוסבר איך ליצור חנות אונליין למילוי בקשה באופן מיידי אופטימלי באמצעות Private Service Connect.

from typing import List

from google.cloud import aiplatform
from vertexai.resources.preview import feature_store


def create_optimized_private_feature_online_store_sample(
    project: str,
    location: str,
    feature_online_store_id: str,
    project_allowlist: List[str],
):
    aiplatform.init(project=project, location=location)
    fos = feature_store.FeatureOnlineStore.create_optimized_store(
        name=feature_online_store_id,
        enable_private_service_connect=True,
        project_allowlist=project_allowlist,
    )
    return fos

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME

{
  "optimized": {},
  "dedicated_serving_endpoint": {
    "private_service_connect_config": {
      "enable_private_service_connect": true,
      "project_allowlist": ["PROJECT_NAMES"]
    }
  }
}

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/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME"

$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/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand Content

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureOnlineStoreOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T17:49:23.847496Z",
      "updateTime": "2023-09-18T17:49:23.847496Z"
    }
  }
}

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

• איך יוצרים תצוגת תכונות

• איך מעדכנים חנות אונליין