Featurewerte löschen

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_field angeben, muss die erste Zeile der CSV-Datei mit ENTITY_ID_FIELD übereinstimmen.
    • Wenn Sie den Parameter entity_id_field nicht angeben, muss die erste Zeile der CSV-Datei „entity_id” sein.
  • 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 http://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 \
     "http://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 "http://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 http://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)" \
     "http://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 "http://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 false ein, 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 Sie true ein.

HTTP-Methode und URL:

POST http://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 \
     "http://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 "http://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 http://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)" \
     "http://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 "http://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