É possível atualizar um grupo de recursos para registrar uma tabela ou visualização do BigQuery como fonte de dados de recursos desse grupo. Se o grupo de recursos já tiver uma fonte de dados associada, será possível associar uma tabela ou visualização diferente do BigQuery como a fonte de dados de elementos.
Ao criar ou atualizar um grupo de recursos, você tem a opção de adicionar metadados definidos pelo usuário na forma de rótulos ao grupo de recursos. Para mais informações sobre como atualizar rótulos definidos pelo usuário em um grupo de recursos, consulte Atualizar rótulos para um grupo de recursos.
Antes de começar
Faça a autenticação na Vertex AI, a menos que já tenha feito isso.
Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.
Atualizar um grupo de recursos
Use o exemplo a seguir para atualizar um grupo de recursos.
REST
Para atualizar um recurso FeatureGroup
, envie uma solicitação PATCH
usando o
método
featureGroups.patch.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- LOCATION_ID: região em que o grupo de recursos está localizado, como
us-central1
. - PROJECT_ID: o ID do projeto.
- FEATURE_GROUP_NAME: o nome do grupo de recursos que você quer atualizar.
- ENTITY_ID_COLUMNS: os nomes das colunas que contêm os IDs das entidades. É possível especificar uma ou várias colunas.
- Para especificar apenas uma coluna de IDs das entidades, especifique o nome da coluna no seguinte formato:
"entity_id_column_name"
. - Para especificar várias colunas de IDs das entidades, especifique os nomes das colunas no seguinte formato:
["entity_id_column_1_name", "entity_id_column_2_name", ...]
.
- Para especificar apenas uma coluna de IDs das entidades, especifique o nome da coluna no seguinte formato:
- BIGQUERY_SOURCE_URI: URI da tabela ou visualização de origem do BigQuery que você quer associar ao grupo de recursos.
Método HTTP e URL:
PATCH https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups?feature_group_id=FEATURE_GROUP_NAME
Corpo JSON da solicitação:
{ "big_query": { "entity_id_columns": "ENTITY_ID_COLUMNS", "big_query_source": { "input_uri": "BIGQUERY_SOURCE_URI" } } }
Para enviar a solicitação, escolha uma destas opções:
curl
Salve o corpo da solicitação em um arquivo com o nome request.json
e execute o comando a seguir:
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/featureGroups?feature_group_id=FEATURE_GROUP_NAME"
PowerShell
Salve o corpo da solicitação em um arquivo com o nome request.json
e execute o comando a seguir:
$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/featureGroups?feature_group_id=FEATURE_GROUP_NAME" | Select-Object -Expand Content
Você receberá uma resposta JSON semelhante a esta:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_NAME/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.aiplatform.v1.UpdateFeatureGroupOperationMetadata", "genericMetadata": { "createTime": "2023-09-18T03:00:13.060636Z", "updateTime": "2023-09-18T03:00:13.060636Z" } }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.aiplatform.v1.FeatureGroup", "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_NAME" } }
A seguir
Saiba como atualizar uma visualização de recurso.
Saiba como atualizar um recurso.
Saiba como excluir um grupo de funcionalidades.