Sie können ein Feature erstellen, nachdem Sie eine Featuregruppe erstellt und eine BigQuery-Tabelle oder BigQuery-Ansicht damit verknüpft haben. Sie können mehrere Features für eine Featuregruppe erstellen und jedes Feature mit einer bestimmten Spalte in der BigQuery-Datenquelle verknüpfen. Weitere Informationen zur Verwendung von BigQuery finden Sie in der BigQuery-Dokumentation.
Beispiel: Wenn die Funktionsgruppe featuregroup1
mit der BigQuery-Tabelle datasource_1
verknüpft ist und Featurewerte in den Spalten fval1
und fval2
enthält, können Sie ein Feature feature_1
unter featuregroup1
erstellen und es mit den Featurewerten in der Spalte fval1
verknüpfen.
Ebenso können Sie ein weiteres Feature namens feature_2
erstellen und den Featurewerten in der Spalte fval2
zuordnen.
Die Registrierung Ihrer Datenquelle mithilfe von Featuregruppen und Features bietet folgende Vorteile:
Sie können eine Featureansicht für die Onlinebereitstellung definieren. Verwenden Sie dazu bestimmte Featurespalten aus mehreren BigQuery-Datenquellen.
Sie können die Daten als Zeitreihe formatieren, indem Sie die Spalte
feature_timestamp
einfügen. Vertex AI Feature Store stellt nur die neuesten Featurewerte aus den Featuredaten bereit und schließt Verlaufsdaten aus.
Hinweise
Authentifizieren Sie sich bei Vertex AI, sofern nicht bereits geschehen.
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
REST
Verwenden Sie die von der gcloud CLI bereitgestellten Anmeldedaten, um die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung zu verwenden.
Installieren Sie die Google Cloud CLI und initialisieren Sie sie mit folgendem Befehl:
gcloud init
Weitere Informationen finden Sie unter Für die Verwendung von REST authentifizieren in der Dokumentation zur Google Cloud-Authentifizierung.
Ein Feature innerhalb einer Featuregruppe erstellen
In den folgenden Beispielen wird ein Feature innerhalb einer Featuregruppe erstellt und eine Spalte verknüpft, die Featurewerte aus der BigQuery-Datenquelle enthält, die für die Featuregruppe registriert ist.
Console
Gehen Sie nach der folgenden Anleitung vor, um einer vorhandenen Featuregruppe mithilfe der Google Cloud Console Features hinzuzufügen.
Rufen Sie im Abschnitt „Vertex AI“ der Google Cloud Console die Seite Feature Store auf.
Klicken Sie im Abschnitt der Featuregruppen auf
in der Zeile der Featuregruppe, der Sie ein Feature hinzufügen möchten, und klicken Sie dann auf Funktionen hinzufügen.Geben Sie für jedes Feature einen Featurenamen ein und klicken Sie in der Liste auf den Namen der BigQuery-Quellspalte. Wenn Sie weitere Features hinzufügen möchten, klicken Sie auf Weiteres Feature hinzufügen.
Klicken Sie auf Erstellen.
REST
Senden Sie zum Erstellen einer Feature
-Ressource eine POST
-Anfrage mit der Methode features.create.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- LOCATION_ID: Die Region, in der sich die Featuregruppe befindet, z. B.
us-central1
. - PROJECT_ID: Ihre Projekt-ID.
- FEATUREGROUP_NAME: Der Name der Featuregruppe, in der Sie das Feature erstellen möchten.
- FEATURE_NAME: Der Name des neuen Features, das Sie erstellen möchten.
- VERSION_COLUMN_NAME: Optional: Die Spalte aus der BigQuery-Tabelle oder -Ansicht, die Sie mit dem Feature verknüpfen möchten. Wenn Sie diesen Parameter nicht angeben, wird er standardmäßig auf FEATURE_NAME gesetzt.
HTTP-Methode und URL:
POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups/FEATUREGROUP_NAME/features?feature_id=FEATURE_NAME
JSON-Text der Anfrage:
{ "version_column_name": "VERSION_COLUMN_NAME" }
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/featureGroups/FEATUREGROUP_NAME/features?feature_id=FEATURE_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 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/featureGroups/FEATUREGROUP_NAME/features?feature_id=FEATURE_NAME" | Select-Object -Expand Content
Sie sollten in etwa folgende JSON-Antwort erhalten:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureGroups/FEATUREGROUP_NAME/features/FEATURE_NAME/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.aiplatform.v1.UpdateFeatureOperationMetadata", "genericMetadata": { "createTime": "2023-09-18T02:36:22.870679Z", "updateTime": "2023-09-18T02:36:22.870679Z" } } }
Nächste Schritte
Weitere Informationen zum Auflisten aller Features in einer Featuregruppe
Weitere Informationen zum Aktualisieren einer Featureansicht.
Online-Bereitstellungstypen in Vertex AI Feature Store.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2024-07-09 (UTC).