Actualiza un grupo de atributos

Puedes actualizar un grupo de atributos para registrar una tabla o vista de BigQuery como la fuente de datos de atributos de ese grupo de atributos. Si el grupo de atributos ya tiene una fuente de datos asociada, puedes asociar una tabla o vista de BigQuery diferente como la fuente de datos de atributos.

Cuando creas o actualizas un grupo de atributos, puedes agregar metadatos definidos por el usuario en forma de grupo de atributos. Para obtener más información sobre cómo actualizar las etiquetas de un atributo definidas por el usuario, consulta Actualiza las etiquetas de un grupo de atributo.

Antes de comenzar

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

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

    Instala Google Cloud CLI y, luego, inicializa la ejecución del siguiente comando: 

    gcloud init

Si deseas obtener más información, consulta Autentica para usar REST en la documentación de autenticación de Google Cloud.

Actualiza un grupo de atributos

Usa el siguiente ejemplo para actualizar un grupo de atributos.

REST

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

Antes de usar cualquiera de los datos de solicitud, realiza los siguientes reemplazos:

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

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 que se muestra a continuación:

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

¿Qué sigue?