Répertorier des vues de caractéristiques

Vous pouvez récupérer la liste de toutes les instances de vues de caractéristiques créées dans une boutique en ligne dans votre projet Google Cloud . Pour chaque vue de caractéristique, vous pouvez également afficher la source de données de la caractéristique, qui peut être l'une des suivantes:

  • Un ou plusieurs groupes de caractéristiques et leurs caractéristiques constitutives. Chaque groupe de caractéristiques est associé à une source de données de caractéristiques, telle qu'une table ou une vue BigQuery. Chaque caractéristique désigne une colonne dans la source de données BigQuery.

  • Une table ou une vue BigQuery directement associée à la vue des caractéristiques.

Si une vue des caractéristiques est configurée pour utiliser un compte de service dédié, les détails de cette vue des caractéristiques incluent également l'adresse e-mail du compte de service associé. Pour en savoir plus sur la création de vues des caractéristiques avec des configurations de compte de service dédiées, consultez Configurer le compte de service pour une vue des caractéristiques.

Avant de commencer

Authentifiez-vous auprès de Gemini Enterprise Agent Platform, sauf si vous l'avez déjà fait.

Sélectionnez l'onglet correspondant à la façon dont vous prévoyez d'utiliser les exemples de cette page :

Console

Lorsque vous utilisez la console Google Cloud pour accéder aux services et aux API Google Cloud , vous n'avez pas besoin de configurer l'authentification.

REST

Pour utiliser les exemples API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à la gcloud CLI.

    Installez la Google Cloud CLI.

    Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Google Cloud .

Répertorier les vues des caractéristiques dans un magasin en ligne

Utilisez les exemples suivants pour récupérer la liste des vues de caractéristiques créées pour un magasin en ligne de votre projet pour un emplacement spécifique.

Console

Suivez les instructions ci-dessous pour afficher la liste des vues de caractéristiques d'une boutique en ligne à l'aide de la console Google Cloud .

  1. Dans la section "Agent Platform" de la console Google Cloud , accédez à la page Feature Store.

    Accéder à la page Feature Store

  2. Cliquez sur Boutique en ligne.

  3. Cliquez sur le nom de la boutique en ligne pour en afficher les détails sur la page Détails du stockage en ligne.

  4. Dans la section Vues des caractéristiques, vous pouvez afficher la liste de toutes les boutiques en ligne pour l'emplacement sélectionné.

REST

Pour récupérer une liste de toutes les instances FeatureView créées dans un magasin en ligne spécifique dans votre projet, envoyez une requête GET à l'aide de la méthode featureViews.list.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • LOCATION_ID : région où se trouve le magasin en ligne, par exemple us-central1.
  • PROJECT_ID : ID du projet.
  • FEATUREONLINESTORE_NAME: nom de la boutique en ligne dont vous souhaitez afficher la liste des vues de caractéristiques.

Méthode HTTP et URL : 

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

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Exécutez la commande suivante :

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

Exécutez la commande suivante :

$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
Vous devriez recevoir une réponse JSON semblable à la suivante. Si l'une des vues de caractéristiques listées dans la réponse possède une configuration de compte de service dédiée, l'adresse e-mail du compte de service est également listée dans ses détails. Dans cet exemple, SERVICE_ACCOUNT_EMAIL correspond à l'adresse e-mail du compte de service associé à la vue de caractéristiques FEATUREVIEW_NAME_1. 
{
  "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",
            ]
          }
        ]
      }
    }
  ]
}

Étapes suivantes