Featureansichten auflisten

Sie können eine Liste aller Featureansicht-Instanzen abrufen, die in einem Onlinespeicher in Ihrem Google Cloud Projekt erstellt wurden. Für jede Featureansicht können Sie auch die Feature-Datenquelle aufrufen. Dabei kann es sich um eine der folgenden Datenquellen handeln:

  • Eine oder mehrere Featuregruppen und ihre zugehörigen Features. Jede Featuregruppe ist einer Feature-Datenquelle zugeordnet, z. B. einer BigQuery-Tabelle oder -Ansicht. Jedes Feature entspricht einer Spalte in der BigQuery-Datenquelle.

  • Eine BigQuery-Tabelle oder -Ansicht, die direkt mit der Featureansicht verknüpft ist.

Wenn eine Featureansicht für die Verwendung eines speziellen Dienstkontos konfiguriert ist, enthalten die Details für diese Featureansicht auch die zugehörige E-Mail-Adresse des Dienstkontos. Weitere Informationen zum Erstellen von Featureansichten mit speziellen Dienstkontokonfigurationen finden Sie unter Dienstkonto für eine Featureansicht konfigurieren.

Hinweis

Authentifizieren Sie sich bei der Gemini Enterprise Agent Platform, sofern nicht bereits geschehen.

Wählen Sie den Tab für die Verwendung der Beispiele auf dieser Seite aus:

Console

Wenn Sie über die Google Cloud Console auf Google Cloud Dienste und APIs zugreifen, müssen Sie die Authentifizierung nicht einrichten.

REST

Wenn Sie die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, verwenden Sie die Anmeldedaten, die Sie der gcloud CLI bereitstellen.

    Installieren Sie die Google Cloud CLI.

    Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

Weitere Informationen finden Sie in der Google Cloud Authentifizierungsdokumentation unter Für die Verwendung von REST authentifizieren.

Featureansichten in einem Onlineshop auflisten

Verwenden Sie die folgenden Beispiele, um eine Liste der Featureansichten abzurufen, die für einen Onlineshop in Ihrem Projekt für einen bestimmten Standort erstellt wurden.

Console

So rufen Sie mit der Google Cloud Console die Liste der Featureansichten in einem Onlineshop auf:

  1. Rufen Sie im Bereich „Agent Platform“ der Google Cloud Console die Seite Feature Store auf.

    Zur Seite „Feature Store“

  2. Klicken Sie auf Onlinespeicher.

  3. Klicken Sie auf den Namen des Onlineshops, um die zugehörigen Details auf dessen Detailseite aufzurufen.

  4. Im Bereich Featureansichten finden Sie eine Liste aller Onlineshops für den ausgewählten Standort.

REST

Wenn Sie eine Liste aller FeatureView-Instanzen abrufen möchten, die in einem bestimmten Onlinespeicher in Ihrem Projekt erstellt wurden, senden Sie eine GET-Anfrage mit featureViews.list-Methode.

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 Onlineshops, für den Sie die Liste der Featureansichten aufrufen möchten.

HTTP-Methode und URL:

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

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)" \
"https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews"

PowerShell

Führen Sie diesen Befehl aus:

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

Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews" | Select-Object -Expand Content
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten: Wenn eine der in der Antwort aufgeführten Featureansichten eine spezielle Dienstkontokonfiguration hat, wird die E-Mail-Adresse des Dienstkontos auch in den Details aufgeführt. In diesem Beispiel ist SERVICE_ACCOUNT_EMAIL die E-Mail-Adresse des Dienstkontos, das mit der Feature ansicht FEATUREVIEW_NAME_1 verknüpft ist.
{
  "featureViews": [
    {
      "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME_1",
      "createTime": "2023-09-06T23:46:49.936284Z",
      "updateTime": "2023-09-06T23:46:49.936284Z",
      "etag": "sample_etag",
      "featureRegistrySource": {
        "featureGroups": [
          {
            "featureGroupId": "FEATUREGROUP_ID",
            "featureIds": [
              "FEATURE_ID_1",
              "FEATURE_ID_2",
            ]
          }
        ]
      }
      "serviceAccountEmail": "SERVICE_ACCOUNT_EMAIL"
    },
    {
      "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME_2",
      "createTime": "2024-02-05T23:48:49.936284Z",
      "updateTime": "2024-02-05T23:48:49.936284Z",
      "etag": "sample_etag",
      "featureRegistrySource": {
        "featureGroups": [
          {
            "featureGroupId": "FEATUREGROUP_ID",
            "featureIds": [
              "FEATURE_ID_3",
              "FEATURE_ID_4",
            ]
          }
        ]
      }
    }
  ]
}

Nächste Schritte