Featureansicht aktualisieren

Sie können eine Featureansicht aktualisieren, um die Liste der zugehörigen Feature-Datenquellen zu ändern. Sie können beispielsweise die folgenden Aktualisierungen vornehmen:

Verknüpfen Sie eine andere Funktionsgruppe und Funktionen oder eine andere Gruppe von Features aus derselben Featuregruppe.
Geben Sie eine BigQuery-Tabelle oder -Ansicht an, die die Featuredaten enthält. In diesem Fall müssen Sie eine oder mehrere Spalten für die Entitäts-ID angeben.

Beim Erstellen oder Aktualisieren einer Featureansicht haben Sie die Möglichkeit, benutzerdefinierte Metadaten in Form von Labels in die Featureansicht einzufügen. Weitere Informationen zum Aktualisieren benutzerdefinierter Labels für eine Featureansicht finden Sie unter Labels für eine Featureansicht aktualisieren.

Featureansicht basierend auf der Featuregruppe aktualisieren

Im folgenden Beispiel wird eine Featureansicht aktualisiert, indem Features aus einer vorhandenen Featuregruppe angegeben werden.

REST

Senden Sie zum Aktualisieren einer FeatureView-Ressource die Anfrage PATCH mit der Methode featureViews.patch.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

LOCATION_ID: Die Region, in der sich der Onlinespeicher befindet, z. B. us-central1.
PROJECT_ID: Ihre Projekt-ID.
FEATUREONLINESTORE_NAME: Der Name des Onlinespeichers, der die Featureansicht enthält.
FEATUREVIEW_NAME: Der Name der Featureansicht, die Sie löschen möchten.
FEATUREGROUP_NAME: Name der Featuregruppe, die Sie der Featureansicht zuordnen möchten.
FEATURE_ID_1 und FEATURE_ID_2: Feature-IDs, die Sie der Featureansicht aus der Featuregruppe FEATUREGROUP_NAME hinzufügen möchten.

HTTP-Methode und URL:

PATCH http://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME

JSON-Text der Anfrage:

{
  "feature_registry_source":
    { "feature_groups": [
      {
        "feature_group_id": "FEATUREGROUP_NAME",
        "feature_ids": [ "FEATURE_ID_1", "FEATURE_ID_2" ]
      }
    ]
  }
}

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

curl

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X PATCH \
     -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/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME"

PowerShell

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

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 PATCH `
    -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/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME" | Select-Object -Expand Content

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.UpdateFeatureViewOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-15T04:53:22.794004Z",
      "updateTime": "2023-09-15T04:53:22.794004Z"
    }
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.FeatureView",
    "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME"
  }
}

Featureansicht anhand einer BigQuery-Quelle aktualisieren

Im folgenden Beispiel können Sie eine Featureansicht aktualisieren, indem Sie Featurespalten aus einer BigQuery-Tabelle oder -Ansicht angeben.

REST

Um eine FeatureView-Instanz auf der Grundlage einer BigQuery-Datenquelle zu aktualisieren, senden Sie einePATCH-Anfrage mithilfe der featureViews.patch beenden.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

LOCATION_ID: Die Region, in der sich der Onlinespeicher befindet, z. B. us-central1.
PROJECT_ID: Ihre Projekt-ID.
FEATUREONLINESTORE_NAME: Der Name des Onlinespeichers, der die Featureansicht enthält.
FEATUREVIEW_NAME: Der Name der Featureansicht, die Sie aktualisieren möchten.
BIGQUERY_SOURCE_URI: URI der BigQuery-Tabelle oder -Ansicht, die die Featuredaten enthält.
ENTITY_ID_COLUMN: Name der Spalte, die die Entitäts-IDs enthält.

HTTP-Methode und URL:

PATCH http://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME

JSON-Text der Anfrage:

{
  "big_query_source":
  {
    "uri": "BIGQUERY_SOURCE_URI",
    "entity_id_columns": "ENTITY_ID_COLUMN"
  }
}

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 PATCH \
     -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/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME"

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 PATCH `
    -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/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME" | Select-Object -Expand Content

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.UpdateFeatureViewOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-15T04:53:34.832192Z",
      "updateTime": "2023-09-15T04:53:34.832192Z"
    }
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.FeatureView",
    "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME"
  }
}

Nächste Schritte

Onlinebereitstellung von Featuredaten starten
Erfahren Sie, wie Sie eine Featureansicht löschen.