Puoi creare una caratteristica dopo aver creato un gruppo di caratteristiche e associato una tabella BigQuery o una vista BigQuery. Puoi creare più caratteristiche per un gruppo di caratteristiche e associare ogni caratteristica 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 funzionalità featuregroup1
è associato alla
tabella BigQuery datasource_1
contenente i valori delle caratteristiche nelle colonne
fval1
e fval2
, puoi creare la funzionalità 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 delle caratteristiche nella colonna fval2
.
La registrazione dell'origine dati utilizzando gruppi di funzionalità e funzionalità offre i seguenti vantaggi:
Puoi definire una visualizzazione delle caratteristiche per la pubblicazione online utilizzando colonne delle caratteristiche specifiche provenienti da 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 provenienti dai dati delle caratteristiche ed esclude i valori storici.
Utilizza gli esempi riportati di seguito per creare una funzionalità all'interno di un gruppo di funzionalità e associare una colonna contenente i valori delle caratteristiche dell'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 caratteristiche, fai clic su
nella riga corrispondente al gruppo di caratteristiche in cui vuoi aggiungere una funzionalità, quindi fai clic su Aggiungi funzionalità.Per ogni funzionalità, inserisci un Nome funzionalità 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.
REST
Per creare una risorsa Feature
, invia una richiesta POST
utilizzando il metodo
features.create.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- LOCATION_ID: la 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 funzionalità in cui vuoi creare la funzionalità.
- FEATURE_NAME: il nome della nuova funzionalità che vuoi creare.
- VERSION_COLUMN_NAME: facoltativo: la colonna della tabella o della vista BigQuery che vuoi associare alla funzionalità. Se non specifichi questo parametro, viene impostato su FEATURE_NAME per impostazione predefinita.
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:
arricciatura
Salva il corpo della richiesta in un file denominato request.json
ed esegui questo comando:
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
ed esegui questo comando:
$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à.
Tipi di pubblicazione online in Vertex AI Feature Store.