删除特征值

您可以通过以下方式从实体类型中删除特征值：

从指定实体中删除特征值

您可以从某个实体类型中的多个实体删除特征值。如需指定要从中删除特征值的实体，您需要在 CSV 文件中列出实体 ID。

REST

如需删除特征值，请使用 featurestores.entityTypes.deleteFeatureValues 方法发出 POST 请求。

在使用任何请求数据之前，请先进行以下替换：

  • LOCATION_ID：在其中创建特征存储区的区域或位置。例如 us-central1。
  • PROJECT_ID：您的项目 ID。
  • FEATURESTORE_ID：特征存储区的 ID。
  • ENTITY_TYPE：要从中删除特征值的实体类型的 ID。
  • CSV_FILE_URI：指定 CSV 文件的 Cloud Storage URI，该文件包含要为其删除特征值的实体 ID。此文件的第一行应为以下之一：
    • 如果您指定 entity_id_field 参数，则 CSV 文件的第一行必须与 ENTITY_ID_FIELD 相同。
    • 如果您未指定 entity_id_field 参数，则 CSV 文件的第一行必须为“entity_id”。
  • ENTITY_ID_FIELD：（可选）输入位于 CSV_FILE_URI 的 CSV 文件的第一行中指定的字符串。

HTTP 方法和网址：

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

将请求正文保存在名为 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：从删除特征值的 POST 请求收到的 JSON 响应中的“name”字段的值。

HTTP 方法和网址：

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) 和一个空响应。

从指定特征删除某个时间范围内的特征值

您可以指定特征 ID 和时间范围，以从某个实体类型中删除特征值。

REST

如需从某个实体类型中删除特征值，请使用 featurestores.entityTypes.deleteFeatureValues 方法发送 POST 请求。

在使用任何请求数据之前，请先进行以下替换：

  • LOCATION_ID：在其中创建特征存储区的区域或位置。例如 us-central1。
  • PROJECT_ID：您的项目 ID。
  • FEATURESTORE_ID：特征存储区的 ID。
  • ENTITY_TYPE：要从中删除特征值的实体类型的 ID。
  • START_TIME：指定时间范围的开始时间。
  • END_TIME：（可选）指定时间范围的结束时间。
  • SKIP_ONLINE_STORAGE_DELETE：（可选）如需从在线存储空间以及离线存储空间中删除特征值，请输入 false。否则，如需仅从离线存储空间中删除特征值，请输入 true。

HTTP 方法和网址：

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：从删除特征值的 POST 请求收到的 JSON 响应中的“name”字段的值。

HTTP 方法和网址：

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 配额和限制。