Atualize uma vista de funcionalidades

Pode atualizar uma vista de elementos para modificar a lista de origens de dados de elementos associadas à mesma. Por exemplo, pode querer fazer as seguintes atualizações:

  • Associar um grupo de funcionalidades e funcionalidades diferentes ou um conjunto diferente de funcionalidades do mesmo grupo de funcionalidades.

  • Especifique uma tabela ou uma vista do BigQuery diferente que contenha os dados das caraterísticas. Tenha em atenção que, neste caso, também tem de especificar uma ou mais colunas de ID de entidade da origem de dados atualizada.

  • Especifique um conjunto diferente de colunas de ID de entidades a partir da mesma origem de dados do BigQuery.

Ao criar ou atualizar uma vista de funcionalidades, tem a opção de adicionar metadados definidos pelo utilizador no formato de etiquetas à vista de funcionalidades. Para mais informações sobre como atualizar as etiquetas definidas pelo utilizador para uma vista de funcionalidades, consulte Atualize as etiquetas de uma vista de funcionalidades.

Tenha em atenção que não pode atualizar uma visualização de funcionalidades configurada para a sincronização contínua de dados.

Antes de começar

Autentique o Vertex AI, a menos que já o tenha feito.

Para usar os exemplos da API REST nesta página num ambiente de desenvolvimento local, usa as credenciais que fornece à CLI gcloud.

    Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando: 

    gcloud init

    Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

Para mais informações, consulte o artigo Autenticar para usar REST na Google Cloud documentação de autenticação.

Atualize uma vista de funcionalidades com base no grupo de funcionalidades

Use o exemplo seguinte para atualizar uma visualização de funcionalidades especificando funcionalidades de um grupo de funcionalidades existente.

REST

Para atualizar um recurso FeatureView, envie um pedido PATCH através do método featureViews.patch.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • LOCATION_ID: região onde a loja online está localizada, como us-central1.
  • PROJECT_ID: o ID do seu projeto.
  • FEATUREONLINESTORE_NAME: o nome da loja online que contém a vista de funcionalidades.
  • FEATUREVIEW_NAME: o nome da vista de funcionalidades que quer atualizar.
  • FEATUREGROUP_NAME: o nome do grupo de funcionalidades que quer associar à vista de funcionalidades.
  • FEATURE_ID_1 e FEATURE_ID_2: IDs das funcionalidades que quer adicionar à visualização de funcionalidades do grupo de funcionalidades FEATUREGROUP_NAME.

Método 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 do pedido: 

{
  "feature_registry_source":
    { "feature_groups": [
      {
        "feature_group_id": "FEATUREGROUP_NAME",
        "feature_ids": [ "FEATURE_ID_1", "FEATURE_ID_2" ]
      }
    ]
  }
}

Para enviar o seu pedido, escolha uma destas opções:

curl

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte 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

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte 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

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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"
  }
}

Atualize uma visualização de recursos com base numa origem do BigQuery

Use o exemplo seguinte para atualizar uma vista de funcionalidades especificando colunas de funcionalidades a partir de uma tabela ou vista do BigQuery.

REST

Para atualizar uma instância FeatureView com base numa origem de dados do BigQuery, envie um pedido PATCH através do método featureViews.patch.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • LOCATION_ID: região onde a loja online está localizada, como us-central1.
  • PROJECT_ID: o ID do seu projeto.
  • FEATUREONLINESTORE_NAME: o nome da loja online que contém a vista de funcionalidades.
  • FEATUREVIEW_NAME: o nome da vista de funcionalidades que quer atualizar.
  • BIGQUERY_SOURCE_URI: URI da tabela ou vista do BigQuery que contém os dados das caraterísticas.
  • ENTITY_ID_COLUMNS:
  • ENTITY_ID_COLUMNS: os nomes das colunas que contêm os IDs das entidades. Pode especificar uma ou várias colunas.
    • Para especificar apenas uma coluna de ID de entidade, especifique o nome da coluna no seguinte formato:
      "entity_id_column_name".
    • Para especificar várias colunas de ID de entidades, especifique os nomes das colunas no seguinte formato:
      ["entity_id_column_1_name", "entity_id_column_2_name", ...].

Método 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 do pedido: 

{
  "big_query_source":
  {
    "uri": "BIGQUERY_SOURCE_URI",
    "entity_id_columns": "ENTITY_ID_COLUMNS"
  }
}

Para enviar o seu pedido, escolha uma destas opções:

curl

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte 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

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte 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

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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"
  }
}

O que se segue?