Atualize uma funcionalidade

Num grupo de funcionalidades, pode atualizar uma funcionalidade para a associar a uma coluna específica na origem de dados do BigQuery associada ao grupo de funcionalidades.

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

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 funcionalidade

Use o exemplo seguinte para atualizar uma funcionalidade num grupo de funcionalidades.

REST

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

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

• LOCATION_ID: região onde se encontra o grupo de funcionalidades que contém a funcionalidade, como us-central1.
• PROJECT_ID: o ID do seu projeto.
• FEATURE_GROUP_NAME: o nome do grupo de elementos que contém o elemento.
• FEATURE_NAME: o nome da funcionalidade que quer atualizar.
• VERSION_COLUMN_NAME: a coluna da tabela ou vista de origem do BigQuery que quer associar ao atualizar a funcionalidade.

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

{
  "version_column_name": "VERSION_COLUMN_NAME"
}

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

curl

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

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/v1beta1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_NAME/features?feature_id=FEATURE_NAME"

PowerShell

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

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/v1beta1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_NAME/features?feature_id=FEATURE_NAME" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

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

O que se segue?

• Saiba como criar uma funcionalidade.

• Saiba como eliminar uma vista de recursos.