Eine Onlinespeicherinstanz erstellen

Zum Einrichten der Onlinebereitstellung müssen Sie zuerst eine Onlinespeicherinstanz für die Onlinebereitstellung von Bigtable oder die optimierte Onlinebereitstellung erstellen. Zum besseren Verständnis der Unterschiede zwischen der Onlinebereitstellung in Bigtable und der optimierten Onlinebereitstellung siehe Onlinebereitstellungstypen

Beachten Sie, dass Sie den Typ der Onlinebereitstellung nicht mehr ändern können, nachdem Sie beim Erstellen Ihres Onlineshops die Bigtable-Onlinebereitstellung oder die optimierte Onlinebereitstellung ausgewählt haben. Sie können aber die Konfiguration des Bereitstellungs-Endpunkts für eine Onlinespeicherinstanz ändern, die für eine optimierte Onlinebereitstellung erstellt wurde.

Nachdem Sie den Onlineshop erstellt haben, können Sie Featureansichten hinzufügen und diese Featureansichten mit Feature-Datenquellen in BigQuery verknüpfen.

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.

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.

Erstellen Sie einen Onlineshop für die Onlinebereitstellung von Bigtable.

Im folgenden Beispiel wird eine Onlineshop-Instanz für die Onlinebereitstellung von Bigtable mit Autoscaling erstellt.

Console

Gehen Sie nach der folgenden Anleitung vor, um einen Onlineshop für die Onlinebereitstellung von Bigtable mit der Google Cloud Console zu erstellen.

Rufen Sie im Abschnitt „Vertex AI“ der Google Cloud Console die Seite Feature Store auf.

Zur Seite „Feature Store“
Klicken Sie auf Onlineshop, um zum Abschnitt Onlineshop zu gelangen.
Klicken Sie auf Erstellen, um die Seite Onlineshop erstellen zu öffnen.
Geben Sie einen Namen für den Onlineshop an.
Optional: Klicken Sie auf Label hinzufügen und geben Sie den Namen und den Wert des Labels an. Sie können einem Onlineshop mehrere Labels hinzufügen.
Klicken Sie im Feld Speicherlösung für den Onlineshop wählen auf Bigtable.
Ändern Sie bei Bedarf die Minimale Knotenzahl, die Maximale Knotenzahl und das CPU-Auslastungsziel.
Klicken Sie auf Erstellen.

REST

Senden Sie zum Erstellen einer FeatureOnlineStore-Ressource eine POST-Anfrage mithilfe der Methode featureOnlineStores.create.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

LOCATION_ID: Region, in der Sie den Onlinespeicher erstellen möchten, z. B. us-central1.
PROJECT_ID: Ihre Projekt-ID.
FEATUREONLINESTORE_NAME: Der Name der neuen Onlineshopinstanz.
BOOLEAN: Optional: Geben Sie true ein, um einen Onlinespeicher zu erstellen, der die Einbettungsverwaltung unterstützt. Der Standardwert ist false.

HTTP-Methode und URL:

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME

JSON-Text der Anfrage:

{
  "bigtable": {
    "auto_scaling": {
      "min_node_count": 1,
      "max_node_count": 3,
      "cpu_utilization_target": 50
    }
  }
}

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 bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei 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 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/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME"

PowerShell

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI 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 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/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand Content

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureOnlineStoreOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T17:49:23.847496Z",
      "updateTime": "2023-09-18T17:49:23.847496Z"
    }
  }
}

Onlinespeicher für optimierte Onlinebereitstellung erstellen

Wenn Sie die optimierte Onlinebereitstellung verwenden, können Sie den Onlinespeicher so konfigurieren, dass Features von einem öffentlichen Endpunkt oder einem dedizierten Private Service Connect-Endpunkt bereitgestellt werden. Verwenden Sie einen Private Service Connect-Endpunkt, wenn Sie Features in einem VPC-Netzwerk mit niedrigeren Latenzen als bei einem öffentlichen Endpunkt typisch bereitstellen möchten.

Onlinespeicher für optimierte Onlinebereitstellung mit öffentlichem Endpunkt erstellen

In den folgenden Beispielen wird ein Onlineshops für die optimierte Onlinebereitstellung mit einem öffentlichen Endpunkt erstellt.

Console

Gehen Sie nach der folgenden Anleitung vor, um einen Onlineshop für die optimierte Onlinebereitstellung mit der Google Cloud Console zu erstellen.

Rufen Sie im Abschnitt „Vertex AI“ der Google Cloud Console die Seite Feature Store auf.

Zur Seite „Feature Store“
Klicken Sie auf Onlineshop, um zum Abschnitt Onlineshop zu gelangen.
Klicken Sie auf Erstellen, um die Seite Onlineshop erstellen zu öffnen.
Geben Sie einen Namen für den Onlineshop an.
Optional: Klicken Sie auf Label hinzufügen und geben Sie den Namen und den Wert des Labels an. Sie können einem Onlineshop mehrere Labels hinzufügen.
Klicken Sie im Feld Speicherlösung für den Onlineshop wählen auf Optimiert.
Klicken Sie auf Erstellen.

REST

Senden Sie zum Erstellen einer Onlineshopinstanz eine POST-Anfrage mit der Methode featureOnlineStores.create .

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

LOCATION_ID: Region, in der Sie die FeatureOnlineStore-Instanz erstellen möchten, z. B. us-central1.
PROJECT_ID: Ihre Projekt-ID.
FEATUREONLINESTORE_NAME: Name der neuen FeatureOnlineStore-Instanz.

HTTP-Methode und URL:

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME

JSON-Text der Anfrage:

{
  "optimized": {}
}

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/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_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/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand Content

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureOnlineStoreOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T17:49:23.847496Z",
      "updateTime": "2023-09-18T17:49:23.847496Z"
    }
  }
}

Onlinespeicher für optimierte Onlinebereitstellung mit einem Private Service Connect-Endpunkt erstellen

Verwenden Sie das folgende Beispiel, um einen Onlineshop für die optimierte Onlinebereitstellung mit Private Service Connect zu erstellen.

REST

Senden Sie zum Erstellen einer Onlineshopinstanz eine POST-Anfrage mit der Methode featureOnlineStores.create .

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

LOCATION_ID: Region, in der Sie die FeatureOnlineStore-Instanz erstellen möchten, z. B. us-central1.
PROJECT_ID: Ihre Projekt-ID.
FEATUREONLINESTORE_NAME: Name der neuen FeatureOnlineStore-Instanz.

HTTP-Methode und URL:

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME

JSON-Text der Anfrage:

{
  "optimized": {},
  "dedicated_serving_endpoint": {
    "private_service_connect_config": {
      "enable_private_service_connect": true,
      "project_allowlist": ["PROJECT_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/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_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/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand Content

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureOnlineStoreOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T17:49:23.847496Z",
      "updateTime": "2023-09-18T17:49:23.847496Z"
    }
  }
}

Nächste Schritte

Weitere Informationen zum Erstellen von Featureansichten
Weitere Informationen zum Aktualisieren eines Onlinespeichers