מחיקת ערכי מאפיינים

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

מחיקת ערכי תכונות מישויות שצוינו
מחיקת ערכי מאפיינים ממאפיינים שצוינו בטווח זמן מסוים

מחיקת ערכי תכונות מישויות ספציפיות

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

REST

כדי למחוק ערכי מאפיינים, שולחים בקשת POST באמצעות השיטה featurestores.entityTypes.deleteFeatureValues.

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

‫LOCATION_ID: האזור או המיקום שבהם נוצר מאגר התכונות. לדוגמה, us-central1.
‫PROJECT_ID: מזהה הפרויקט.
‫FEATURESTORE_ID: מזהה של מאגר התכונות.
‫ENTITY_TYPE: המזהה של סוג הישות שממנה רוצים למחוק את ערכי התכונות.
‫CSV_FILE_URI: מציינים את ה-URI של Cloud Storage של קובץ ה-CSV שמכיל את מזהי הישויות שרוצים למחוק את ערכי התכונות שלהן. השורה הראשונה בקובץ צריכה להיות אחת מהאפשרויות הבאות:
- אם מציינים את הפרמטר entity_id_field, השורה הראשונה בקובץ ה-CSV חייבת להיות זהה ל-ENTITY_ID_FIELD.
- אם לא מציינים את הפרמטר entity_id_field, השורה הראשונה בקובץ ה-CSV צריכה להיות entity_id.
‫ENTITY_ID_FIELD: (אופציונלי) מזינים את המחרוזת שצוינה בשורה הראשונה של קובץ ה-CSV ב-CSV_FILE_URI.

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

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE:deleteFeatureValues

גוף בקשת JSON:

{
  "selectEntity": {
    "entityIdSelector": {
      "csv_source": {
        "gcs_source": {
          "uris": [
            "CSV_FILE_URI"
          ]
        },
        "entity_id_field": "ENTITY_ID_FIELD"
      }
    }
  }
}

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

curl

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם 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/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE:deleteFeatureValues"

PowerShell

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם 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/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE:deleteFeatureValues" | Select-Object -Expand Content

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

{
  "name": "projects/571445526053/locations/us-central1/operations/7688824614775947264",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.DeleteFeatureValuesOperationMetadata",
    "genericMetadata": {
      "createTime": "2022-05-09T16:59:38.128375Z",
      "updateTime": "2022-05-09T16:59:38.128375Z",
      "state": "RUNNING",
      "worksOn": [
        "projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID"
      ]
    }
  }
}

צפייה בסטטוס הבקשה

כדי לבדוק את הסטטוס של בקשת ה-POST, שולחים את בקשת ה-GET הבאה.

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

‫LOCATION_ID: האזור או המיקום שבהם נוצר מאגר התכונות. לדוגמה, us-central1.
‫OPERATION_NAME: הערך של השדה 'name' בתגובת ה-JSON שהתקבלה מבקשת ה-POST למחיקת ערכי תכונות.

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

GET https://LOCATION_ID-aiplatform.googleapis.com/v1/OPERATION_NAME

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

curl

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

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

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/OPERATION_NAME" | Select-Object -Expand Content

אמור להתקבל קוד סטטוס של הצלחה (2xx) ותגובה ריקה.

מחיקת ערכים של תכונות מתכונות שצוינו בטווח זמן מסוים

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

REST

כדי למחוק ערכי תכונות מסוג ישות, שולחים בקשת POST באמצעות השיטה featurestores.entityTypes.deleteFeatureValues.

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

‫LOCATION_ID: האזור או המיקום שבהם נוצר מאגר התכונות. לדוגמה, us-central1.
‫PROJECT_ID: מזהה הפרויקט.
‫FEATURESTORE_ID: מזהה של מאגר התכונות.
‫ENTITY_TYPE: המזהה של סוג הישות שממנה רוצים למחוק את ערכי התכונות.
‫START_TIME: ציון שעת ההתחלה של טווח הזמן.
‫END_TIME: (אופציונלי) מציינים את שעת הסיום של טווח הזמן.

הערה: אם מציינים את הפרמטר START_TIME בלי לציין את הפרמטר END_TIME, הבקשה תמחק את ערכי התכונות ממזהי התכונות שצוינו עד לזמן הנוכחי (כשנשלחת הבקשה).
‫SKIP_ONLINE_STORAGE_DELETE: (אופציונלי) כדי למחוק ערכי תכונות מהאחסון באינטרנט וגם מהאחסון במצב אופליין, מזינים false. אחרת, כדי למחוק ערכי תכונות רק מהאחסון במצב אופליין, מזינים true.

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

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE:deleteFeatureValues

גוף בקשת JSON:

{
  "selectTimeRangeAndFeature": {
    "timeRange": {
      "startTime": "START_TIME",
      "endTime": "END_TIME"
    },
    "featureSelector": {
      "idMatcher": {
        "ids": [ "FEATURE_ID", ...]
      }
    },
    "skipOnlineStorageDelete": SKIP_ONLINE_STORAGE_DELETE
  }
}

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

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/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE:deleteFeatureValues"

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/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE:deleteFeatureValues" | Select-Object -Expand Content

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

{
  "name": "projects/571445526053/locations/us-central1/operations/7688824614775947264",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.DeleteFeatureValuesOperationMetadata",
    "genericMetadata": {
      "createTime": "2022-05-09T16:59:38.128375Z",
      "updateTime": "2022-05-09T16:59:38.128375Z",
      "state": "RUNNING",
      "worksOn": [
        "projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE_ID"
      ]
    }
  }
}

צפייה בסטטוס הבקשה

כדי לבדוק את הסטטוס של בקשת ה-POST, שולחים את בקשת ה-GET הבאה.

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

‫LOCATION_ID: האזור או המיקום שבהם נוצר מאגר התכונות. לדוגמה, us-central1.
‫OPERATION_NAME: הערך של השדה 'name' בתגובת ה-JSON שהתקבלה מבקשת ה-POST למחיקת ערכי תכונות.

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

GET https://LOCATION_ID-aiplatform.googleapis.com/v1/OPERATION_NAME

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

curl

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

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

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/OPERATION_NAME" | Select-Object -Expand Content

אמור להתקבל קוד סטטוס של הצלחה (2xx) ותגובה ריקה.

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

מכסות ומגבלות ב-Vertex AI Feature Store

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

מחיקת ערכי תכונות מישויות ספציפיות

REST

curl

PowerShell

צפייה בסטטוס הבקשה

curl

PowerShell

מחיקת ערכים של תכונות מתכונות שצוינו בטווח זמן מסוים

REST

curl

PowerShell

צפייה בסטטוס הבקשה

curl

PowerShell

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

מחיקת ערכי מאפיינים