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 ulteriori informazioni per aggiornare le etichette definite dall'utente per una caratteristica, consulta Aggiornare le etichette di un elemento.
Prima di iniziare
Autentica per Vertex AI, a meno che tu non l'abbia già fatto.
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, vedi Esegui l'autenticazione 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 Feature
Risorsa, invia una richiesta PATCH
utilizzando
features.patch
.
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
- LOCATION_ID: regione in cui si trova il gruppo di caratteristiche contenente l'elemento, ad esempio
us-central1
. - PROJECT_ID: l'ID del tuo progetto.
- FEATURE_GROUP_NAME: il nome del gruppo di caratteristiche contenente l'elemento.
- 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 delle seguenti 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
.
ed esegui questo comando:
$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 caratteristiche.