Puoi aggiornare una visualizzazione delle caratteristiche per modificare l'elenco delle origini dati delle caratteristiche associate. Ad esempio, potresti apportare i seguenti aggiornamenti:
Associa un gruppo di caratteristiche e caratteristiche diversi o un insieme diverso di caratteristiche dello stesso gruppo di caratteristiche.
Specifica una tabella o una vista BigQuery diversa contenente la caratteristica e i dati di Google Cloud. Tieni presente che, in questo caso, devi anche specificare una o più colonne di ID entità. dall'origine dati aggiornata.
Specifica un insieme diverso di colonne di ID entità dalla stessa origine dati BigQuery.
Durante la creazione o l'aggiornamento di una visualizzazione delle caratteristiche, hai la possibilità di aggiungere un valore definito dall'utente i metadati sotto forma di etichette alla visualizzazione delle caratteristiche. Per ulteriori informazioni per aggiornare le etichette definite dall'utente per una visualizzazione caratteristiche, consulta Aggiornare le etichette per una visualizzazione caratteristiche.
Prima di iniziare
Autentica per 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, utilizzi le credenziali che fornisci 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 visualizzazione delle caratteristiche in base al gruppo di caratteristiche
Utilizza l'esempio seguente per aggiornare una visualizzazione delle caratteristiche specificando le caratteristiche da un gruppo di caratteristiche esistente.
REST
Per aggiornare una FeatureView
Risorsa, invia una richiesta PATCH
utilizzando
featureViews.patch
.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- LOCATION_ID: regione in cui si trova il negozio online, ad esempio
us-central1
. - PROJECT_ID: l'ID progetto.
- FEATUREONLINESTORE_NAME: il nome del negozio online contenente la visualizzazione delle caratteristiche.
- FEATUREVIEW_NAME: il nome della visualizzazione delle caratteristiche che vuoi aggiornare.
- FEATUREGROUP_NAME: il nome del gruppo di caratteristiche che vuoi associare alla visualizzazione delle caratteristiche.
- FEATURE_ID_1 e FEATURE_ID_2: ID caratteristica da aggiungere alla visualizzazione caratteristiche da il gruppo di caratteristiche FEATUREGROUP_NAME.
Metodo HTTP e URL:
PATCH https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME
Corpo JSON della richiesta:
{ "feature_registry_source": { "feature_groups": [ { "feature_group_id": "FEATUREGROUP_NAME", "feature_ids": [ "FEATURE_ID_1", "FEATURE_ID_2" ] } ] } }
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/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_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/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME" | Select-Object -Expand Content
Dovresti ricevere una risposta JSON simile alla seguente:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.aiplatform.v1.UpdateFeatureViewOperationMetadata", "genericMetadata": { "createTime": "2023-09-15T04:53:22.794004Z", "updateTime": "2023-09-15T04:53:22.794004Z" } }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.aiplatform.v1.FeatureView", "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME" } }
Aggiorna una visualizzazione caratteristiche in base a un'origine BigQuery
Utilizza l'esempio seguente per aggiornare una visualizzazione delle caratteristiche specificando le colonne delle caratteristiche da una tabella o una vista BigQuery.
REST
Per aggiornare una FeatureView
basata su un'origine dati BigQuery,
invia una richiesta PATCH
utilizzando
featureViews.patch
.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- LOCATION_ID: regione in cui si trova il negozio online, ad esempio
us-central1
. - PROJECT_ID: l'ID progetto.
- FEATUREONLINESTORE_NAME: il nome del negozio online contenente la visualizzazione delle caratteristiche.
- FEATUREVIEW_NAME: il nome della visualizzazione delle caratteristiche che vuoi aggiornare.
- BIGQUERY_SOURCE_URI: URI della tabella o della vista BigQuery contenente i dati delle caratteristiche.
- ENTITY_ID_COLUMNS:
- ENTITY_ID_COLUMNS: i nomi delle colonne contenenti gli ID entità. Puoi
specificare una o più colonne.
- Per specificare una sola colonna di ID entità, specifica il nome della colonna nel seguente formato:
"entity_id_column_name"
. - Per specificare più colonne di ID entità, specifica i nomi delle colonne nel seguente formato:
["entity_id_column_1_name", "entity_id_column_2_name", ...]
.
- Per specificare una sola colonna di ID entità, specifica il nome della colonna nel seguente formato:
Metodo HTTP e URL:
PATCH https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME
Corpo JSON della richiesta:
{ "big_query_source": { "uri": "BIGQUERY_SOURCE_URI", "entity_id_columns": "ENTITY_ID_COLUMNS" } }
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/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_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/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME" | Select-Object -Expand Content
Dovresti ricevere una risposta JSON simile alla seguente:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.aiplatform.v1.UpdateFeatureViewOperationMetadata", "genericMetadata": { "createTime": "2023-09-15T04:53:34.832192Z", "updateTime": "2023-09-15T04:53:34.832192Z" } }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.aiplatform.v1.FeatureView", "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME" } }
Passaggi successivi
Inizia a distribuire online i dati delle funzionalità.
Scopri come eliminare una visualizzazione delle caratteristiche.