Puoi creare una funzionalità dopo aver creato un gruppo di funzionalità e associato una tabella o una vista BigQuery. Puoi creare più elementi per un gruppo di elementi e associare ogni elemento a una colonna specifica nell'origine dati BigQuery. Per informazioni su come utilizzare BigQuery, consulta la documentazione di BigQuery.
Ad esempio, se il gruppo di caratteristiche featuregroup1
è associato alla tabella BigQuery datasource_1
contenente i valori delle caratteristiche nelle colonne fval1
e fval2
, puoi creare la caratteristica feature_1
in featuregroup1
e associarla ai valori delle caratteristiche nella colonna fval1
.
Analogamente, puoi creare un'altra funzionalità denominata feature_2
e associarla ai valori della funzionalità nella colonna fval2
.
La registrazione dell'origine dati utilizzando gruppi di funzionalità e funzionalità presenta i seguenti vantaggi:
Puoi definire una vista delle caratteristiche per l'erogazione online utilizzando colonne di funzionalità specifiche di più origini dati BigQuery.
Puoi formattare i dati come serie temporali includendo la colonna
feature_timestamp
. Vertex AI Feature Store pubblica solo i valori delle funzionalità più recenti dai dati delle funzionalità ed esclude i valori storici.Puoi trovare l'origine BigQuery come origine dati associata alla funzionalità quando cerchi la risorsa della funzionalità in Data Catalog.
Puoi configurare il monitoraggio delle funzionalità per recuperare le statistiche sulle funzionalità e rilevare la deriva delle funzionalità.
Prima di iniziare
Esegui l'autenticazione su Vertex AI, se non l'hai ancora fatto.
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.
Python
Per utilizzare gli Python esempi in questa pagina in un ambiente di sviluppo locale, installa e inizializza l'interfaccia a riga di comando gcloud, quindi configura le credenziali predefinite dell'applicazione con le tue credenziali utente.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
Per ulteriori informazioni, consulta Set up authentication for a local development environment.
REST
Per utilizzare gli esempi dell'API REST in questa pagina in un ambiente di sviluppo locale, utilizza le credenziali fornite a gcloud CLI.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Per ulteriori informazioni, consulta Eseguire l'autenticazione per l'utilizzo di REST nella documentazione Google Cloud sull'autenticazione.
Creare una funzionalità all'interno di un gruppo di funzionalità
Utilizza i seguenti esempi per creare una funzionalità all'interno di un gruppo di funzionalità e associare una colonna contenente i valori delle funzionalità dall'origine dati BigQuery registrata per il gruppo di funzionalità.
Console
Segui le istruzioni riportate di seguito per aggiungere funzionalità a un gruppo di funzionalità esistente utilizzando la console Google Cloud.
Nella sezione Vertex AI della console Google Cloud, vai alla pagina Feature Store.
Nella sezione Gruppi di funzionalità, fai clic su
nella riga corrispondente al gruppo di funzionalità in cui vuoi aggiungere una funzionalità, quindi fai clic su Aggiungi funzionalità.Per ogni elemento, inserisci un nome elemento e fai clic sul nome della colonna di origine BigQuery corrispondente nell'elenco. Per aggiungere altre funzionalità, fai clic su Aggiungi un'altra funzionalità.
Fai clic su Crea.
Python
Per scoprire come installare o aggiornare l'SDK Vertex AI per Python, consulta Installare l'SDK Vertex AI per Python. Per saperne di più, consulta la documentazione di riferimento dell'API Python.
project
: l'ID del tuo progetto.location
: regione in cui si trova il gruppo di funzionalità, ad esempious-central1
.existing_feature_group_id
: il nome del gruppo di elementi esistente in cui vuoi creare l'elemento.version_column_name
: facoltativo. La colonna della tabella o della visualizzazione BigQuery che vuoi associare alla funzionalità. Se non specifichi questo parametro, per impostazione predefinita viene impostato su FEATURE_NAME.feature_id
: il nome della nuova funzionalità che vuoi creare
REST
Per creare una risorsa Feature
, invia una richiesta POST
utilizzando il metodo
features.create.
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
- LOCATION_ID: regione in cui si trova il gruppo di funzionalità, ad esempio
us-central1
. - PROJECT_ID: l'ID del tuo progetto.
- FEATUREGROUP_NAME: il nome del gruppo di elementi in cui vuoi creare l'elemento.
- FEATURE_NAME: il nome della nuova funzionalità che vuoi creare.
- VERSION_COLUMN_NAME: facoltativo. La colonna della tabella o della visualizzazione BigQuery che vuoi associare alla funzionalità. Se non specifichi questo parametro, per impostazione predefinita viene impostato su FEATURE_NAME.
Metodo HTTP e URL:
POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups/FEATUREGROUP_NAME/features?feature_id=FEATURE_NAME
Corpo JSON della richiesta:
{ "version_column_name": "VERSION_COLUMN_NAME" }
Per inviare la richiesta, scegli una delle seguenti opzioni:
curl
Salva il corpo della richiesta in un file denominato request.json
,
quindi esegui il comando seguente:
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/featureGroups/FEATUREGROUP_NAME/features?feature_id=FEATURE_NAME"
PowerShell
Salva il corpo della richiesta in un file denominato request.json
,
quindi esegui il comando seguente:
$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/featureGroups/FEATUREGROUP_NAME/features?feature_id=FEATURE_NAME" | Select-Object -Expand Content
Dovresti ricevere una risposta JSON simile alla seguente:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureGroups/FEATUREGROUP_NAME/features/FEATURE_NAME/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.aiplatform.v1.UpdateFeatureOperationMetadata", "genericMetadata": { "createTime": "2023-09-18T02:36:22.870679Z", "updateTime": "2023-09-18T02:36:22.870679Z" } } }
Passaggi successivi
Scopri come elencare tutte le funzionalità in un gruppo di funzionalità.
Scopri come aggiornare una funzionalità.
Scopri come eliminare una funzionalità.
Scopri come aggiornare un gruppo di funzionalità.
Configura il monitoraggio delle funzionalità per le funzionalità di un gruppo di funzionalità.
Tipi di pubblicazione online in Vertex AI Feature Store.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-02-14 UTC.