您可以通过以下方式从实体类型中删除特征值：
从指定实体中删除特征值
您可以从某个实体类型中的多个实体删除特征值。如需指定要从中删除特征值的实体，您需要在 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 http://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 \
"http://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 "http://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 http://LOCATION_ID-aiplatform.googleapis.com/v1/OPERATION_NAME
如需发送请求，请选择以下方式之一：
curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"http://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 "http://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 http://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 \
"http://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 "http://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 http://LOCATION_ID-aiplatform.googleapis.com/v1/OPERATION_NAME
如需发送请求，请选择以下方式之一：
curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"http://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 "http://LOCATION_ID-aiplatform.googleapis.com/v1/OPERATION_NAME" | Select-Object -Expand Content
您应该会收到一个成功的状态代码 (2xx) 和一个空响应。
后续步骤
查看 Vertex AI Feature Store 配额和限制。