Visualizzazioni delle funzionalità dell'elenco

Puoi recuperare un elenco di tutte le istanze di visualizzazione delle funzionalità create all'interno di un negozio online nel tuo progetto Google Cloud . Per ogni visualizzazione della funzionalità, puoi anche visualizzare l'origine dati della funzionalità, che può essere una delle seguenti:

  • Uno o più gruppi di funzionalità e le relative funzionalità costituenti. Ogni gruppo di caratteristiche è associato a un'origine dati delle caratteristiche, ad esempio una tabella o una vista BigQuery. Ogni funzionalità indica una colonna nell'origine dati BigQuery.

  • Una tabella o una vista BigQuery associata direttamente alla visualizzazione delle caratteristiche.

Se una visualizzazione delle funzionalità è configurata per utilizzare un account di servizio dedicato, i dettagli di questa visualizzazione delle funzionalità includono anche l'indirizzo email del account di servizio associato. Per saperne di più sulla creazione di feature view con configurazioni di account di servizio dedicate, consulta Configurare il account di servizio per una feature view.

Prima di iniziare

Autenticati su Vertex AI, a meno che tu non l'abbia già fatto.

Seleziona la scheda relativa a come intendi utilizzare i campioni in questa pagina:

Console

Quando utilizzi la console Google Cloud per accedere ai servizi Google Cloud e alle API, non devi configurare l'autenticazione.

REST

Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.

    Installa Google Cloud CLI.

    Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per saperne di più, consulta Autenticati per usare REST nella documentazione sull'autenticazione di Google Cloud .

Elenca le visualizzazioni delle caratteristiche in un negozio online

Utilizza i seguenti esempi per recuperare un elenco di visualizzazioni delle funzionalità create per un negozio online nel tuo progetto per una località specifica.

Console

Segui queste istruzioni per visualizzare l'elenco delle visualizzazioni delle funzionalità in un negozio online utilizzando la console Google Cloud .

  1. Nella sezione Vertex AI della console Google Cloud , vai alla pagina Feature Store.

    Vai alla pagina Feature Store

  2. Fai clic su Negozio online.

  3. Fai clic sul nome del negozio online per visualizzarne i dettagli nella pagina Dettagli negozio online.

  4. Nella sezione Visualizzazioni funzionalità, puoi visualizzare l'elenco di tutti i negozi online per la località selezionata.

REST

Per recuperare un elenco di tutte le istanze FeatureView create all'interno di un negozio online specifico nel tuo progetto, invia una richiesta GET utilizzando il metodo featureViews.list.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • LOCATION_ID: la regione in cui si trova il negozio online, ad esempio us-central1.
  • PROJECT_ID: il tuo ID progetto.
  • FEATUREONLINESTORE_NAME: il nome del negozio online per cui vuoi visualizzare l'elenco delle visualizzazioni delle funzionalità.

Metodo HTTP e URL: 

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

Per inviare la richiesta, scegli una di queste opzioni:

curl

Esegui questo comando: 

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

Esegui questo comando: 

$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
Dovresti ricevere una risposta JSON simile alla seguente. Se una delle visualizzazioni delle funzionalità elencate nella risposta ha una configurazione del account di servizio dedicata, anche l'indirizzo email delaccount di serviziot è elencato nei relativi dettagli. In questo esempio, SERVICE_ACCOUNT_EMAIL è l'indirizzo email del account di servizio associato alla visualizzazione della funzionalità 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",
            ]
          }
        ]
      }
    }
  ]
}

Passaggi successivi