Aggiornare una visualizzazione delle caratteristiche

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", ...].

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