Actualizar un grupo de funciones

Puede actualizar un grupo de características para registrar una tabla o una vista de BigQuery como fuente de datos de características de ese grupo. Si el grupo de características ya tiene una fuente de datos asociada, puedes asociar otra tabla o vista de BigQuery como fuente de datos de las características.

Al crear o actualizar un grupo de características, puedes añadir metadatos definidos por el usuario en forma de etiquetas al grupo de características. Para obtener más información sobre cómo actualizar las etiquetas definidas por el usuario de un grupo de funciones, consulta Actualizar etiquetas de un grupo de funciones.

Antes de empezar

Autentícate en Vertex AI, a menos que ya lo hayas hecho.

Para usar las muestras de la API REST de esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la CLI de gcloud.

    Instala Google Cloud CLI. Después de la instalación, inicializa la CLI de Google Cloud ejecutando el siguiente comando: 

    gcloud init

    Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

Para obtener más información, consulta el artículo Autenticarse para usar REST de la documentación sobre autenticación de Google Cloud .

Actualizar un grupo de funciones

Usa el siguiente ejemplo para actualizar un grupo de funciones.

REST

Para actualizar un recurso FeatureGroup, envía una solicitud PATCH mediante el método featureGroups.patch.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • LOCATION_ID: región en la que se encuentra el grupo de funciones, como us-central1.
  • PROJECT_ID: tu ID de proyecto.
  • FEATURE_GROUP_NAME: el nombre del grupo de funciones que quieres actualizar.
  • ENTITY_ID_COLUMNS: los nombres de las columnas que contienen los IDs de las entidades. Puedes especificar una o varias columnas.
    • Para especificar solo una columna de ID de entidad, indique el nombre de la columna con el siguiente formato:
      "entity_id_column_name".
    • Para especificar varias columnas de ID de entidad, indique los nombres de las columnas con el siguiente formato:
      ["entity_id_column_1_name", "entity_id_column_2_name", ...].
  • BIGQUERY_SOURCE_URI: URI de la tabla o vista de origen de BigQuery que quieras asociar al grupo de funciones.

Método HTTP y URL: 

PATCH https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups?feature_group_id=FEATURE_GROUP_NAME

Cuerpo JSON de la solicitud: 

{
  "big_query": {
    "entity_id_columns": "ENTITY_ID_COLUMNS",
    "big_query_source": {
      "input_uri": "BIGQUERY_SOURCE_URI"
    }
  }
}

Para enviar tu solicitud, elige una de estas opciones:

curl

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente 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/featureGroups?feature_group_id=FEATURE_GROUP_NAME"

PowerShell

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente 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/featureGroups?feature_group_id=FEATURE_GROUP_NAME" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la siguiente:

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

Siguientes pasos