So löschen Sie Feature-Werte aus einem Entitätstyp:
Feature-Werte aus angegebenen Entitäten löschen
Sie können Feature-Werte aus mehreren Entitäten innerhalb eines Entitätstyps löschen. Wenn Sie die Entitäten angeben möchten, aus denen die Feature-Werte gelöscht werden sollen, müssen Sie die Entitäts-IDs in einer CSV-Datei auflisten.
REST
Senden Sie mit der Methode featurestores.entityTypes.deleteFeatureValues eine POST-Anfrage, um Feature-Werte zu löschen.
Ersetzen Sie dabei folgende Werte für die Anfragedaten:
- LOCATION_ID: Region oder Standort, in der der Featurestore erstellt wird. Beispiel:
us-central1. - PROJECT_ID: Ihre Projekt-ID.
- FEATURESTORE_ID: ID des Featurestores.
- ENTITY_TYPE ist die ID des Entitätstyps, aus dem Sie die Feature-Werte löschen möchten.
- CSV_FILE_URI: Geben Sie den Cloud Storage-URI der CSV-Datei mit den Entitäts-IDs an, für die Sie Feature-Werte löschen möchten. Die erste Zeile dieser Datei muss eine der folgenden sein:
- Wenn Sie den Parameter
entity_id_fieldangeben, muss die erste Zeile der CSV-Datei mit ENTITY_ID_FIELD übereinstimmen. - Wenn Sie den Parameter
entity_id_fieldnicht angeben, muss die erste Zeile der CSV-Datei „entity_id” sein.
- Wenn Sie den Parameter
- ENTITY_ID_FIELD: (Optional) Geben Sie den in der ersten Zeile der CSV-Datei angegebenen String unter CSV_FILE_URI ein.
HTTP-Methode und URL:
POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE:deleteFeatureValues
JSON-Text der Anfrage:
{
"selectEntity": {
"entityIdSelector": {
"csv_source": {
"gcs_source": {
"uris": [
"CSV_FILE_URI"
]
},
"entity_id_field": "ENTITY_ID_FIELD"
}
}
}
}
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:
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
Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:
$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
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{
"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"
]
}
}
}
Anfragestatus ansehen
Senden Sie die folgende GET-Anfrage, um den Status der POST-Anfrage zu prüfen.
Ersetzen Sie dabei folgende Werte für die Anfragedaten:
- LOCATION_ID: Region oder Standort, in der der Featurestore erstellt wird. Beispiel:
us-central1. - OPERATION_NAME: Der Wert des Felds „name” in der JSON-Antwort, die von der POST-Anfrage zum Löschen von Featurewerten empfangen wurde.
HTTP-Methode und URL:
GET https://LOCATION_ID-aiplatform.googleapis.com/v1/OPERATION_NAME
Senden Sie die Anfrage mithilfe einer der folgenden Optionen:
curl
Führen Sie folgenden Befehl aus:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://LOCATION_ID-aiplatform.googleapis.com/v1/OPERATION_NAME"
PowerShell
Führen Sie folgenden Befehl aus:
$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
Sie sollten einen erfolgreichen Statuscode (2xx) und eine leere Antwort als Ausgabe erhalten.
Feature-Werte aus angegebenen Features innerhalb eines Zeitraums löschen
Sie können Feature-Werte aus einem Entitätstyp löschen, indem Sie die Feature-IDs und einen Zeitraum angeben.
REST
Senden Sie mit der Methode featurestores.entityTypes.deleteFeatureValues eine POST-Anfrage, um Feature-Werte aus einem Entitätstyp zu löschen.
Ersetzen Sie dabei folgende Werte für die Anfragedaten:
- LOCATION_ID: Region oder Standort, in der der Featurestore erstellt wird. Beispiel:
us-central1. - PROJECT_ID: Ihre Projekt-ID.
- FEATURESTORE_ID: ID des Featurestores.
- ENTITY_TYPE ist die ID des Entitätstyps, aus dem Sie die Feature-Werte löschen möchten.
- START_TIME: Geben Sie die Startzeit des Zeitraums an.
- END_TIME: (Optional) Geben Sie die Endzeit des Zeitraums an.
- SKIP_ONLINE_STORAGE_DELETE: (Optional) Geben Sie
falseein, um Featurewerte aus dem Onlinespeicher und aus dem Offlinespeicher zu löschen. Wenn Sie nur Feature-Werte aus dem Offlinespeicher löschen möchten, geben Sietrueein.
HTTP-Methode und URL:
POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featurestores/FEATURESTORE_ID/entityTypes/ENTITY_TYPE:deleteFeatureValues
JSON-Text der Anfrage:
{
"selectTimeRangeAndFeature": {
"timeRange": {
"startTime": "START_TIME",
"endTime": "END_TIME"
},
"featureSelector": {
"idMatcher": {
"ids": [ "FEATURE_ID", ...]
}
},
"skipOnlineStorageDelete": SKIP_ONLINE_STORAGE_DELETE
}
}
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:
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
Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:
$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
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{
"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"
]
}
}
}
Anfragestatus ansehen
Senden Sie die folgende GET-Anfrage, um den Status der POST-Anfrage zu prüfen.
Ersetzen Sie dabei folgende Werte für die Anfragedaten:
- LOCATION_ID: Region oder Standort, in der der Featurestore erstellt wird. Beispiel:
us-central1. - OPERATION_NAME: Der Wert des Felds „name” in der JSON-Antwort, die von der POST-Anfrage zum Löschen von Featurewerten empfangen wurde.
HTTP-Methode und URL:
GET https://LOCATION_ID-aiplatform.googleapis.com/v1/OPERATION_NAME
Senden Sie die Anfrage mithilfe einer der folgenden Optionen:
curl
Führen Sie folgenden Befehl aus:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://LOCATION_ID-aiplatform.googleapis.com/v1/OPERATION_NAME"
PowerShell
Führen Sie folgenden Befehl aus:
$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
Sie sollten einen erfolgreichen Statuscode (2xx) und eine leere Antwort als Ausgabe erhalten.
Nächste Schritte
Kontingente und Limits für Vertex AI Feature Store