All'interno di un gruppo di caratteristiche, puoi aggiornare una caratteristica per associarla a una colonna specifica nell'origine dati BigQuery associata al gruppo di caratteristiche.
Durante la creazione o l'aggiornamento di una funzionalità, puoi aggiungere metadati definiti dall'utente sotto forma di etichette. Per saperne di più su come aggiornare le etichette definite dall'utente per una funzionalità, consulta Aggiornare le etichette per una funzionalità.
Prima di iniziare
Autenticati su Vertex AI, a meno che tu non l'abbia già fatto.
Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizza le credenziali che fornisci a gcloud CLI.
Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il seguente comando:
gcloud init
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.
Per saperne di più, consulta Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud .
Aggiornare una funzionalità
Utilizza il seguente esempio per aggiornare una funzionalità all'interno di un gruppo di funzionalità.
REST
Per aggiornare una risorsa Feature
, invia una richiesta PATCH
utilizzando il metodo features.patch.
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
- LOCATION_ID: la regione in cui si trova il gruppo di funzionalità contenente la funzionalità, ad esempio
us-central1
. - PROJECT_ID: il tuo ID progetto.
- FEATURE_GROUP_NAME: il nome del gruppo di funzionalità contenente la funzionalità.
- FEATURE_NAME: Il nome della funzionalità che vuoi aggiornare.
- VERSION_COLUMN_NAME: la colonna della tabella o della vista di origine BigQuery che vuoi associare durante l'aggiornamento della funzionalità.
Metodo HTTP e URL:
PATCH https://LOCATION_ID-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_NAME/features?feature_id=FEATURE_NAME
Corpo JSON della richiesta:
{ "version_column_name": "VERSION_COLUMN_NAME" }
Per inviare la richiesta, scegli una di queste opzioni:
curl
Salva il corpo della richiesta in un file denominato request.json
,
ed esegui questo comando:
curl -X PATCH \
-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/v1beta1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_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 PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_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/FEATURE_GROUP_NAME/features/FEATURE_NAME/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.aiplatform.v1beta1.UpdateFeatureOperationMetadata", "genericMetadata": { "createTime": "2023-09-18T02:36:22.870679Z", "updateTime": "2023-09-18T02:36:22.870679Z" } }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.aiplatform.v1beta1.Feature", "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_NAME/features/FEATURE_NAME" } }
Passaggi successivi
Scopri come creare una funzionalità.
Scopri come eliminare una visualizzazione delle funzionalità.