Featuredaten mit dem Onlinespeicher synchronisieren

Bei der Datensynchronisierung werden die Daten in einer Featureansicht in einem Onlinespeicher aus der Feature-Datenquelle in BigQuery aktualisiert oder synchronisiert. Um die Daten für den gesamten Onlinespeicher zu synchronisieren, müssen Sie die Daten für alle Featureansichten synchronisieren.

Es gibt zwei Möglichkeiten, wie die Datensynchronisierung für eine Featureansicht durchgeführt wird:

  • Geplante Datensynchronisierung: Die Featuredaten werden automatisch gemäß dem für die Featureansicht konfigurierten Synchronisierungsplan mit dem Parameter FeatureView.sync_config aktualisiert.

  • Manuelle Datensynchronisierung: Sie können die Wartezeit zwischen zwei geplanten Datensynchronisierungsvorgängen überspringen. Starten Sie dazu die Datensynchronisierung für eine Featureansicht manuell.

Die Datensynchronisierung kann Kosten für die BigQuery-Ressourcennutzung verursachen. Informationen zum Optimieren der Kosten beim Festlegen des Synchronisierungsplans für eine Featureansicht finden Sie unter Kosten während der Synchronisierung optimieren.

Hinweise

Authentifizieren Sie sich bei Vertex AI, sofern nicht bereits geschehen.

Verwenden Sie die von der gcloud CLI bereitgestellten Anmeldedaten, um die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung zu verwenden.

    Install the Google Cloud CLI, then initialize it by running the following command: 

    gcloud init

Weitere Informationen finden Sie unter Für die Verwendung von REST authentifizieren in der Dokumentation zur Google Cloud-Authentifizierung.

Datensynchronisierung manuell starten

Verwenden Sie das folgende Beispiel, um die Datensynchronisierung manuell in einer Featureansicht zu starten. Beachten Sie, dass für eine Featureansicht jeweils nur ein Datensynchronisierungsvorgang aktiv sein kann. Wenn Sie versuchen, die Datensynchronisierung manuell zu starten, während eine andere Synchronisierung läuft, wird der neue Synchronisierungsvorgang erst gestartet, wenn der laufende Synchronisierungsvorgang beendet ist.

REST

Um eine Datensynchronisierung manuell in einem FeatureView zu starten, senden Sie einePOST Anfrage mithilfe der Methode featureViews.sync.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • LOCATION_ID: Die Region, in der sich der Onlinespeicher befindet, z. B. us-central1.
  • PROJECT_ID ist die Projekt-ID.
  • FEATUREONLINESTORE_NAME: Der Name des Onlinespeichers, der die Featureansicht enthält.
  • FEATUREVIEW_NAME: Der Name der Featureansicht, für die Sie die Datensynchronisierung manuell starten möchten.

HTTP-Methode und URL:

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME:sync

Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

curl

Führen Sie folgenden Befehl aus: 

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME:sync"

PowerShell

Führen Sie folgenden Befehl aus: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME:sync" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "featureViewSync": "projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME/featureViewSyncs/OPERATION_ID"
}

Nächste Schritte